En esta página

ImageCapture QML Type

Una interfaz para capturar imágenes de la cámara. Más...

Import Statement: import QtMultimedia

Propiedades

Señales

Métodos

Descripción detallada

Este tipo te permite capturar imágenes fijas y recibir una notificación cuando estén disponibles o se guarden en el disco.

Item {
    width: 640
    height: 360

    CaptureSession {
        imageCapture : ImageCapture {
            id: imageCapture
        }
        camera: Camera {
            id: camera
        }

        videoOutput: videoOutput
    }
    VideoOutput {
        id: videoOutput
        anchors.fill: parent

        MouseArea {
            anchors.fill: parent;
            onClicked: imageCapture.capture();
        }
    }

    Image {
        id: photoPreview
        source: imageCapture.preview // always shows the last captured image
    }
}

Documentación de propiedades

error : enumeration [read-only]

Esta propiedad contiene el tipo del último error que se ha producido. Puede ser uno de los siguientes.

ConstanteDescripción
ImageCapture.NoErrorNo hay errores.
ImageCapture.NotReadyErrorEl servicio aún no está listo para la captura.
ImageCapture.ResourceErrorEl dispositivo no está listo o no está disponible.
ImageCapture.OutOfSpaceErrorNo queda espacio libre en el dispositivo.
ImageCapture.NotSupportedFeatureErrorEl dispositivo no admite la captura de imágenes fijas.
ImageCapture.FormatErrorEl formato actual no es compatible.

Véase también errorString.

errorString : string [read-only]

Esta propiedad contiene el último mensaje de error que se ha producido.

Véase también error.

fileFormat : enumeration

Esta propiedad indica el formato de archivo en el que se guardará la imagen. Puede ser uno de los siguientes.

ConstanteDescripción
UnspecifiedFormatSin formato especificado
JPEG.jpg o formato « .jpeg »
PNG.png formato
WebP.webp formato
Tiff.tiff formato

metaData : mediaMetaData

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

preview : string [read-only]

Esta propiedad contiene una URL que apunta a la última imagen capturada. Se puede vincular a la propiedad «source» de un elemento Image para mostrar la última imagen capturada.

CaptureSession {
    camera: Camera {}
    imageCapture: ImageCapture {
        id: capture
    }
}
Image {
    source: capture.preview
}

Véase también saveToFile.

quality : enumeration

Esta propiedad almacena la información sobre la calidad al guardar la imagen capturada. Puede adoptar uno de los siguientes valores.

ConstanteDescripción
VeryLowQualityMuy baja
LowQualityBajo
NormalQualityNormal
HighQualityAlto
VeryHighQualityMuy alto

readyForCapture : bool [read-only]

Esta propiedad contiene un valor booleano que indica si la cámara está lista para hacer fotos o no.

No está permitido llamar a ` capture()` o ` captureToFile()` cuando `ready` es ` false `, y ello da lugar a un error.

supportedFormats : list<FileFormat> [read-only, since 6.10]

Contiene una lista de los formatos de archivo compatibles.

Esta propiedad se introdujo en Qt 6.10.

Véase también fileFormat.

Documentación sobre señales

errorOccurred(id, error, errorString)

Esta señal se emite cuando se produce un error durante la captura con id. error es una enumeración de tipo ImageCapture::Error. Hay un mensaje descriptivo disponible en errorString.

Nota: El controlador correspondiente es ` onErrorOccurred`.

Véase también error y errorString.

imageCaptured(requestId, preview)

Esta señal se emite cuando se ha capturado una imagen con el identificador solicitado requestId, pero aún no se ha guardado en el sistema de archivos. El parámetro preview es la imagen capturada.

Nota: El controlador correspondiente es onImageCaptured.

Véase también imageSaved y preview.

imageMetadataAvailable(id, metaData)

Esta señal se emite cuando la imagen con el id solicitado tiene un nuevo metaData.

Nota: El controlador correspondiente es onImageMetadataAvailable.

Véase también imageCaptured.

imageSaved(id, fileName)

Esta señal se emite una vez que la imagen con la dirección id solicitada se ha guardado en el sistema de archivos. La dirección fileName es una ruta de archivo local, no una URL.

Nota: El controlador correspondiente es onImageSaved.

Véase también imageCaptured.

Documentación del método

int capture()

Iniciar la captura de la imagen. Las señales « imageCaptured » y « imageSaved » se emitirán cuando finalice la captura.

La imagen capturada estará disponible a través de la propiedad «preview», que puede utilizarse como fuente para un elemento «Image» de QML. A continuación, se puede utilizar el método « saveToFile()» para guardar la imagen.

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

`capture()` devuelve el parámetro `requestId` de la captura, que se utiliza con las señales `imageExposed()`, ` imageCaptured()`, ` imageMetadataAvailable()` y ` imageSaved()`.

Véanse también « readyForCapture » y « preview ».

int captureToFile(location)

Realiza lo mismo que capture(), pero además guarda automáticamente la imagen capturada en la dirección especificada location. Devuelve el parámetro «requestId» de la captura.

Véase también capture().

void saveToFile(location)

Guarda la última imagen capturada en location.

Véase también capture y preview.

© 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.