En esta página

QImageCapture Class

La clase QImageCapture se utiliza para grabar contenido multimedia. Más información...

Encabezado: #include <QImageCapture>
CMake: find_package(Qt6 REQUIRED COMPONENTS Multimedia)
target_link_libraries(mytarget PRIVATE Qt6::Multimedia)
qmake: QT += multimedia
Heredado de: QObject

Tipos públicos

enum Error { NoError, NotReadyError, ResourceError, OutOfSpaceError, NotSupportedFeatureError, FormatError }
enum FileFormat { UnspecifiedFormat, JPEG, PNG, WebP, Tiff }
enum Quality { VeryLowQuality, LowQuality, NormalQuality, HighQuality, VeryHighQuality }

Propiedades

Funciones públicas

QImageCapture(QObject *parent = nullptr)
virtual ~QImageCapture() override
void addMetaData(const QMediaMetaData &metaData)
QMediaCaptureSession *captureSession() const
QImageCapture::Error error() const
QString errorString() const
QImageCapture::FileFormat fileFormat() const
bool isAvailable() const
bool isReadyForCapture() const
QMediaMetaData metaData() const
QImageCapture::Quality quality() const
QSize resolution() const
void setFileFormat(QImageCapture::FileFormat format)
void setMetaData(const QMediaMetaData &metaData)
void setQuality(QImageCapture::Quality quality)
void setResolution(const QSize &resolution)
void setResolution(int width, int height)

Ranuras públicas

int capture()
int captureToFile(const QString &file = QString())

Señales

void errorChanged()
void errorOccurred(int id, QImageCapture::Error error, const QString &errorString)
void fileFormatChanged()
void imageAvailable(int id, const QVideoFrame &frame)
void imageCaptured(int id, const QImage &preview)
void imageExposed(int id)
void imageMetadataAvailable(int id, const QMediaMetaData &metaData)
void imageSaved(int id, const QString &fileName)
void metaDataChanged()
void qualityChanged()
void readyForCaptureChanged(bool ready)
void resolutionChanged()

Miembros públicos estáticos

QString fileFormatDescription(QImageCapture::FileFormat f)
QString fileFormatName(QImageCapture::FileFormat f)
QList<QImageCapture::FileFormat> supportedFormats()

Descripción detallada

La clase QImageCapture es una clase de alto nivel para la grabación de imágenes. No está pensada para utilizarse de forma independiente, sino para acceder a las funciones de grabación multimedia de otros objetos multimedia, como QCamera.

QMediaCaptureSession captureSession;
camera = new QCamera;
captureSession.setCamera(camera);

viewfinder = new QVideoWidget;
viewfinder->show();
captureSession.setVideoOutput(viewfinder);

imageCapture = new QImageCapture;
captureSession.setImageCapture(imageCapture);

camera->start();
// on shutter button pressed
imageCapture->capture();

Véase también QCamera.

Documentación sobre los tipos de miembros

enum QImageCapture::Error

ConstanteValorDescripción
QImageCapture::NoError0Sin errores.
QImageCapture::NotReadyError1El servicio aún no está listo para la captura.
QImageCapture::ResourceError2El dispositivo no está listo o no está disponible.
QImageCapture::OutOfSpaceError3No queda espacio libre en el dispositivo.
QImageCapture::NotSupportedFeatureError4El dispositivo no admite la captura de imágenes fijas.
QImageCapture::FormatError5El formato actual no es compatible.

enum QImageCapture::FileFormat

Elige uno de los siguientes formatos de imagen:

ConstanteValorDescripción
QImageCapture::UnspecifiedFormat0Sin formato especificado
QImageCapture::JPEG1.jpg o formato « .jpeg »
QImageCapture::PNG2.png formato
QImageCapture::WebP3.webp formato
QImageCapture::Tiff4.tiff formato

enum QImageCapture::Quality

Enumera los niveles de codificación de calidad.

