QVideoFrame Class

Documentación de las funciones miembro

QVideoFrame::QVideoFrame()

Construye un fotograma de vídeo nulo.

[explicit, since 6.8] QVideoFrame::QVideoFrame(const QImage &image)

Construye un QVideoFrame a partir de un QImage.

Si QImage::Format coincide con uno de los formatos de QVideoFrameFormat::PixelFormat, el QVideoFrame contendrá una instancia de image y utilizará ese formato sin ninguna conversión de formato de píxel. En este caso, los datos de píxeles sólo se copiarán si se llama a QVideoFrame::map con la bandera WriteOnly manteniendo la imagen original.

De lo contrario, si QImage::Format no coincide con ninguno de los formatos de vídeo, la imagen se convierte primero a un formato (A)RGB compatible utilizando QImage::convertedTo() con el indicador Qt::AutoColor. Esto puede suponer una penalización de rendimiento.

Si QImage::isNull() evalúa a true para la entrada QImage, el QVideoFrame será inválido y QVideoFrameFormat::isValid() devolverá false.

Esta función se introdujo en Qt 6.8.

Ver también QVideoFrameFormat::pixelFormatFromImageFormat(), QImage::convertedTo(), y QImage::isNull().

QVideoFrame::QVideoFrame(const QVideoFrameFormat &format)

Construye un fotograma de vídeo del píxel dado format.

[explicit, since 6.8] QVideoFrame::QVideoFrame(std::unique_ptr<QAbstractVideoBuffer> videoBuffer)

Construye un QVideoFrame a partir de un QAbstractVideoBuffer.

El videoBuffer especificado se refiere a una instancia de un QAbstractVideoBuffer reimplementado. Se espera que la instancia contenga un búfer de vídeo personalizado preasignado y debe implementar QAbstractVideoBuffer::format, QAbstractVideoBuffer::map, y QAbstractVideoBuffer::unmap para contenido GPU.

Si videoBuffer es nulo u obtiene un QVideoFrameFormat inválido , los constructores crean un fotograma de vídeo inválido.

El frame creado mantendrá la propiedad del buffer de video especificado durante toda su vida. Considerando que QVideoFrame es implementado a través de un objeto privado compartido, el buffer de video especificado será destruido al destruirse la última copia del cuadro de video creado.

Nota, si un cuadro de video ha sido pasado a QMediaRecorder o a un pipeline de renderizado, el tiempo de vida del cuadro es indefinido, y el grabador de medios puede destruirlo en un thread diferente.

QVideoFrame contendrá una instancia propia de QVideoFrameFormat. Al invocar setStreamFrameRate, setMirrored, o setRotation, el formato interno puede ser modificado, y surfaceFormat devolverá una instancia separada.

Esta función se introdujo en Qt 6.8.

Véase también QAbstractVideoBuffer y QVideoFrameFormat.

QVideoFrame::QVideoFrame(const QVideoFrame &other)

Construye una copia superficial de other. Dado que QVideoFrame es explícitamente compartido, estas dos instancias reflejarán el mismo frame.

[constexpr noexcept] QVideoFrame::QVideoFrame(QVideoFrame &&other)

Construye un QVideoFrame desplazándose desde other.

[noexcept] QVideoFrame::~QVideoFrame()

Destruye un fotograma de vídeo.

uchar *QVideoFrame::bits(int plane)

Devuelve un puntero al inicio del búfer de datos de trama para un plane.

Este valor sólo es válido mientras los datos del marco estén en mapped.

Los cambios realizados en los datos a los que se accede a través de este puntero (cuando se mapean con acceso de escritura) sólo se garantiza que hayan persistido cuando se llame a unmap() y cuando el búfer haya sido mapeado para escritura.

Véase también map(), mappedBytes(), bytesPerLine() y planeCount().

const uchar *QVideoFrame::bits(int plane) const

Devuelve un puntero al inicio del búfer de datos de trama para un plane.

Este valor sólo es válido mientras los datos de la trama son mapped.

Si el búfer no fue mapeado con acceso de lectura, el contenido de este búfer estará inicialmente sin inicializar.

Véase también map(), mappedBytes(), bytesPerLine(), y planeCount().

int QVideoFrame::bytesPerLine(int plane) const

Devuelve el número de bytes en una línea de exploración de un plane.

Este valor sólo es válido mientras los datos de la trama sean mapped.

Véase también bits(), map(), mappedBytes() y planeCount().

qint64 QVideoFrame::endTime() const

Devuelve el tiempo de presentación (en microsegundos) cuando un fotograma debe dejar de mostrarse.

Un tiempo no válido se representa como -1.

Véase también setEndTime().

QVideoFrame::HandleType QVideoFrame::handleType() const

Devuelve el tipo de manejador de un fotograma de vídeo.

