ImageCapture QML Type

Eine Schnittstelle zur Erfassung von Kamerabildern. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

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

Signale

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

Methoden

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

Detaillierte Beschreibung

Mit diesem Typ können Sie Standbilder erfassen und benachrichtigt werden, wenn sie verfügbar sind oder auf der Festplatte gespeichert werden.

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

Eigenschaft Dokumentation

error : enumeration [read-only]

Diese Eigenschaft enthält den zuletzt aufgetretenen Fehlertyp. Sie kann eine der folgenden sein.

Siehe auch errorString.

errorString : string [read-only]

Diese Eigenschaft enthält die zuletzt aufgetretene Fehlermeldung.

Siehe auch error.

fileFormat : enumeration

Diese Eigenschaft enthält das Dateiformat, in das das Bild geschrieben wird. Es kann eines der folgenden sein.

metaData : mediaMetaData

Diese Eigenschaft enthält die Metadaten, die in das Bild eingebettet werden sollen.

preview : string [read-only]

Diese Eigenschaft enthält eine URL zu dem zuletzt aufgenommenen Bild. Sie kann mit der Quelleigenschaft eines Image Elements verbunden werden, um das zuletzt aufgenommene Bild anzuzeigen.

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

Siehe auch saveToFile.

quality : enumeration

Diese Eigenschaft enthält den Hinweis auf die Qualität beim Speichern des aufgenommenen Bildes. Sie kann einen der folgenden Werte annehmen.

readyForCapture : bool [read-only]

Diese Eigenschaft enthält einen boolschen Wert, der angibt, ob die Kamera bereit ist, Fotos aufzunehmen oder nicht.

Der Aufruf von capture() oder captureToFile(), während bereit false ist, ist nicht zulässig und führt zu einem Fehler.

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

Enthält eine Liste der unterstützten Dateiformate.

Diese Eigenschaft wurde in Qt 6.10 eingeführt.

Siehe auch fileFormat.

Signal-Dokumentation

errorOccurred(id, error, errorString)

Dieses Signal wird ausgegeben, wenn bei der Erfassung mit der angeforderten id ein Fehler auftritt. error ist eine Aufzählung des Typs ImageCapture::Error. Eine beschreibende Meldung ist in errorString verfügbar.

Siehe auch error und errorString.

imageCaptured(requestId, preview)

Dieses Signal wird ausgegeben, wenn ein Bild mit der angeforderten ID requestId erfasst, aber noch nicht im Dateisystem gespeichert wurde. Der Parameter preview ist das erfasste Bild.

Siehe auch imageSaved und preview.

imageMetadataAvailable(id, metaData)

Dieses Signal wird ausgegeben, wenn das Bild mit dem angeforderten id neue metaData hat.

Siehe auch imageCaptured.

imageSaved(id, fileName)

Dieses Signal wird ausgegeben, nachdem das Bild mit dem angeforderten id in das Dateisystem geschrieben wurde. Die fileName ist ein lokaler Dateipfad, keine URL.

Siehe auch imageCaptured.

Dokumentation der Methode

int capture()

Starten Sie die Bildaufnahme. Die Signale imageCaptured und imageSaved werden ausgegeben, wenn die Erfassung abgeschlossen ist.

Das erfasste Bild ist über die Eigenschaft Vorschau verfügbar und kann als Quelle für ein QML-Image-Element verwendet werden. Die Methode saveToFile() kann dann zum Speichern des Bildes verwendet werden.

Camera speichert alle Aufnahmeparameter wie Belichtungseinstellungen oder Bildverarbeitungsparameter, so dass Änderungen an den Kameraparametern nach dem Aufruf von capture() keine Auswirkungen auf frühere Aufnahmeanforderungen haben.

capture() gibt den Parameter capture requestId zurück, der mit den Signalen imageExposed(), imageCaptured(), imageMetadataAvailable() und imageSaved() verwendet wird.

Siehe auch readyForCapture und preview.

int captureToFile(location)

Führt die gleiche Funktion aus wie capture(), speichert aber zusätzlich das erfasste Bild automatisch auf dem angegebenen location. Gibt den Parameter capture requestId zurück.

Siehe auch capture().

void saveToFile(location)

Speichert das zuletzt aufgenommene Bild auf location.

Siehe auch capture und preview.