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)

Ausführliche Beschreibung

Mit diesem Typ können Sie Standbilder aufnehmen und sich benachrichtigen lassen, sobald diese verfügbar sind oder auf der Festplatte gespeichert wurden.

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

Dokumentation zu den Eigenschaften

error : enumeration [read-only]

Diese Eigenschaft enthält den Typ des zuletzt aufgetretenen Fehlers. Es kann sich um einen der folgenden Typen handeln.

Siehe auch errorString.

errorString : string [read-only]

Diese Eigenschaft enthält die zuletzt aufgetretene Fehlermeldung.

Siehe auch „ error “.

fileFormat : enumeration

Diese Eigenschaft gibt das Dateiformat an, in dem das Bild gespeichert wird. Es kann einer der folgenden Werte 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 zum zuletzt aufgenommenen Bild. Sie kann mit der „source“-Eigenschaft eines „ Image “-Elements verknüpft 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 Qualitätshinweis beim Speichern des aufgenommenen Bildes. Sie kann einen der folgenden Werte annehmen.

readyForCapture : bool [read-only]

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

Der Aufruf von ` capture()` oder ` captureToFile()` ist nicht zulässig, wenn die Kamera bereit ist und ` false ` ist, 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 ausgelöst, wenn während der Erfassung mit dem angeforderten id ein Fehler auftritt. error ist eine Aufzählung vom Typ ImageCapture::Error. Eine beschreibende Meldung ist unter errorString verfügbar.

Siehe auch error und errorString.

imageCaptured(requestId, preview)

Dieses Signal wird ausgelöst, wenn ein Bild mit der angeforderten ID „ requestId “ aufgenommen, aber noch nicht im Dateisystem gespeichert wurde. Der Parameter „ preview “ ist das aufgenommene Bild.

Siehe auch „ imageSaved “ und „ preview “.

imageMetadataAvailable(id, metaData)

Dieses Signal wird ausgelöst, wenn das Bild mit der angeforderten ID „ id “ neue metaData aufweist.

Siehe auch imageCaptured.

imageSaved(id, fileName)

Dieses Signal wird ausgelöst, nachdem das Bild mit der angeforderten URL „ id “ in das Dateisystem geschrieben wurde. Die URL „ fileName “ ist ein lokaler Dateipfad, keine URL.

Siehe auch imageCaptured.

Methodendokumentation

int capture()

Starten Sie die Bildaufnahme. Die Signale „ imageCaptured “ und „ imageSaved “ werden ausgegeben, sobald die Aufnahme abgeschlossen ist.

Das aufgenommene Bild ist über die Eigenschaft „preview“ verfügbar, die als Quelle für ein QML-Image-Element verwendet werden kann. Mit der Methode „ saveToFile()“ kann das Bild anschließend gespeichert werden.

Die Kamera speichert alle Aufnahmeparameter wie Belichtungseinstellungen oder Bildverarbeitungsparameter, sodass Änderungen an den Kameraparametern nach dem Aufruf von `capture()` keinen Einfluss auf frühere Aufnahmeanfragen haben.

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

Siehe auch „ readyForCapture “ und „ preview “.

int captureToFile(location)

Führt dieselbe Aktion aus wie „ capture()“, speichert das aufgenommene Bild jedoch zusätzlich automatisch unter der angegebenen Adresse „ location “. Gibt den Parameter „capture requestId“ zurück.

Siehe auch capture().

void saveToFile(location)

Speichert das zuletzt aufgenommene Bild unter location.

Siehe auch capture und preview.