ImageCapture QML Type

Une interface pour capturer les images de l'appareil photo. Plus d'informations...

• Liste de tous les membres, y compris les membres hérités

Propriétés

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

Signaux

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

Méthodes

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

Description détaillée

Ce type permet de capturer des images fixes et d'être informé de leur disponibilité ou de leur enregistrement sur le disque.

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
    }
}

Propriété Documentation

error : enumeration [read-only]

Cette propriété contient le dernier type d'erreur qui s'est produit. Il peut s'agir de l'un des éléments suivants

Voir aussi errorString.

errorString : string [read-only]

Cette propriété contient le dernier message d'erreur qui s'est produit.

Voir aussi error.

fileFormat : enumeration

Cette propriété indique le format de fichier dans lequel l'image sera écrite. Il peut s'agir de l'un des formats suivants

metaData : mediaMetaData

Cette propriété contient les métadonnées qui seront intégrées dans l'image.

preview : string [read-only]

Cette propriété contient l'url de la dernière image capturée. Elle peut être connectée à la propriété source d'un élément Image pour afficher la dernière image capturée.

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

Voir aussi saveToFile.

quality : enumeration

Cette propriété contient l'indice de qualité lors du stockage de l'image capturée. Elle peut prendre l'une des valeurs suivantes.

readyForCapture : bool [read-only]

Cette propriété contient une valeur bool indiquant si l'appareil photo est prêt à prendre des photos ou non.

L'appel à capture() ou captureToFile() alors que ready est false n'est pas autorisé et entraîne une erreur.

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

Contient une liste des formats de fichiers pris en charge.

Cette propriété a été introduite dans Qt 6.10.

Voir aussi fileFormat.

Documentation sur les signaux

errorOccurred(id, error, errorString)

Ce signal est émis lorsqu'une erreur se produit pendant la capture avec la demande id. error est une énumération de type ImageCapture::Error. Un message descriptif est disponible à l'adresse errorString.

Voir également error et errorString.

imageCaptured(requestId, preview)

Ce signal est émis lorsqu'une image avec l'identifiant demandé requestId a été capturée mais n'a pas encore été enregistrée dans le système de fichiers. Le paramètre preview est l'image capturée.

Voir également imageSaved et preview.

imageMetadataAvailable(id, metaData)

Ce signal est émis lorsque l'image demandée id a un nouveau metaData.

Voir aussi imageCaptured.

imageSaved(id, fileName)

Ce signal est émis après que l'image avec la demande id a été écrite dans le système de fichiers. fileName est un chemin d'accès à un fichier local, et non une URL.

Voir aussi imageCaptured.

Documentation de la méthode

int capture()

Lancer la capture d'image. Les signaux imageCaptured et imageSaved seront émis lorsque la capture sera terminée.

L'image capturée sera disponible via la propriété de prévisualisation qui peut être utilisée comme source pour un élément QML Image. La méthode saveToFile() peut alors être utilisée pour enregistrer l'image.

La caméra enregistre tous les paramètres de capture tels que les paramètres d'exposition ou les paramètres de traitement de l'image, de sorte que les modifications apportées aux paramètres de la caméra après l'appel de capture() n'affectent pas les demandes de capture précédentes.

capture() renvoie le paramètre capture requestId, utilisé avec les signaux imageExposed(), imageCaptured(), imageMetadataAvailable() et imageSaved().

Voir également readyForCapture et preview.

int captureToFile(location)

Fait la même chose que capture() mais enregistre en plus automatiquement l'image capturée dans le répertoire spécifié location. Renvoie le paramètre requestId de la capture.

Voir également capture().

void saveToFile(location)

Enregistre la dernière image capturée sur location.

Voir également capture et preview.