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

error : enumeration [read-only]

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

KonstanteBeschreibung
ImageCapture.NoErrorKeine Fehler.
ImageCapture.NotReadyErrorDer Dienst ist noch nicht für die Erfassung bereit.
ImageCapture.ResourceErrorDas Gerät ist nicht bereit oder nicht verfügbar.
ImageCapture.OutOfSpaceErrorKein Platz mehr auf dem Gerät.
ImageCapture.NotSupportedFeatureErrorDas Gerät unterstützt die Erfassung von Standbildern nicht.
ImageCapture.FormatErrorDas aktuelle Format wird nicht unterstützt.

Siehe auch errorString.


errorString : string [read-only]

Diese Eigenschaft enthält die letzte Fehlermeldung, die aufgetreten ist.

Siehe auch error.


fileFormat : enumeration

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

KonstanteBeschreibung
UnspecifiedFormatKein Format angegeben
JPEG.jpg oder .jpeg Format
PNG.png Format
WebP.webp Format
Tiff.tiff format

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 Qualitätshinweis beim Speichern des aufgenommenen Bildes. Sie kann einer der folgenden Werte sein.

KonstanteBeschreibung
VeryLowQualitySehr niedrig
LowQualityNiedrig
NormalQualityNormal
HighQualityHoch
VeryHighQualitySehr hoch

readyForCapture : bool [read-only]

Diese Eigenschaft enthält einen boolschen Wert, der angibt, ob die Kamera zur Aufnahme von Fotos bereit ist 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 ein Fehler während der Aufnahme mit der angeforderten 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.

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