ImageCapture QML Type

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

• Lista de todos los miembros, incluidos los heredados

Propiedades

• error : enumeration
• errorString : string
• fileFormat : enumeration
• metaData : mediaMetaData
• preview : string
• quality : enumeration
• readyForCapture : bool
• supportedFormats : list<FileFormat> (since 6.10)

Señales

• errorOccurred(id, error, errorString)
• imageCaptured(requestId, preview)
• imageMetadataAvailable(id, metaData)
• imageSaved(id, fileName)

Métodos

• int capture()
• int captureToFile(location)
• void saveToFile(location)

Descripción detallada

Este tipo permite capturar imágenes fijas y recibir notificaciones cuando están disponibles o guardadas en 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 último tipo de error que se ha producido. Puede ser uno de los siguientes

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 contiene el formato de archivo para el que se escribirá la imagen. Puede ser uno de los siguientes

metaData : mediaMetaData

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

preview : string [read-only]

Esta propiedad contiene una url a la última imagen capturada. Puede conectarse 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 contiene la sugerencia de calidad al almacenar la imagen capturada. Puede ser uno de los siguientes valores

readyForCapture : bool [read-only]

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

Llamar a capture() o captureToFile() mientras ready es false no está permitido y produce un error.

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

Contiene una lista de formatos de archivo soportados.

Esta propiedad se introdujo en Qt 6.10.

Véase también fileFormat.

Documentación de señales

errorOccurred(id, error, errorString)

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

Véase también error y errorString.

imageCaptured(requestId, preview)

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

Véase también imageSaved y preview.

imageMetadataAvailable(id, metaData)

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

Véase también imageCaptured.

imageSaved(id, fileName)

Esta señal se emite después de que la imagen con la dirección id solicitada se haya escrito en el sistema de archivos. fileName es una ruta de archivo local, no una URL.

Véase también imageCaptured.

Documentación del método

int capture()

Inicia la captura de imágenes. 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 ser utilizada como fuente para un elemento QML Image. El método saveToFile() puede ser utilizado 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 la imagen, por lo 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.

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

Véase también readyForCapture y preview.

int captureToFile(location)

Hace lo mismo que capture() pero además guarda automáticamente la imagen capturada en el location especificado. 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.