QImageCapture Class

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

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

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

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

Documentación de las funciones miembro

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

Construye un objeto de captura de imágenes, a partir de un parent, que puede capturar imágenes fijas individuales producidas por una cámara.

Debe conectar tanto un objeto de captura de imágenes como un QCamera a una sesión de captura para capturar imágenes.

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

Destruye el objeto de captura de imágenes.

void QImageCapture::addMetaData(const QMediaMetaData &metaData)

Añade metaData adicionales a cualquier metadato existente, que esté incrustado en la imagen capturada.

[slot] int QImageCapture::capture()

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

QImageCapture::capture devuelve el parámetro Id de captura, utilizado 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 una sesión de captura.

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

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

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

Si se pasa un file vacío, el back-end de la cámara elige la ubicación por defecto y el esquema de nomenclatura para las fotos en el sistema, si sólo se especifica el nombre de archivo sin la ruta completa, la imagen se guardará en el directorio por defecto, con una ruta completa informada con las señales imageCaptured() y imageSaved().

QCamera guarda todos los parámetros de captura, como los ajustes de exposición o los parámetros de procesamiento de imagen, de modo que los cambios en los parámetros de la cámara después de llamar a capture() no afectan a las solicitudes de captura anteriores.

QImageCapture::capture devuelve el parámetro Id de captura, utilizado 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)

Señala que la solicitud de captura id ha fallado con una descripción error y errorString.

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

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

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

Devuelve el nombre del formato dado, f.

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

Señal emitida cuando el frame con solicitud id está disponible.

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

Señal emitida cuando el fotograma con la petición id ha sido capturado, pero aún no ha sido procesado ni guardado. La imagen preview puede mostrarse al usuario.

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

Señal emitida cuando el marco con la solicitud id fue expuesto.

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

Señala que una imagen identificada por id tiene metaData.

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

Señal emitida cuando se establece QImageCapture::CaptureToFile y el fotograma con la solicitud id se guardó 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)

Señala que el estado ready para captura de una cámara ha cambiado.

QSize QImageCapture::resolution() const

Devuelve la resolución de la imagen codificada.

Véase también setResolution().

[signal] void QImageCapture::resolutionChanged()

Señala cuando cambia la resolución de la imagen.

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

Establece la imagen format.

Asignar una FileFormat no soportada no tiene ningún efecto.

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

void QImageCapture::setMetaData(const QMediaMetaData &metaData)

Sustituye los metadatos existentes, que se incrustarán en la imagen capturada, por un conjunto de metaData.

Véase también metaData().

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

Establece la codificación de la imagen quality.

Véase también quality().

void QImageCapture::setResolution(const QSize &resolution)

Establece el resolution de la imagen codificada.

Un QSize vacío indica que el codificador debe hacer una elección óptima basada en lo que está disponible en la fuente de la imagen y las limitaciones del códec.

Véase también resolution().

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

Establece width y height de la resolución de la imagen codificada.

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

Devuelve una lista de los formatos de archivo soportados.

Véase también FileFormat.