Back to Qt.io
Contact Us Blog Download Qt

ImageCapture QML Type

Eine Schnittstelle zur Erfassung von Kamerabildern. Mehr...

Import Statement: import QtMultimedia

Eigenschaften

Signale

Methoden

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

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.


readyForCapture : bool [read-only]

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

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


Signal Dokumentation

errorOccurred(id, error, errorString)

Dieses Signal wird ausgegeben, wenn während der Aufnahme ein Fehler mit der Anforderung id auftritt. error ist eine Aufzählung vom Typ ImageCapture::Error. Eine beschreibende Meldung ist in errorString verfügbar.

Hinweis: Der entsprechende Handler ist onErrorOccurred.


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 aufgenommene Bild.

Hinweis: Der entsprechende Handler ist onImageCaptured.

Siehe auch imageSaved und preview.


imageMetadataAvailable(id, metaData)

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

Hinweis: Der entsprechende Handler ist onImageMetadataAvailable.

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.

Hinweis: Der entsprechende Handler ist onImageSaved.

Siehe auch imageCaptured.


Dokumentation der Methode

capture()

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

Das erfasste Bild ist über die Eigenschaft preview 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.


captureToFile(location)

Führt dasselbe aus wie capture(), speichert aber zusätzlich das erfasste Bild automatisch im angegebenen location.

Siehe auch capture.


saveToFile(location)

Speichert das zuletzt aufgenommene Bild unter location.

Siehe auch capture und preview.


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