mirror of
https://github.com/godotengine/godot-docs-l10n.git
synced 2026-01-05 14:10:19 +03:00
424 lines
18 KiB
ReStructuredText
424 lines
18 KiB
ReStructuredText
:github_url: hide
|
|
|
|
.. _class_CameraFeed:
|
|
|
|
CameraFeed
|
|
==========
|
|
|
|
**Eredita:** :ref:`RefCounted<class_RefCounted>` **<** :ref:`Object<class_Object>`
|
|
|
|
Un feed della telecamera ti dà accesso a una singola telecamera fisica collegata al tuo dispositivo.
|
|
|
|
.. rst-class:: classref-introduction-group
|
|
|
|
Descrizione
|
|
----------------------
|
|
|
|
Un feed di fotocamera ti dà accesso a una singola fotocamera fisica collegata al tuo dispositivo. Quando abilitato, Godot inizierà a catturare fotogrammi dalla fotocamera da poi utilizzare. Vedi anche :ref:`CameraServer<class_CameraServer>`.
|
|
|
|
\ **Nota:** Molte fotocamere restituiscono immagini in YCbCr che sono divise in due texture e che devono essere combinate in uno shader. Godot fa ciò automaticamente se l'ambiente è impostato per mostrare l'immagine della fotocamera nello sfondo.
|
|
|
|
\ **Nota:** Questa classe è attualmente implementata solo su Linux, Android, macOS e iOS. Su altre piattaforme i **CameraFeed** non saranno disponibili. Per ottenere un **CameraFeed** su iOS, è necessaria l'estensione della fotocamera da `godot-ios-plugins <https://github.com/godotengine/godot-ios-plugins>`__.
|
|
|
|
.. rst-class:: classref-reftable-group
|
|
|
|
Proprietà
|
|
------------------
|
|
|
|
.. table::
|
|
:widths: auto
|
|
|
|
+---------------------------------------+-----------------------------------------------------------------+------------------------------------+
|
|
| :ref:`bool<class_bool>` | :ref:`feed_is_active<class_CameraFeed_property_feed_is_active>` | ``false`` |
|
|
+---------------------------------------+-----------------------------------------------------------------+------------------------------------+
|
|
| :ref:`Transform2D<class_Transform2D>` | :ref:`feed_transform<class_CameraFeed_property_feed_transform>` | ``Transform2D(1, 0, 0, -1, 0, 1)`` |
|
|
+---------------------------------------+-----------------------------------------------------------------+------------------------------------+
|
|
| :ref:`Array<class_Array>` | :ref:`formats<class_CameraFeed_property_formats>` | ``[]`` |
|
|
+---------------------------------------+-----------------------------------------------------------------+------------------------------------+
|
|
|
|
.. rst-class:: classref-reftable-group
|
|
|
|
Metodi
|
|
------------
|
|
|
|
.. table::
|
|
:widths: auto
|
|
|
|
+---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`bool<class_bool>` | :ref:`_activate_feed<class_CameraFeed_private_method__activate_feed>`\ (\ ) |virtual| |
|
|
+---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| |void| | :ref:`_deactivate_feed<class_CameraFeed_private_method__deactivate_feed>`\ (\ ) |virtual| |
|
|
+---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`FeedDataType<enum_CameraFeed_FeedDataType>` | :ref:`get_datatype<class_CameraFeed_method_get_datatype>`\ (\ ) |const| |
|
|
+---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`int<class_int>` | :ref:`get_id<class_CameraFeed_method_get_id>`\ (\ ) |const| |
|
|
+---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`String<class_String>` | :ref:`get_name<class_CameraFeed_method_get_name>`\ (\ ) |const| |
|
|
+---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`FeedPosition<enum_CameraFeed_FeedPosition>` | :ref:`get_position<class_CameraFeed_method_get_position>`\ (\ ) |const| |
|
|
+---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`int<class_int>` | :ref:`get_texture_tex_id<class_CameraFeed_method_get_texture_tex_id>`\ (\ feed_image_type\: :ref:`FeedImage<enum_CameraServer_FeedImage>`\ ) |
|
|
+---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| |void| | :ref:`set_external<class_CameraFeed_method_set_external>`\ (\ width\: :ref:`int<class_int>`, height\: :ref:`int<class_int>`\ ) |
|
|
+---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`bool<class_bool>` | :ref:`set_format<class_CameraFeed_method_set_format>`\ (\ index\: :ref:`int<class_int>`, parameters\: :ref:`Dictionary<class_Dictionary>`\ ) |
|
|
+---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| |void| | :ref:`set_name<class_CameraFeed_method_set_name>`\ (\ name\: :ref:`String<class_String>`\ ) |
|
|
+---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| |void| | :ref:`set_position<class_CameraFeed_method_set_position>`\ (\ position\: :ref:`FeedPosition<enum_CameraFeed_FeedPosition>`\ ) |
|
|
+---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| |void| | :ref:`set_rgb_image<class_CameraFeed_method_set_rgb_image>`\ (\ rgb_image\: :ref:`Image<class_Image>`\ ) |
|
|
+---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| |void| | :ref:`set_ycbcr_image<class_CameraFeed_method_set_ycbcr_image>`\ (\ ycbcr_image\: :ref:`Image<class_Image>`\ ) |
|
|
+---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------+
|
|
|
|
.. rst-class:: classref-section-separator
|
|
|
|
----
|
|
|
|
.. rst-class:: classref-descriptions-group
|
|
|
|
Segnali
|
|
--------------
|
|
|
|
.. _class_CameraFeed_signal_format_changed:
|
|
|
|
.. rst-class:: classref-signal
|
|
|
|
**format_changed**\ (\ ) :ref:`🔗<class_CameraFeed_signal_format_changed>`
|
|
|
|
Emesso quando il formato è cambiato.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_CameraFeed_signal_frame_changed:
|
|
|
|
.. rst-class:: classref-signal
|
|
|
|
**frame_changed**\ (\ ) :ref:`🔗<class_CameraFeed_signal_frame_changed>`
|
|
|
|
Emesso quando un nuovo fotogramma è disponibile.
|
|
|
|
.. rst-class:: classref-section-separator
|
|
|
|
----
|
|
|
|
.. rst-class:: classref-descriptions-group
|
|
|
|
Enumerazioni
|
|
------------------------
|
|
|
|
.. _enum_CameraFeed_FeedDataType:
|
|
|
|
.. rst-class:: classref-enumeration
|
|
|
|
enum **FeedDataType**: :ref:`🔗<enum_CameraFeed_FeedDataType>`
|
|
|
|
.. _class_CameraFeed_constant_FEED_NOIMAGE:
|
|
|
|
.. rst-class:: classref-enumeration-constant
|
|
|
|
:ref:`FeedDataType<enum_CameraFeed_FeedDataType>` **FEED_NOIMAGE** = ``0``
|
|
|
|
Nessuna immagine impostata per il feed.
|
|
|
|
.. _class_CameraFeed_constant_FEED_RGB:
|
|
|
|
.. rst-class:: classref-enumeration-constant
|
|
|
|
:ref:`FeedDataType<enum_CameraFeed_FeedDataType>` **FEED_RGB** = ``1``
|
|
|
|
Il feed fornisce immagini nel formato RGB.
|
|
|
|
.. _class_CameraFeed_constant_FEED_YCBCR:
|
|
|
|
.. rst-class:: classref-enumeration-constant
|
|
|
|
:ref:`FeedDataType<enum_CameraFeed_FeedDataType>` **FEED_YCBCR** = ``2``
|
|
|
|
Il feed fornisce immagini nel formato YCbCr che devono essere convertite in RGB.
|
|
|
|
.. _class_CameraFeed_constant_FEED_YCBCR_SEP:
|
|
|
|
.. rst-class:: classref-enumeration-constant
|
|
|
|
:ref:`FeedDataType<enum_CameraFeed_FeedDataType>` **FEED_YCBCR_SEP** = ``3``
|
|
|
|
Il feed fornisce immagini nel formato Y e CbCr separate che devono essere combinate e convertite in RGB.
|
|
|
|
.. _class_CameraFeed_constant_FEED_EXTERNAL:
|
|
|
|
.. rst-class:: classref-enumeration-constant
|
|
|
|
:ref:`FeedDataType<enum_CameraFeed_FeedDataType>` **FEED_EXTERNAL** = ``4``
|
|
|
|
Il feed fornisce un'immagine esterna.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _enum_CameraFeed_FeedPosition:
|
|
|
|
.. rst-class:: classref-enumeration
|
|
|
|
enum **FeedPosition**: :ref:`🔗<enum_CameraFeed_FeedPosition>`
|
|
|
|
.. _class_CameraFeed_constant_FEED_UNSPECIFIED:
|
|
|
|
.. rst-class:: classref-enumeration-constant
|
|
|
|
:ref:`FeedPosition<enum_CameraFeed_FeedPosition>` **FEED_UNSPECIFIED** = ``0``
|
|
|
|
Posizione non specificata.
|
|
|
|
.. _class_CameraFeed_constant_FEED_FRONT:
|
|
|
|
.. rst-class:: classref-enumeration-constant
|
|
|
|
:ref:`FeedPosition<enum_CameraFeed_FeedPosition>` **FEED_FRONT** = ``1``
|
|
|
|
La fotocamera è montata in avanti al dispositivo.
|
|
|
|
.. _class_CameraFeed_constant_FEED_BACK:
|
|
|
|
.. rst-class:: classref-enumeration-constant
|
|
|
|
:ref:`FeedPosition<enum_CameraFeed_FeedPosition>` **FEED_BACK** = ``2``
|
|
|
|
La fotocamera è montata sul retro del dispositivo.
|
|
|
|
.. rst-class:: classref-section-separator
|
|
|
|
----
|
|
|
|
.. rst-class:: classref-descriptions-group
|
|
|
|
Descrizioni delle proprietà
|
|
------------------------------------------------------
|
|
|
|
.. _class_CameraFeed_property_feed_is_active:
|
|
|
|
.. rst-class:: classref-property
|
|
|
|
:ref:`bool<class_bool>` **feed_is_active** = ``false`` :ref:`🔗<class_CameraFeed_property_feed_is_active>`
|
|
|
|
.. rst-class:: classref-property-setget
|
|
|
|
- |void| **set_active**\ (\ value\: :ref:`bool<class_bool>`\ )
|
|
- :ref:`bool<class_bool>` **is_active**\ (\ )
|
|
|
|
Se ``true``, il feed è attivo.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_CameraFeed_property_feed_transform:
|
|
|
|
.. rst-class:: classref-property
|
|
|
|
:ref:`Transform2D<class_Transform2D>` **feed_transform** = ``Transform2D(1, 0, 0, -1, 0, 1)`` :ref:`🔗<class_CameraFeed_property_feed_transform>`
|
|
|
|
.. rst-class:: classref-property-setget
|
|
|
|
- |void| **set_transform**\ (\ value\: :ref:`Transform2D<class_Transform2D>`\ )
|
|
- :ref:`Transform2D<class_Transform2D>` **get_transform**\ (\ )
|
|
|
|
La trasformazione applicata all'immagine della fotocamera.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_CameraFeed_property_formats:
|
|
|
|
.. rst-class:: classref-property
|
|
|
|
:ref:`Array<class_Array>` **formats** = ``[]`` :ref:`🔗<class_CameraFeed_property_formats>`
|
|
|
|
.. rst-class:: classref-property-setget
|
|
|
|
- :ref:`Array<class_Array>` **get_formats**\ (\ )
|
|
|
|
Formati supportati dal feed. Ogni voce è un :ref:`Dictionary<class_Dictionary>` che descrive i parametri del formato.
|
|
|
|
.. rst-class:: classref-section-separator
|
|
|
|
----
|
|
|
|
.. rst-class:: classref-descriptions-group
|
|
|
|
Descrizioni dei metodi
|
|
--------------------------------------------
|
|
|
|
.. _class_CameraFeed_private_method__activate_feed:
|
|
|
|
.. rst-class:: classref-method
|
|
|
|
:ref:`bool<class_bool>` **_activate_feed**\ (\ ) |virtual| :ref:`🔗<class_CameraFeed_private_method__activate_feed>`
|
|
|
|
Chiamato quando il feed della fotocamera viene attivato.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_CameraFeed_private_method__deactivate_feed:
|
|
|
|
.. rst-class:: classref-method
|
|
|
|
|void| **_deactivate_feed**\ (\ ) |virtual| :ref:`🔗<class_CameraFeed_private_method__deactivate_feed>`
|
|
|
|
Chiamato quando il feed della fotocamera viene disattivato.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_CameraFeed_method_get_datatype:
|
|
|
|
.. rst-class:: classref-method
|
|
|
|
:ref:`FeedDataType<enum_CameraFeed_FeedDataType>` **get_datatype**\ (\ ) |const| :ref:`🔗<class_CameraFeed_method_get_datatype>`
|
|
|
|
Restituisce il tipo di dati dell'immagine del feed.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_CameraFeed_method_get_id:
|
|
|
|
.. rst-class:: classref-method
|
|
|
|
:ref:`int<class_int>` **get_id**\ (\ ) |const| :ref:`🔗<class_CameraFeed_method_get_id>`
|
|
|
|
Restituisce l'ID unico per questo feed.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_CameraFeed_method_get_name:
|
|
|
|
.. rst-class:: classref-method
|
|
|
|
:ref:`String<class_String>` **get_name**\ (\ ) |const| :ref:`🔗<class_CameraFeed_method_get_name>`
|
|
|
|
Restituisce il nome della fotocamera.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_CameraFeed_method_get_position:
|
|
|
|
.. rst-class:: classref-method
|
|
|
|
:ref:`FeedPosition<enum_CameraFeed_FeedPosition>` **get_position**\ (\ ) |const| :ref:`🔗<class_CameraFeed_method_get_position>`
|
|
|
|
Restituisce la posizione della fotocamera sul dispositivo.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_CameraFeed_method_get_texture_tex_id:
|
|
|
|
.. rst-class:: classref-method
|
|
|
|
:ref:`int<class_int>` **get_texture_tex_id**\ (\ feed_image_type\: :ref:`FeedImage<enum_CameraServer_FeedImage>`\ ) :ref:`🔗<class_CameraFeed_method_get_texture_tex_id>`
|
|
|
|
Restituisce l'ID backend della texture (utilizzabile da alcune librerie esterne che necessitano di un gestore per una texture per scrivere dati).
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_CameraFeed_method_set_external:
|
|
|
|
.. rst-class:: classref-method
|
|
|
|
|void| **set_external**\ (\ width\: :ref:`int<class_int>`, height\: :ref:`int<class_int>`\ ) :ref:`🔗<class_CameraFeed_method_set_external>`
|
|
|
|
Imposta il feed come feed esterno fornito da un'altra libreria.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_CameraFeed_method_set_format:
|
|
|
|
.. rst-class:: classref-method
|
|
|
|
:ref:`bool<class_bool>` **set_format**\ (\ index\: :ref:`int<class_int>`, parameters\: :ref:`Dictionary<class_Dictionary>`\ ) :ref:`🔗<class_CameraFeed_method_set_format>`
|
|
|
|
Imposta i parametri del formato feed per l'indice ``index`` nell'array :ref:`formats<class_CameraFeed_property_formats>`. Restituisce ``true`` in caso di successo. Come predefinito, il flusso codificato in YUYV viene trasformato in :ref:`FEED_RGB<class_CameraFeed_constant_FEED_RGB>`. È possibile modificare il formato risultante del flusso codificato in YUYV impostando la voce ``output`` di ``parameters`` a uno dei seguenti:
|
|
|
|
- ``"separate"`` produrrà :ref:`FEED_YCBCR_SEP<class_CameraFeed_constant_FEED_YCBCR_SEP>`;
|
|
|
|
- ``"grayscale"`` produrrà :ref:`FEED_RGB<class_CameraFeed_constant_FEED_RGB>` desaturato;
|
|
|
|
- ``"copy"`` produrrà :ref:`FEED_YCBCR<class_CameraFeed_constant_FEED_YCBCR>`.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_CameraFeed_method_set_name:
|
|
|
|
.. rst-class:: classref-method
|
|
|
|
|void| **set_name**\ (\ name\: :ref:`String<class_String>`\ ) :ref:`🔗<class_CameraFeed_method_set_name>`
|
|
|
|
Imposta il nome della fotocamera.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_CameraFeed_method_set_position:
|
|
|
|
.. rst-class:: classref-method
|
|
|
|
|void| **set_position**\ (\ position\: :ref:`FeedPosition<enum_CameraFeed_FeedPosition>`\ ) :ref:`🔗<class_CameraFeed_method_set_position>`
|
|
|
|
Imposta la posizione di questa fotocamera.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_CameraFeed_method_set_rgb_image:
|
|
|
|
.. rst-class:: classref-method
|
|
|
|
|void| **set_rgb_image**\ (\ rgb_image\: :ref:`Image<class_Image>`\ ) :ref:`🔗<class_CameraFeed_method_set_rgb_image>`
|
|
|
|
Imposta l'immagine RGB per questo feed.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_CameraFeed_method_set_ycbcr_image:
|
|
|
|
.. rst-class:: classref-method
|
|
|
|
|void| **set_ycbcr_image**\ (\ ycbcr_image\: :ref:`Image<class_Image>`\ ) :ref:`🔗<class_CameraFeed_method_set_ycbcr_image>`
|
|
|
|
Imposta l'immagine YCbCr per questo feed.
|
|
|
|
.. |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.)`
|