Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

CameraFeed

Hereda: RefCounted < Object

La alimentación de la cámara le da acceso a una única cámara física conectada a tu dispositivo.

Descripción

Una transmisión de cámara te da acceso a una cámara física conectada a tu dispositivo. Al activarla, Godot comenzará a capturar fotogramas de la cámara, que luego podrás usar. Véase también CameraServer.

Nota: Muchas cámaras devuelven imágenes YCbCr que se dividen en dos texturas y deben combinarse en un shader. Godot lo hace automáticamente si configuras el entorno para mostrar la imagen de la cámara en segundo plano.

Nota: Esta clase actualmente solo está implementada en Linux, Android, macOS e iOS. En otras plataformas no habrá CameraFeed disponibles. Para obtener un CameraFeed en iOS, habilita EditorExportPlatformIOS.modules/camera.

Propiedades

bool

feed_is_active

false

Transform2D

feed_transform

Transform2D(1, 0, 0, -1, 0, 1)

Array

formats

[]

Métodos

bool

_activate_feed() virtual

void

_deactivate_feed() virtual

Array

_get_formats() virtual const

bool

_set_format(index: int, parameters: Dictionary) virtual

FeedDataType

get_datatype() const

int

get_id() const

String

get_name() const

FeedPosition

get_position() const

int

get_texture_tex_id(feed_image_type: FeedImage)

void

set_external(width: int, height: int)

bool

set_format(index: int, parameters: Dictionary)

void

set_name(name: String)

void

set_position(position: FeedPosition)

void

set_rgb_image(rgb_image: Image)

void

set_ycbcr_image(ycbcr_image: Image)

void

set_ycbcr_images(y_image: Image, cbcr_image: Image)


Señales

format_changed() 🔗

Emitida cuando el formato ha cambiado.


frame_changed() 🔗

Emitted when a new frame is available.


Enumeraciones

enum FeedDataType: 🔗

FeedDataType FEED_NOIMAGE = 0

No hay ninguna imagen establecida para el feed.

FeedDataType FEED_RGB = 1

Proporciona imágenes RGB.

FeedDataType FEED_YCBCR = 2

Proporciona imágenes YCbCr que necesitan ser convertidas a RGB.

FeedDataType FEED_YCBCR_SEP = 3

El sistema de alimentación proporciona imágenes Y y CbCr separadas que deben combinarse y convertirse a RGB.

FeedDataType FEED_EXTERNAL = 4

El feed proporciona una imagen externa.


enum FeedPosition: 🔗

FeedPosition FEED_UNSPECIFIED = 0

Posición no especificada.

FeedPosition FEED_FRONT = 1

La cámara está montada en la parte frontal del dispositivo.

FeedPosition FEED_BACK = 2

La cámara está montada en la parte trasera del dispositivo.


Descripciones de Propiedades

bool feed_is_active = false 🔗

  • void set_active(value: bool)

  • bool is_active()

Si es true, el feed está activo.


Transform2D feed_transform = Transform2D(1, 0, 0, -1, 0, 1) 🔗

The transform applied to the camera's image.


Array formats = [] 🔗

Formatos compatibles con la fuente. Cada entrada es un Dictionary que describe los parámetros del formato.


Descripciones de Métodos

bool _activate_feed() virtual 🔗

Se llama cuando se activa la transmisión de la cámara.


void _deactivate_feed() virtual 🔗

Se llama cuando la transmisión de la cámara está desactivada.


Array _get_formats() virtual const 🔗

Override this method to define supported formats of the camera feed.


bool _set_format(index: int, parameters: Dictionary) virtual 🔗

Override this method to set the format of the camera feed.


FeedDataType get_datatype() const 🔗

Returns feed image data type.


int get_id() const 🔗

Returns the unique ID for this feed.


String get_name() const 🔗

Devuelve el nombre de la cámara.


FeedPosition get_position() const 🔗

Devuelve la posición de la cámara en el dispositivo.


int get_texture_tex_id(feed_image_type: FeedImage) 🔗

Devuelve el ID del backend de la textura (utilizable por algunas bibliotecas externas que necesitan un identificador para una textura para escribir datos).


void set_external(width: int, height: int) 🔗

Establece la fuente como una fuente externa proporcionada por otra biblioteca.


bool set_format(index: int, parameters: Dictionary) 🔗

Establece los parámetros de formato de la fuente para el index dado en el arreglo formats. Devuelve true en caso de éxito. Por defecto, el flujo codificado en YUYV se transforma a FEED_RGB. El formato de salida del flujo codificado en YUYV se puede cambiar estableciendo la entrada output de parameters a uno de los siguientes:


void set_name(name: String) 🔗

Establece el nombre de la cámara.


void set_position(position: FeedPosition) 🔗

Establece la posición de esta cámara.


void set_rgb_image(rgb_image: Image) 🔗

Sets RGB image for this feed.


void set_ycbcr_image(ycbcr_image: Image) 🔗

Sets YCbCr image for this feed.


void set_ycbcr_images(y_image: Image, cbcr_image: Image) 🔗

Establece las imágenes Y y CbCr para esta fuente (feed).