ConstanteValor
QImageCapture::VeryLowQuality0
QImageCapture::LowQuality1
QImageCapture::NormalQuality2
QImageCapture::HighQuality3
QImageCapture::VeryHighQuality4

Documentación de la propiedad

[read-only] error : Error

Devuelve el estado de error actual.

Funciones de acceso:

QImageCapture::Error error() const

Señal del notificador:

void errorChanged()

Véase también errorString().

[read-only] errorString : QString

Devuelve una cadena que describe el estado de error actual.

Funciones de acceso:

QString errorString() const

Señal de notificación:

void errorChanged()

Véase también error().

fileFormat : FileFormat

Esta propiedad indica el formato de la imagen.

Funciones de acceso:

QImageCapture::FileFormat fileFormat() const
void setFileFormat(QImageCapture::FileFormat format)

Señal de notificación:

void fileFormatChanged()

metaData : QMediaMetaData

Esta propiedad contiene los metadatos que se incrustarán en la imagen.

Nota: El back-end de la cámara puede añadir camposadicionales , como una marca de tiempo o la ubicación.

Funciones de acceso:

QMediaMetaData metaData() const
void setMetaData(const QMediaMetaData &metaData)

Señal de notificación:

void metaDataChanged()

quality : Quality

Esta propiedad indica la calidad de codificación de la imagen.

Funciones de acceso:

QImageCapture::Quality quality() const
void setQuality(QImageCapture::Quality quality)

Señal de notificación:

void qualityChanged()

[read-only] readyForCapture : bool

Mantiene el valor ` true ` si la cámara está lista para capturar una imagen de forma inmediata. No está permitido llamar a ` capture()` mientras ` readyForCapture ` tiene el valor ` false `, lo que da lugar a un error.

Funciones de acceso:

bool isReadyForCapture() const

Señal de notificación:

void readyForCaptureChanged(bool ready)

[read-only] supportedFormats : const QList<FileFormat>

Esta propiedad contiene una lista de los formatos de archivo compatibles.

Funciones de acceso:

QList<QImageCapture::FileFormat> supportedFormats()

Documentación de las funciones de miembro

[explicit] QImageCapture::QImageCapture(QObject *parent = nullptr)

Crea un objeto de captura de imágenes, a partir de un ` parent`, que permite capturar imágenes fijas individuales generadas por una cámara.

Para capturar imágenes, es necesario conectar tanto un objeto de captura de imágenes como un « QCamera » a una sesión de captura.

[override virtual noexcept] QImageCapture::~QImageCapture()

Elimina el objeto de captura de imágenes.

void QImageCapture::addMetaData(const QMediaMetaData &metaData)

Añade información adicional sobre el « metaData » a cualquier metadato existente que esté incrustado en la imagen capturada.

[slot] int QImageCapture::capture()

Captura la imagen y la pone a disposición como un objeto ` QImage`. Esta operación es asíncrona en la mayoría de los casos, y va seguida de las señales ` QImageCapture::imageExposed()`, ` QImageCapture::imageCaptured()` o ` QImageCapture::error()`.

QImageCapture::capture devuelve el parámetro «capture Id», que se utiliza con las señales imageExposed(), imageCaptured() y imageSaved().

Véase también isReadyForCapture().

QMediaCaptureSession *QImageCapture::captureSession() const

Devuelve la sesión de captura a la que está conectada esta cámara, o un `nullptr` si la cámara no está conectada a ninguna sesión de captura.

Utiliza QMediaCaptureSession::setImageCapture() para conectar la captura de imágenes a una sesión.

[slot] int QImageCapture::captureToFile(const QString &file = QString())

Captura la imagen y guárdala en file. Esta operación es asíncrona en la mayoría de los casos, y va seguida de las señales QImageCapture::imageExposed(), QImageCapture::imageCaptured(), QImageCapture::imageSaved() o QImageCapture::error().

Si se pasa un objeto file vacío, el back-end de la cámara elige la ubicación y el esquema de nomenclatura predeterminados para las fotos en el sistema; si solo se especifica el nombre del archivo sin la ruta completa, la imagen se guardará en el directorio predeterminado, y la ruta completa se indicará mediante las señales imageCaptured(), imageSaved() y ().

