Files
godot-docs-l10n/classes/it/class_openxrcompositionlayer.rst
Rémi Verschelde c3f2364c10 Sync classref with 4.6 branch
Lots of translations invalidated (fuzzied) as we just synced Weblate.
2025-12-19 16:39:51 +01:00

673 lines
32 KiB
ReStructuredText

:github_url: hide
.. _class_OpenXRCompositionLayer:
OpenXRCompositionLayer
======================
**Sperimentale:** This class may be changed or removed in future versions.
**Eredita:** :ref:`Node3D<class_Node3D>` **<** :ref:`Node<class_Node>` **<** :ref:`Object<class_Object>`
**Ereditato da:** :ref:`OpenXRCompositionLayerCylinder<class_OpenXRCompositionLayerCylinder>`, :ref:`OpenXRCompositionLayerEquirect<class_OpenXRCompositionLayerEquirect>`, :ref:`OpenXRCompositionLayerQuad<class_OpenXRCompositionLayerQuad>`
Classe padre di tutti i nodi OpenXR dei livelli di composizione.
.. rst-class:: classref-introduction-group
Descrizione
----------------------
I livelli di composizione consentono al compositore XR di visualizzare le viewport 2D all'interno del visore tramite proiezioni speciali che ne mantengono la qualità. Ciò consente di renderizzare testo chiaro mantenendo il livello a una risoluzione nativa.
\ **Nota:** Se l'esecuzione OpenXR non supporta il tipo di livello di composizione specificato, è possibile generare una mesh di riserva con una :ref:`ViewportTexture<class_ViewportTexture>`, per emulare il livello di composizione.
.. rst-class:: classref-reftable-group
Proprietà
------------------
.. table::
:widths: auto
+-----------------------------------------------------------+---------------------------------------------------------------------------------------------------------------+--------------------------+
| :ref:`bool<class_bool>` | :ref:`alpha_blend<class_OpenXRCompositionLayer_property_alpha_blend>` | ``false`` |
+-----------------------------------------------------------+---------------------------------------------------------------------------------------------------------------+--------------------------+
| :ref:`Vector2i<class_Vector2i>` | :ref:`android_surface_size<class_OpenXRCompositionLayer_property_android_surface_size>` | ``Vector2i(1024, 1024)`` |
+-----------------------------------------------------------+---------------------------------------------------------------------------------------------------------------+--------------------------+
| :ref:`bool<class_bool>` | :ref:`enable_hole_punch<class_OpenXRCompositionLayer_property_enable_hole_punch>` | ``false`` |
+-----------------------------------------------------------+---------------------------------------------------------------------------------------------------------------+--------------------------+
| :ref:`SubViewport<class_SubViewport>` | :ref:`layer_viewport<class_OpenXRCompositionLayer_property_layer_viewport>` | |
+-----------------------------------------------------------+---------------------------------------------------------------------------------------------------------------+--------------------------+
| :ref:`bool<class_bool>` | :ref:`protected_content<class_OpenXRCompositionLayer_property_protected_content>` | ``false`` |
+-----------------------------------------------------------+---------------------------------------------------------------------------------------------------------------+--------------------------+
| :ref:`int<class_int>` | :ref:`sort_order<class_OpenXRCompositionLayer_property_sort_order>` | ``1`` |
+-----------------------------------------------------------+---------------------------------------------------------------------------------------------------------------+--------------------------+
| :ref:`Swizzle<enum_OpenXRCompositionLayer_Swizzle>` | :ref:`swapchain_state_alpha_swizzle<class_OpenXRCompositionLayer_property_swapchain_state_alpha_swizzle>` | ``3`` |
+-----------------------------------------------------------+---------------------------------------------------------------------------------------------------------------+--------------------------+
| :ref:`Swizzle<enum_OpenXRCompositionLayer_Swizzle>` | :ref:`swapchain_state_blue_swizzle<class_OpenXRCompositionLayer_property_swapchain_state_blue_swizzle>` | ``2`` |
+-----------------------------------------------------------+---------------------------------------------------------------------------------------------------------------+--------------------------+
| :ref:`Color<class_Color>` | :ref:`swapchain_state_border_color<class_OpenXRCompositionLayer_property_swapchain_state_border_color>` | ``Color(0, 0, 0, 0)`` |
+-----------------------------------------------------------+---------------------------------------------------------------------------------------------------------------+--------------------------+
| :ref:`Swizzle<enum_OpenXRCompositionLayer_Swizzle>` | :ref:`swapchain_state_green_swizzle<class_OpenXRCompositionLayer_property_swapchain_state_green_swizzle>` | ``1`` |
+-----------------------------------------------------------+---------------------------------------------------------------------------------------------------------------+--------------------------+
| :ref:`Wrap<enum_OpenXRCompositionLayer_Wrap>` | :ref:`swapchain_state_horizontal_wrap<class_OpenXRCompositionLayer_property_swapchain_state_horizontal_wrap>` | ``0`` |
+-----------------------------------------------------------+---------------------------------------------------------------------------------------------------------------+--------------------------+
| :ref:`Filter<enum_OpenXRCompositionLayer_Filter>` | :ref:`swapchain_state_mag_filter<class_OpenXRCompositionLayer_property_swapchain_state_mag_filter>` | ``1`` |
+-----------------------------------------------------------+---------------------------------------------------------------------------------------------------------------+--------------------------+
| :ref:`float<class_float>` | :ref:`swapchain_state_max_anisotropy<class_OpenXRCompositionLayer_property_swapchain_state_max_anisotropy>` | ``1.0`` |
+-----------------------------------------------------------+---------------------------------------------------------------------------------------------------------------+--------------------------+
| :ref:`Filter<enum_OpenXRCompositionLayer_Filter>` | :ref:`swapchain_state_min_filter<class_OpenXRCompositionLayer_property_swapchain_state_min_filter>` | ``1`` |
+-----------------------------------------------------------+---------------------------------------------------------------------------------------------------------------+--------------------------+
| :ref:`MipmapMode<enum_OpenXRCompositionLayer_MipmapMode>` | :ref:`swapchain_state_mipmap_mode<class_OpenXRCompositionLayer_property_swapchain_state_mipmap_mode>` | ``2`` |
+-----------------------------------------------------------+---------------------------------------------------------------------------------------------------------------+--------------------------+
| :ref:`Swizzle<enum_OpenXRCompositionLayer_Swizzle>` | :ref:`swapchain_state_red_swizzle<class_OpenXRCompositionLayer_property_swapchain_state_red_swizzle>` | ``0`` |
+-----------------------------------------------------------+---------------------------------------------------------------------------------------------------------------+--------------------------+
| :ref:`Wrap<enum_OpenXRCompositionLayer_Wrap>` | :ref:`swapchain_state_vertical_wrap<class_OpenXRCompositionLayer_property_swapchain_state_vertical_wrap>` | ``0`` |
+-----------------------------------------------------------+---------------------------------------------------------------------------------------------------------------+--------------------------+
| :ref:`bool<class_bool>` | :ref:`use_android_surface<class_OpenXRCompositionLayer_property_use_android_surface>` | ``false`` |
+-----------------------------------------------------------+---------------------------------------------------------------------------------------------------------------+--------------------------+
.. rst-class:: classref-reftable-group
Metodi
------------
.. table::
:widths: auto
+-------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`JavaObject<class_JavaObject>` | :ref:`get_android_surface<class_OpenXRCompositionLayer_method_get_android_surface>`\ (\ ) |
+-------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Vector2<class_Vector2>` | :ref:`intersects_ray<class_OpenXRCompositionLayer_method_intersects_ray>`\ (\ origin\: :ref:`Vector3<class_Vector3>`, direction\: :ref:`Vector3<class_Vector3>`\ ) |const| |
+-------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`is_natively_supported<class_OpenXRCompositionLayer_method_is_natively_supported>`\ (\ ) |const| |
+-------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
.. rst-class:: classref-section-separator
----
.. rst-class:: classref-descriptions-group
Enumerazioni
------------------------
.. _enum_OpenXRCompositionLayer_Filter:
.. rst-class:: classref-enumeration
enum **Filter**: :ref:`🔗<enum_OpenXRCompositionLayer_Filter>`
.. _class_OpenXRCompositionLayer_constant_FILTER_NEAREST:
.. rst-class:: classref-enumeration-constant
:ref:`Filter<enum_OpenXRCompositionLayer_Filter>` **FILTER_NEAREST** = ``0``
Utilizza il filtro vicino più ravvicinato per campionare la texture.
.. _class_OpenXRCompositionLayer_constant_FILTER_LINEAR:
.. rst-class:: classref-enumeration-constant
:ref:`Filter<enum_OpenXRCompositionLayer_Filter>` **FILTER_LINEAR** = ``1``
Utilizza il filtro lineare per campionare la texture.
.. _class_OpenXRCompositionLayer_constant_FILTER_CUBIC:
.. rst-class:: classref-enumeration-constant
:ref:`Filter<enum_OpenXRCompositionLayer_Filter>` **FILTER_CUBIC** = ``2``
Utilizza il filtro cubico per campionare la texture.
.. rst-class:: classref-item-separator
----
.. _enum_OpenXRCompositionLayer_MipmapMode:
.. rst-class:: classref-enumeration
enum **MipmapMode**: :ref:`🔗<enum_OpenXRCompositionLayer_MipmapMode>`
.. _class_OpenXRCompositionLayer_constant_MIPMAP_MODE_DISABLED:
.. rst-class:: classref-enumeration-constant
:ref:`MipmapMode<enum_OpenXRCompositionLayer_MipmapMode>` **MIPMAP_MODE_DISABLED** = ``0``
Disabilita il mipmapping.
\ **Nota:** il mipmapping si può disabilitare solo nel renderer Compatibilità.
.. _class_OpenXRCompositionLayer_constant_MIPMAP_MODE_NEAREST:
.. rst-class:: classref-enumeration-constant
:ref:`MipmapMode<enum_OpenXRCompositionLayer_MipmapMode>` **MIPMAP_MODE_NEAREST** = ``1``
Utilizza la mipmap della risoluzione più vicina.
.. _class_OpenXRCompositionLayer_constant_MIPMAP_MODE_LINEAR:
.. rst-class:: classref-enumeration-constant
:ref:`MipmapMode<enum_OpenXRCompositionLayer_MipmapMode>` **MIPMAP_MODE_LINEAR** = ``2``
Utilizza un'interpolazione lineare tra le due mipmap della risoluzione più vicina.
.. rst-class:: classref-item-separator
----
.. _enum_OpenXRCompositionLayer_Wrap:
.. rst-class:: classref-enumeration
enum **Wrap**: :ref:`🔗<enum_OpenXRCompositionLayer_Wrap>`
.. _class_OpenXRCompositionLayer_constant_WRAP_CLAMP_TO_BORDER:
.. rst-class:: classref-enumeration-constant
:ref:`Wrap<enum_OpenXRCompositionLayer_Wrap>` **WRAP_CLAMP_TO_BORDER** = ``0``
Limita la texture al suo colore di bordo specificato.
.. _class_OpenXRCompositionLayer_constant_WRAP_CLAMP_TO_EDGE:
.. rst-class:: classref-enumeration-constant
:ref:`Wrap<enum_OpenXRCompositionLayer_Wrap>` **WRAP_CLAMP_TO_EDGE** = ``1``
Limita la texture al suo colore di bordo.
.. _class_OpenXRCompositionLayer_constant_WRAP_REPEAT:
.. rst-class:: classref-enumeration-constant
:ref:`Wrap<enum_OpenXRCompositionLayer_Wrap>` **WRAP_REPEAT** = ``2``
Ripete la texture infinitamente.
.. _class_OpenXRCompositionLayer_constant_WRAP_MIRRORED_REPEAT:
.. rst-class:: classref-enumeration-constant
:ref:`Wrap<enum_OpenXRCompositionLayer_Wrap>` **WRAP_MIRRORED_REPEAT** = ``3``
Ripeti la texture all'infinito, rispecchiandola a ogni ripetizione.
.. _class_OpenXRCompositionLayer_constant_WRAP_MIRROR_CLAMP_TO_EDGE:
.. rst-class:: classref-enumeration-constant
:ref:`Wrap<enum_OpenXRCompositionLayer_Wrap>` **WRAP_MIRROR_CLAMP_TO_EDGE** = ``4``
Rispecchia la texture una sola volta e poi la limita al suo colore di bordo.
\ **Nota:** Questa modalità di avvolgimento non è disponibile nel renderer Compatibilità.
.. rst-class:: classref-item-separator
----
.. _enum_OpenXRCompositionLayer_Swizzle:
.. rst-class:: classref-enumeration
enum **Swizzle**: :ref:`🔗<enum_OpenXRCompositionLayer_Swizzle>`
.. _class_OpenXRCompositionLayer_constant_SWIZZLE_RED:
.. rst-class:: classref-enumeration-constant
:ref:`Swizzle<enum_OpenXRCompositionLayer_Swizzle>` **SWIZZLE_RED** = ``0``
Mappa un canale colore al valore del canale rosso.
.. _class_OpenXRCompositionLayer_constant_SWIZZLE_GREEN:
.. rst-class:: classref-enumeration-constant
:ref:`Swizzle<enum_OpenXRCompositionLayer_Swizzle>` **SWIZZLE_GREEN** = ``1``
Mappa un canale colore al valore del canale verde.
.. _class_OpenXRCompositionLayer_constant_SWIZZLE_BLUE:
.. rst-class:: classref-enumeration-constant
:ref:`Swizzle<enum_OpenXRCompositionLayer_Swizzle>` **SWIZZLE_BLUE** = ``2``
Mappa un canale colore al valore del canale blu.
.. _class_OpenXRCompositionLayer_constant_SWIZZLE_ALPHA:
.. rst-class:: classref-enumeration-constant
:ref:`Swizzle<enum_OpenXRCompositionLayer_Swizzle>` **SWIZZLE_ALPHA** = ``3``
Mappa un canale colore al valore del canale alfa.
.. _class_OpenXRCompositionLayer_constant_SWIZZLE_ZERO:
.. rst-class:: classref-enumeration-constant
:ref:`Swizzle<enum_OpenXRCompositionLayer_Swizzle>` **SWIZZLE_ZERO** = ``4``
Mappa un canale colore al valore di zero.
.. _class_OpenXRCompositionLayer_constant_SWIZZLE_ONE:
.. rst-class:: classref-enumeration-constant
:ref:`Swizzle<enum_OpenXRCompositionLayer_Swizzle>` **SWIZZLE_ONE** = ``5``
Mappa un canale colore al valore di uno.
.. rst-class:: classref-section-separator
----
.. rst-class:: classref-descriptions-group
Descrizioni delle proprietà
------------------------------------------------------
.. _class_OpenXRCompositionLayer_property_alpha_blend:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **alpha_blend** = ``false`` :ref:`🔗<class_OpenXRCompositionLayer_property_alpha_blend>`
.. rst-class:: classref-property-setget
- |void| **set_alpha_blend**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **get_alpha_blend**\ (\ )
Abilita la fusione del livello usando il suo canale alfa.
Può essere combinato con :ref:`Viewport.transparent_bg<class_Viewport_property_transparent_bg>` per dare al livello uno sfondo trasparente.
.. rst-class:: classref-item-separator
----
.. _class_OpenXRCompositionLayer_property_android_surface_size:
.. rst-class:: classref-property
:ref:`Vector2i<class_Vector2i>` **android_surface_size** = ``Vector2i(1024, 1024)`` :ref:`🔗<class_OpenXRCompositionLayer_property_android_surface_size>`
.. rst-class:: classref-property-setget
- |void| **set_android_surface_size**\ (\ value\: :ref:`Vector2i<class_Vector2i>`\ )
- :ref:`Vector2i<class_Vector2i>` **get_android_surface_size**\ (\ )
La dimensione della superficie Android da creare se :ref:`use_android_surface<class_OpenXRCompositionLayer_property_use_android_surface>` è abilitato.
.. rst-class:: classref-item-separator
----
.. _class_OpenXRCompositionLayer_property_enable_hole_punch:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **enable_hole_punch** = ``false`` :ref:`🔗<class_OpenXRCompositionLayer_property_enable_hole_punch>`
.. rst-class:: classref-property-setget
- |void| **set_enable_hole_punch**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **get_enable_hole_punch**\ (\ )
Abilita una tecnica chiamata "hole punching", che consente di posizionare il livello di composizione dietro il livello di proiezione principale (ad esempio impostando :ref:`sort_order<class_OpenXRCompositionLayer_property_sort_order>` su un valore negativo) mentre "perfora un buco" attraverso tutto ciò che è stato renderizzato da Godot in modo che il livello sia ancora visibile.
Ciò può essere utilizzato per creare l'illusione che il livello di composizione esista nello stesso spazio 3D di tutto ciò che è stato renderizzato da Godot, consentendo agli oggetti di apparire come se passassero dietro o davanti al livello di composizione.
.. rst-class:: classref-item-separator
----
.. _class_OpenXRCompositionLayer_property_layer_viewport:
.. rst-class:: classref-property
:ref:`SubViewport<class_SubViewport>` **layer_viewport** :ref:`🔗<class_OpenXRCompositionLayer_property_layer_viewport>`
.. rst-class:: classref-property-setget
- |void| **set_layer_viewport**\ (\ value\: :ref:`SubViewport<class_SubViewport>`\ )
- :ref:`SubViewport<class_SubViewport>` **get_layer_viewport**\ (\ )
La :ref:`SubViewport<class_SubViewport>` da renderizzare sul livello di composizione.
.. rst-class:: classref-item-separator
----
.. _class_OpenXRCompositionLayer_property_protected_content:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **protected_content** = ``false`` :ref:`🔗<class_OpenXRCompositionLayer_property_protected_content>`
.. rst-class:: classref-property-setget
- |void| **set_protected_content**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_protected_content**\ (\ )
If enabled, the OpenXR swapchain will be created with the ``XR_SWAPCHAIN_CREATE_PROTECTED_CONTENT_BIT`` flag, which will protect its contents from CPU access.
When used with an Android Surface, this may allow DRM content to be presented, and will only take effect when the Surface is first created; later changes to this property will have no effect.
.. rst-class:: classref-item-separator
----
.. _class_OpenXRCompositionLayer_property_sort_order:
.. rst-class:: classref-property
:ref:`int<class_int>` **sort_order** = ``1`` :ref:`🔗<class_OpenXRCompositionLayer_property_sort_order>`
.. rst-class:: classref-property-setget
- |void| **set_sort_order**\ (\ value\: :ref:`int<class_int>`\ )
- :ref:`int<class_int>` **get_sort_order**\ (\ )
L'ordine di ordinamento per questo livello di composizione. I numeri più alti saranno mostrati davanti ai numeri più bassi.
\ **Nota:** Questo non avrà alcun effetto se si utilizza una mesh di riserva.
.. rst-class:: classref-item-separator
----
.. _class_OpenXRCompositionLayer_property_swapchain_state_alpha_swizzle:
.. rst-class:: classref-property
:ref:`Swizzle<enum_OpenXRCompositionLayer_Swizzle>` **swapchain_state_alpha_swizzle** = ``3`` :ref:`🔗<class_OpenXRCompositionLayer_property_swapchain_state_alpha_swizzle>`
.. rst-class:: classref-property-setget
- |void| **set_alpha_swizzle**\ (\ value\: :ref:`Swizzle<enum_OpenXRCompositionLayer_Swizzle>`\ )
- :ref:`Swizzle<enum_OpenXRCompositionLayer_Swizzle>` **get_alpha_swizzle**\ (\ )
Il valore di permutazione (swizzle) per il canale alfa dello stato della swapchain.
\ **Nota:** Questa proprietà ha effetto solo sui dispositivi che supportano le estensioni OpenGLES/Vulkan OpenXR XR_FB_swapchain_update_state.
.. rst-class:: classref-item-separator
----
.. _class_OpenXRCompositionLayer_property_swapchain_state_blue_swizzle:
.. rst-class:: classref-property
:ref:`Swizzle<enum_OpenXRCompositionLayer_Swizzle>` **swapchain_state_blue_swizzle** = ``2`` :ref:`🔗<class_OpenXRCompositionLayer_property_swapchain_state_blue_swizzle>`
.. rst-class:: classref-property-setget
- |void| **set_blue_swizzle**\ (\ value\: :ref:`Swizzle<enum_OpenXRCompositionLayer_Swizzle>`\ )
- :ref:`Swizzle<enum_OpenXRCompositionLayer_Swizzle>` **get_blue_swizzle**\ (\ )
Il valore di permutazione (swizzle) per il canale blu dello stato della swapchain.
\ **Nota:** Questa proprietà ha effetto solo sui dispositivi che supportano le estensioni OpenGLES/Vulkan OpenXR XR_FB_swapchain_update_state.
.. rst-class:: classref-item-separator
----
.. _class_OpenXRCompositionLayer_property_swapchain_state_border_color:
.. rst-class:: classref-property
:ref:`Color<class_Color>` **swapchain_state_border_color** = ``Color(0, 0, 0, 0)`` :ref:`🔗<class_OpenXRCompositionLayer_property_swapchain_state_border_color>`
.. rst-class:: classref-property-setget
- |void| **set_border_color**\ (\ value\: :ref:`Color<class_Color>`\ )
- :ref:`Color<class_Color>` **get_border_color**\ (\ )
Colore di bordo dello stato di swapchain utilizzato quando la modalità di avvolgimento si limita al bordo.
\ **Nota:** Questa proprietà ha effetto solo sui dispositivi che supportano le estensioni OpenGLES/Vulkan OpenXR XR_FB_swapchain_update_state.
.. rst-class:: classref-item-separator
----
.. _class_OpenXRCompositionLayer_property_swapchain_state_green_swizzle:
.. rst-class:: classref-property
:ref:`Swizzle<enum_OpenXRCompositionLayer_Swizzle>` **swapchain_state_green_swizzle** = ``1`` :ref:`🔗<class_OpenXRCompositionLayer_property_swapchain_state_green_swizzle>`
.. rst-class:: classref-property-setget
- |void| **set_green_swizzle**\ (\ value\: :ref:`Swizzle<enum_OpenXRCompositionLayer_Swizzle>`\ )
- :ref:`Swizzle<enum_OpenXRCompositionLayer_Swizzle>` **get_green_swizzle**\ (\ )
Il valore di permutazione (swizzle) per il canale verde dello stato della swapchain.
\ **Nota:** Questa proprietà ha effetto solo sui dispositivi che supportano le estensioni OpenGLES/Vulkan OpenXR XR_FB_swapchain_update_state.
.. rst-class:: classref-item-separator
----
.. _class_OpenXRCompositionLayer_property_swapchain_state_horizontal_wrap:
.. rst-class:: classref-property
:ref:`Wrap<enum_OpenXRCompositionLayer_Wrap>` **swapchain_state_horizontal_wrap** = ``0`` :ref:`🔗<class_OpenXRCompositionLayer_property_swapchain_state_horizontal_wrap>`
.. rst-class:: classref-property-setget
- |void| **set_horizontal_wrap**\ (\ value\: :ref:`Wrap<enum_OpenXRCompositionLayer_Wrap>`\ )
- :ref:`Wrap<enum_OpenXRCompositionLayer_Wrap>` **get_horizontal_wrap**\ (\ )
La modalità di avvolgimento orizzontale dello stato della swapchain.
\ **Nota:** Questa proprietà ha effetto solo sui dispositivi che supportano le estensioni OpenGLES/Vulkan OpenXR XR_FB_swapchain_update_state.
.. rst-class:: classref-item-separator
----
.. _class_OpenXRCompositionLayer_property_swapchain_state_mag_filter:
.. rst-class:: classref-property
:ref:`Filter<enum_OpenXRCompositionLayer_Filter>` **swapchain_state_mag_filter** = ``1`` :ref:`🔗<class_OpenXRCompositionLayer_property_swapchain_state_mag_filter>`
.. rst-class:: classref-property-setget
- |void| **set_mag_filter**\ (\ value\: :ref:`Filter<enum_OpenXRCompositionLayer_Filter>`\ )
- :ref:`Filter<enum_OpenXRCompositionLayer_Filter>` **get_mag_filter**\ (\ )
Il filtro di ingrandimento dello stato della swapchain.
\ **Nota:** Questa proprietà ha effetto solo sui dispositivi che supportano le estensioni OpenGLES/Vulkan OpenXR XR_FB_swapchain_update_state.
.. rst-class:: classref-item-separator
----
.. _class_OpenXRCompositionLayer_property_swapchain_state_max_anisotropy:
.. rst-class:: classref-property
:ref:`float<class_float>` **swapchain_state_max_anisotropy** = ``1.0`` :ref:`🔗<class_OpenXRCompositionLayer_property_swapchain_state_max_anisotropy>`
.. rst-class:: classref-property-setget
- |void| **set_max_anisotropy**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_max_anisotropy**\ (\ )
L'anisotropia massima dello stato della swapchain.
\ **Nota:** Questa proprietà ha effetto solo sui dispositivi che supportano le estensioni OpenGLES/Vulkan OpenXR XR_FB_swapchain_update_state.
.. rst-class:: classref-item-separator
----
.. _class_OpenXRCompositionLayer_property_swapchain_state_min_filter:
.. rst-class:: classref-property
:ref:`Filter<enum_OpenXRCompositionLayer_Filter>` **swapchain_state_min_filter** = ``1`` :ref:`🔗<class_OpenXRCompositionLayer_property_swapchain_state_min_filter>`
.. rst-class:: classref-property-setget
- |void| **set_min_filter**\ (\ value\: :ref:`Filter<enum_OpenXRCompositionLayer_Filter>`\ )
- :ref:`Filter<enum_OpenXRCompositionLayer_Filter>` **get_min_filter**\ (\ )
Il filtro di minimizzazione dello stato della swapchain.
\ **Nota:** Questa proprietà ha effetto solo sui dispositivi che supportano le estensioni OpenGLES/Vulkan OpenXR XR_FB_swapchain_update_state.
.. rst-class:: classref-item-separator
----
.. _class_OpenXRCompositionLayer_property_swapchain_state_mipmap_mode:
.. rst-class:: classref-property
:ref:`MipmapMode<enum_OpenXRCompositionLayer_MipmapMode>` **swapchain_state_mipmap_mode** = ``2`` :ref:`🔗<class_OpenXRCompositionLayer_property_swapchain_state_mipmap_mode>`
.. rst-class:: classref-property-setget
- |void| **set_mipmap_mode**\ (\ value\: :ref:`MipmapMode<enum_OpenXRCompositionLayer_MipmapMode>`\ )
- :ref:`MipmapMode<enum_OpenXRCompositionLayer_MipmapMode>` **get_mipmap_mode**\ (\ )
La modalità di mipmap dello stato della swapchain.
\ **Nota:** Questa proprietà ha effetto solo sui dispositivi che supportano le estensioni OpenGLES/Vulkan OpenXR XR_FB_swapchain_update_state.
.. rst-class:: classref-item-separator
----
.. _class_OpenXRCompositionLayer_property_swapchain_state_red_swizzle:
.. rst-class:: classref-property
:ref:`Swizzle<enum_OpenXRCompositionLayer_Swizzle>` **swapchain_state_red_swizzle** = ``0`` :ref:`🔗<class_OpenXRCompositionLayer_property_swapchain_state_red_swizzle>`
.. rst-class:: classref-property-setget
- |void| **set_red_swizzle**\ (\ value\: :ref:`Swizzle<enum_OpenXRCompositionLayer_Swizzle>`\ )
- :ref:`Swizzle<enum_OpenXRCompositionLayer_Swizzle>` **get_red_swizzle**\ (\ )
Il valore di permutazione (swizzle) per il canale rosso dello stato della swapchain.
\ **Nota:** Questa proprietà ha effetto solo sui dispositivi che supportano le estensioni OpenGLES/Vulkan OpenXR XR_FB_swapchain_update_state.
.. rst-class:: classref-item-separator
----
.. _class_OpenXRCompositionLayer_property_swapchain_state_vertical_wrap:
.. rst-class:: classref-property
:ref:`Wrap<enum_OpenXRCompositionLayer_Wrap>` **swapchain_state_vertical_wrap** = ``0`` :ref:`🔗<class_OpenXRCompositionLayer_property_swapchain_state_vertical_wrap>`
.. rst-class:: classref-property-setget
- |void| **set_vertical_wrap**\ (\ value\: :ref:`Wrap<enum_OpenXRCompositionLayer_Wrap>`\ )
- :ref:`Wrap<enum_OpenXRCompositionLayer_Wrap>` **get_vertical_wrap**\ (\ )
La modalità di avvolgimento verticale dello stato della swapchain.
\ **Nota:** Questa proprietà ha effetto solo sui dispositivi che supportano le estensioni OpenGLES/Vulkan OpenXR XR_FB_swapchain_update_state.
.. rst-class:: classref-item-separator
----
.. _class_OpenXRCompositionLayer_property_use_android_surface:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **use_android_surface** = ``false`` :ref:`🔗<class_OpenXRCompositionLayer_property_use_android_surface>`
.. rst-class:: classref-property-setget
- |void| **set_use_android_surface**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **get_use_android_surface**\ (\ )
Se abilitato, sarà creata una superficie Android (con le dimensioni di :ref:`android_surface_size<class_OpenXRCompositionLayer_property_android_surface_size>`) che fornirà il contenuto 2D per il livello di composizione, invece di usare :ref:`layer_viewport<class_OpenXRCompositionLayer_property_layer_viewport>`.
Consulta :ref:`get_android_surface()<class_OpenXRCompositionLayer_method_get_android_surface>` per informazioni su come ottenere la superficie in modo che la tua applicazione ci possa disegnare sopra.
\ **Nota:** Ciò funzionerà solo nelle build Android.
.. rst-class:: classref-section-separator
----
.. rst-class:: classref-descriptions-group
Descrizioni dei metodi
--------------------------------------------
.. _class_OpenXRCompositionLayer_method_get_android_surface:
.. rst-class:: classref-method
:ref:`JavaObject<class_JavaObject>` **get_android_surface**\ (\ ) :ref:`🔗<class_OpenXRCompositionLayer_method_get_android_surface>`
Restituisce un :ref:`JavaObject<class_JavaObject>` che rappresenta un ``android.view.Surface`` se :ref:`use_android_surface<class_OpenXRCompositionLayer_property_use_android_surface>` è abilitato e OpenXR ha creato la superficie. Altrimenti, restituirà ``null``.
\ **Nota:** È possibile creare la superficie solo durante una sessione OpenXR attiva. Quindi, se :ref:`use_android_surface<class_OpenXRCompositionLayer_property_use_android_surface>` è abilitato al di fuori di una sessione OpenXR, non verrà creata finché non si avvia completamente una nuova sessione.
.. rst-class:: classref-item-separator
----
.. _class_OpenXRCompositionLayer_method_intersects_ray:
.. rst-class:: classref-method
:ref:`Vector2<class_Vector2>` **intersects_ray**\ (\ origin\: :ref:`Vector3<class_Vector3>`, direction\: :ref:`Vector3<class_Vector3>`\ ) |const| :ref:`🔗<class_OpenXRCompositionLayer_method_intersects_ray>`
Restituisce le coordinate UV in cui il raggio specificato interseca il livello di composizione. ``origin`` e ``direction`` devono essere nello spazio globale.
Restituisce ``Vector2(-1.0, -1.0)`` se il raggio non interseca.
.. rst-class:: classref-item-separator
----
.. _class_OpenXRCompositionLayer_method_is_natively_supported:
.. rst-class:: classref-method
:ref:`bool<class_bool>` **is_natively_supported**\ (\ ) |const| :ref:`🔗<class_OpenXRCompositionLayer_method_is_natively_supported>`
Restituisce ``true`` se il runtime OpenXR supporta nativamente questo tipo di livello di composizione.
\ **Nota:** Questo metodo restituirà un risultato preciso solo dopo l'avvio della sessione OpenXR.
.. |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.)`