El tipo de manejador puede ser NoHandle, lo que significa que el fotograma está basado en memoria, o una textura RHI.

int QVideoFrame::height() const

Devuelve la altura de un fotograma de vídeo.

bool QVideoFrame::isMapped() const

Identifica si el contenido de un fotograma de vídeo está actualmente asignado a la memoria del sistema.

Se trata de una función práctica que comprueba que MapMode del fotograma no es igual a QVideoFrame::NotMapped.

Devuelve true si el contenido del fotograma de vídeo está mapeado en la memoria del sistema, y false en caso contrario.

Véase también mapMode() y QVideoFrame::MapMode.

bool QVideoFrame::isReadable() const

Identifica si el contenido mapeado de un fotograma de vídeo se leyó del fotograma cuando se mapeó.

Se trata de una función práctica que comprueba si MapMode contiene el indicador QVideoFrame::WriteOnly.

Devuelve true si el contenido de la memoria mapeada se leyó del fotograma de vídeo, y false en caso contrario.

Véase también mapMode() y QVideoFrame::MapMode.

bool QVideoFrame::isValid() const

Identifica si un fotograma de vídeo es válido.

Un fotograma no válido no tiene ningún búfer de vídeo asociado.

Devuelve true si el fotograma es válido, y false si no lo es.

bool QVideoFrame::isWritable() const

Identifica si el contenido mapeado de un fotograma de vídeo se mantendrá cuando el fotograma se desmapee.

Se trata de una función práctica que comprueba si MapMode contiene el indicador QVideoFrame::WriteOnly.

Devuelve true si el fotograma de vídeo se actualizará cuando se desmapee, y false en caso contrario.

Véase también mapMode() y QVideoFrame::MapMode.

bool QVideoFrame::map(QVideoFrame::MapMode mode)

Asigna el contenido de un fotograma de vídeo a la memoria del sistema (direccionable por la CPU).

En algunos casos, los datos del fotograma de vídeo pueden estar almacenados en la memoria de vídeo o en otra memoria inaccesible, por lo que es necesario mapear un fotograma antes de acceder a los datos de píxeles. Esto puede implicar copiar el contenido, así que evite mapear y desmapear a menos que sea necesario.

El mapa mode indica si el contenido de la memoria mapeada debe leerse y/o escribirse en el fotograma. Si el modo de mapeo incluye la bandera QVideoFrame::ReadOnly la memoria mapeada será poblada con el contenido del cuadro de video cuando sea mapeado inicialmente. Si el modo de mapeo incluye la bandera QVideoFrame::WriteOnly, el contenido de la memoria mapeada posiblemente modificada se escribirá de nuevo en el cuadro cuando se desmapee.

Mientras está mapeado, se puede acceder directamente al contenido de un fotograma de vídeo a través del puntero devuelto por la función bits().

Cuando el acceso a los datos ya no sea necesario, asegúrese de llamar a la función unmap() para liberar la memoria mapeada y posiblemente actualizar el contenido del fotograma de vídeo.

Si el fotograma de vídeo ha sido mapeado en modo de sólo lectura, es permisible mapearlo múltiples veces en modo de sólo lectura (y desmapearlo un número correspondiente de veces). En todos los demás casos, es necesario desmapear el cuadro antes de mapearlo por segunda vez.

Devuelve true si el marco fue mapeado a la memoria en el mode dado y false en caso contrario.

Véase también unmap(), mapMode(), y bits().

QVideoFrame::MapMode QVideoFrame::mapMode() const

Devuelve el modo en que un fotograma de vídeo fue asignado a la memoria del sistema.

Véase también map() y QVideoFrame::MapMode.

int QVideoFrame::mappedBytes(int plane) const

Devuelve el número de bytes ocupados por el plano plane de los datos de trama mapeados.

Este valor sólo es válido mientras los datos de trama sean mapped.

Véase también map().

bool QVideoFrame::mirrored() const

Devuelve si el fotograma debe reflejarse alrededor de su eje vertical antes de mostrarse.

Las transformaciones de QVideoFrame, en concreto la rotación y el reflejo, sólo se utilizan para mostrar el fotograma de vídeo y se aplican sobre la transformación de la superficie, que viene determinada por QVideoFrameFormat. El reflejo se aplica después de la rotación.

El mirroring suele ser necesario para los fotogramas de vídeo procedentes de la cámara frontal de un dispositivo móvil.

Véase también setMirrored().

void QVideoFrame::paint(QPainter *painter, const QRectF &rect, const QVideoFrame::PaintOptions &options)

Utiliza un QPainter, painter, para renderizar este QVideoFrame a rect. El PaintOptions options se puede utilizar para especificar un color de fondo y cómo rect debe ser llenado con el vídeo.

QVideoFrameFormat::PixelFormat QVideoFrame::pixelFormat() const

