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
| Constante | Valor | Descripción |
|---|---|---|
QImageCapture::NoError | 0 | Sin errores. |
QImageCapture::NotReadyError | 1 | El servicio aún no está listo para la captura. |
QImageCapture::ResourceError | 2 | El dispositivo no está listo o no está disponible. |
QImageCapture::OutOfSpaceError | 3 | No queda espacio libre en el dispositivo. |
QImageCapture::NotSupportedFeatureError | 4 | El dispositivo no admite la captura de imágenes fijas. |
QImageCapture::FormatError | 5 | El formato actual no es compatible. |
enum QImageCapture::FileFormat
Elige uno de los siguientes formatos de imagen:
| Constante | Valor | Descripción |
|---|---|---|
QImageCapture::UnspecifiedFormat | 0 | Sin formato especificado |
QImageCapture::JPEG | 1 | .jpg o formato « .jpeg » |
QImageCapture::PNG | 2 | .png formato |
QImageCapture::WebP | 3 | .webp formato |
QImageCapture::Tiff | 4 | .tiff formato |
enum QImageCapture::Quality
Enumera los niveles de codificación de calidad.
| Constante | Valor |
|---|---|
QImageCapture::VeryLowQuality | 0 |
QImageCapture::LowQuality | 1 |
QImageCapture::NormalQuality | 2 |
QImageCapture::HighQuality | 3 |
QImageCapture::VeryHighQuality | 4 |
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.