QCamera Guarda todos los parámetros de captura, como los ajustes de exposición o los parámetros de procesamiento de imágenes, de modo que los cambios en los parámetros de la cámara tras llamar a ` capture()` no afectan a las solicitudes de captura anteriores.

QImageCapture::capture Devuelve el parámetro de ID de captura, que se utiliza con las señales imageExposed(), imageCaptured() y imageSaved().

Véase también isReadyForCapture().

[signal] void QImageCapture::errorOccurred(int id, QImageCapture::Error error, const QString &errorString)

Indica que la solicitud de captura id ha fallado, con una descripción de error y errorString.

[static] QString QImageCapture::fileFormatDescription(QImageCapture::FileFormat f)

Devuelve la descripción del formato de archivo indicado, f.

[static] QString QImageCapture::fileFormatName(QImageCapture::FileFormat f)

Devuelve el nombre del formato indicado: f.

[signal] void QImageCapture::imageAvailable(int id, const QVideoFrame &frame)

Se emite esta señal cuando está disponible el frame con la solicitud id.

[signal] void QImageCapture::imageCaptured(int id, const QImage &preview)

Se emite esta señal cuando se ha capturado la trama con la solicitud id, pero aún no se ha procesado ni guardado. La trama preview puede mostrarse al usuario.

[signal] void QImageCapture::imageExposed(int id)

Señal emitida cuando se ha expuesto el fotograma con la solicitud « id ».

[signal] void QImageCapture::imageMetadataAvailable(int id, const QMediaMetaData &metaData)

Indica que una imagen identificada por id tiene metaData.

[signal] void QImageCapture::imageSaved(int id, const QString &fileName)

Se emite esta señal cuando se ejecuta QImageCapture::CaptureToFile y el fotograma con la solicitud id se ha guardado en fileName.

bool QImageCapture::isAvailable() const

Devuelve «true» si el servicio de captura de imágenes está listo para su uso.

[signal] void QImageCapture::readyForCaptureChanged(bool ready)

Indica que el estado de captura de la propiedad « ready » de una cámara ha cambiado.

Nota: Señalde notificación para la propiedad « readyForCapture ».

QSize QImageCapture::resolution() const

Devuelve la resolución de la imagen codificada.

Véase también setResolution().

[signal] void QImageCapture::resolutionChanged()

Avisa cuando cambia la resolución de la imagen.

void QImageCapture::setFileFormat(QImageCapture::FileFormat format)

Establece la imagen format.

Asignar un valor no compatible a « FileFormat » no tiene ningún efecto.

Nota: Funciónde asignación para la propiedad fileFormat.

Véase también ` fileFormat()` y ` supportedFormats`.

void QImageCapture::setMetaData(const QMediaMetaData &metaData)

Sustituye cualquier metadato existente, que se vaya a incrustar en la imagen capturada, por un conjunto de metaData.

Nota: Funciónde asignación para la propiedad metaData.

Véase también metaData().

void QImageCapture::setQuality(QImageCapture::Quality quality)

Establece la codificación de la imagen quality.

Nota: Funciónde asignación para la propiedad quality.

Véase también quality().

void QImageCapture::setResolution(const QSize &resolution)

Establece el valor de « resolution » de la imagen codificada.

Un ` QSize ` vacío indica que el codificador debe tomar la decisión óptima en función de lo que esté disponible en la fuente de la imagen y de las limitaciones del códec.

Véase también resolution().

void QImageCapture::setResolution(int width, int height)

Establece las propiedades « width » y « height » de la resolución de la imagen codificada.

Esta es una función sobrecargada.

[static] QList<QImageCapture::FileFormat> QImageCapture::supportedFormats()

Devuelve una lista de los formatos de archivo compatibles.

Nota: Funcióngetter para la propiedad supportedFormats.

Véase también FileFormat.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.