Devuelve el formato de píxel de este fotograma de vídeo.

int QVideoFrame::planeCount() const

Devuelve el número de planos del fotograma de vídeo.

Véase también map().

QtVideo::Rotation QVideoFrame::rotation() const

Devuelve el ángulo en el que debe girarse el fotograma en el sentido de las agujas del reloj antes de mostrarlo.

Las transformaciones de QVideoFrame, concretamente la rotación y el reflejo, sólo se utilizan para mostrar el fotograma de vídeo y se aplican sobre la transformación de la superficie, que viene determinada por QVideoFrameFormat. La rotación se aplica antes que el reflejo.

Véase también setRotation().

void QVideoFrame::setEndTime(qint64 time)

Establece la presentación time (en microsegundos) cuando un fotograma debe dejar de mostrarse.

Un tiempo no válido se representa como -1.

Véase también endTime().

void QVideoFrame::setMirrored(bool mirrored)

Establece si el fotograma debe ser mirrored alrededor de su eje vertical antes de ser mostrado.

Las transformaciones de QVideoFrame, concretamente la rotación y el reflejo, sólo se utilizan para mostrar el fotograma de vídeo y se aplican sobre la transformación de la superficie, que viene determinada por QVideoFrameFormat. El reflejo se aplica después de la rotación.

El reflejo suele ser necesario para los fotogramas de vídeo procedentes de la cámara frontal de un dispositivo móvil.

El valor por defecto es false.

Véase también mirrored().

void QVideoFrame::setRotation(QtVideo::Rotation angle)

Establece en angle que el fotograma debe girarse en el sentido de las agujas del reloj antes de mostrarse.

Las transformaciones de QVideoFrame, concretamente la rotación y el reflejo, sólo se utilizan para mostrar el fotograma de vídeo y se aplican sobre la transformación de la superficie, que viene determinada por QVideoFrameFormat. La rotación se aplica antes que el reflejo.

El valor por defecto es QtVideo::Rotation::None.

Véase también rotation().

void QVideoFrame::setStartTime(qint64 time)

Establece la presentación time (en microsegundos) cuando el fotograma debe mostrarse inicialmente.

Un tiempo no válido se representa como -1.

Véase también startTime().

void QVideoFrame::setStreamFrameRate(qreal rate)

Establece los fotogramas rate de un flujo de vídeo en fotogramas por segundo.

Véase también streamFrameRate().

void QVideoFrame::setSubtitleText(const QString &text)

Establece el texto de los subtítulos que debe ser renderizado junto con este fotograma de vídeo en text.

Véase también subtitleText().

QSize QVideoFrame::size() const

Devuelve las dimensiones de un fotograma de vídeo.

qint64 QVideoFrame::startTime() const

Devuelve el tiempo de presentación (en microsegundos) en que debe mostrarse el fotograma.

Un tiempo no válido se representa como -1.

Véase también setStartTime().

qreal QVideoFrame::streamFrameRate() const

Devuelve la frecuencia de imagen de un flujo de vídeo en fotogramas por segundo.

Véase también setStreamFrameRate().

QString QVideoFrame::subtitleText() const

Devuelve el texto de los subtítulos que debe ser renderizado junto con este fotograma de vídeo.

Véase también setSubtitleText().

QVideoFrameFormat QVideoFrame::surfaceFormat() const

Devuelve el formato de superficie de este fotograma de vídeo.

[noexcept] void QVideoFrame::swap(QVideoFrame &other)

Intercambia el fotograma de vídeo actual con other.

QImage QVideoFrame::toImage() const

Convierte el fotograma de vídeo actual en imagen.

La conversión se basa en los datos de píxeles actuales y en surface format. Las transformaciones del fotograma no afectan al resultado, ya que sólo se aplican para la presentación.

void QVideoFrame::unmap()

Libera la memoria mapeada por la función map().

Si MapMode incluyó la bandera QVideoFrame::WriteOnly esto persistirá el contenido actual de la memoria mapeada al cuadro de video.

unmap() no debe ser llamada si la función map() ha fallado.

Véase también map().

int QVideoFrame::width() const

Devuelve la anchura de un fotograma de vídeo.

bool QVideoFrame::operator!=(const QVideoFrame &other) const

Devuelve true si este QVideoFrame y other no reflejan el mismo marco.

[noexcept] QVideoFrame &QVideoFrame::operator=(QVideoFrame &&other)

Mueve other en este QVideoFrame.

QVideoFrame &QVideoFrame::operator=(const QVideoFrame &other)

Asigna el contenido de other a este fotograma de vídeo. Dado que QVideoFrame se comparte explícitamente, estas dos instancias reflejarán el mismo fotograma.

bool QVideoFrame::operator==(const QVideoFrame &other) const

Devuelve true si este QVideoFrame y other reflejan el mismo marco.