QImageCapture Class

QMediaCaptureSession captureSession;
camera = new QCamera;
captureSession.setCamera(camera);

viewfinder = new QVideoWidget;
viewfinder->show();
captureSession.setVideoOutput(viewfinder);

imageCapture = new QImageCapture;
captureSession.setImageCapture(imageCapture);

camera->start();
// on shutter button pressed
imageCapture->capture();

Dokumentation zu den Member-Funktionen

[explicit] QImageCapture::QImageCapture(QObject *parent = nullptr)

Erstellt aus einem „ parent “ ein Bildaufnahmeobjekt, mit dem einzelne, von einer Kamera erzeugte Standbilder aufgenommen werden können.

Um Bilder aufzunehmen, müssen Sie sowohl ein Bildaufnahmeobjekt als auch ein „ QCamera “ mit einer Aufnahmesitzung verbinden.

[override virtual noexcept] QImageCapture::~QImageCapture()

Löscht die Bilder, die das Objekt erfassen.

void QImageCapture::addMetaData(const QMediaMetaData &metaData)

Fügt den vorhandenen Metadaten, die in das aufgenommene Bild eingebettet sind, zusätzliche „ metaData “ hinzu.

[slot] int QImageCapture::capture()

Das Bild wird erfasst und als „ QImage “ bereitgestellt. Dieser Vorgang läuft in den meisten Fällen asynchron ab, gefolgt von den Signalen „ QImageCapture::imageExposed()“, „ QImageCapture::imageCaptured()“ oder „ QImageCapture::error()“.

QImageCapture::capture gibt den Parameter „captureId“ zurück, der bei den Signalen „ imageExposed()“, „ imageCaptured()“ und „ imageSaved()“ verwendet wird.

Siehe auch „ isReadyForCapture()“.

QMediaCaptureSession *QImageCapture::captureSession() const

Gibt die Aufnahmesitzung zurück, mit der diese Kamera verbunden ist, oder einen `nullptr`, wenn die Kamera nicht mit einer Aufnahmesitzung verbunden ist.

Verwenden Sie ` QMediaCaptureSession::setImageCapture()`, um die Bildaufnahme mit einer Sitzung zu verbinden.

[slot] int QImageCapture::captureToFile(const QString &file = QString())

Das Bild wird aufgenommen und unter file gespeichert. Dieser Vorgang läuft in den meisten Fällen asynchron ab, woraufhin die Signale QImageCapture::imageExposed(), QImageCapture::imageCaptured(), QImageCapture::imageSaved() oder QImageCapture::error() ausgelöst werden.

Wird ein leeres ` file ` übergeben, wählt das Kamera-Backend den Standard-Speicherort und das Standard-Namensschema für Fotos auf dem System; wird nur ein Dateiname ohne vollständigen Pfad angegeben, wird das Bild im Standardverzeichnis gespeichert, wobei der vollständige Pfad über die Signale ` imageCaptured()`, ` imageSaved()` und ` ()` gemeldet wird.

QCamera speichert alle Aufnahmeparameter wie Belichtungseinstellungen oder Bildverarbeitungsparameter, sodass Änderungen an den Kameraparametern nach dem Aufruf von ` capture()` keine Auswirkungen auf vorherige Aufnahmeanfragen haben.

QImageCapture::capture Gibt den Aufnahm-ID-Parameter zurück, der bei den Signalen „ imageExposed()“, „ imageCaptured()“ und „ imageSaved()“ verwendet wird.

Siehe auch ` isReadyForCapture()`.

[signal] void QImageCapture::errorOccurred(int id, QImageCapture::Error error, const QString &errorString)

Zeigt an, dass die Erfassungsanforderung id mit dem Fehler „ error “ und der Fehlerbeschreibung „ errorString “ fehlgeschlagen ist.

[static] QString QImageCapture::fileFormatDescription(QImageCapture::FileFormat f)

Gibt die Beschreibung des angegebenen Dateiformats zurück: f.

[static] QString QImageCapture::fileFormatName(QImageCapture::FileFormat f)

Gibt den Namen des angegebenen Formats zurück: „ f “.

[signal] void QImageCapture::imageAvailable(int id, const QVideoFrame &frame)

Signal, das ausgegeben wird, wenn der frame mit der Anfrage id verfügbar ist.

[signal] void QImageCapture::imageCaptured(int id, const QImage &preview)

Dieses Signal wird ausgegeben, wenn der Frame mit der Anforderung „ id “ erfasst, aber noch nicht verarbeitet und gespeichert wurde. Der Frame „ preview “ kann dem Benutzer angezeigt werden.

[signal] void QImageCapture::imageExposed(int id)

Signal, das ausgesendet wird, wenn der Rahmen mit der Anforderung „ id “ übertragen wurde.

[signal] void QImageCapture::imageMetadataAvailable(int id, const QMediaMetaData &metaData)

Zeigt an, dass ein unter id identifiziertes Bild metaData enthält.

[signal] void QImageCapture::imageSaved(int id, const QString &fileName)

Dieses Signal wird ausgelöst, wenn QImageCapture::CaptureToFile gesetzt ist und das Bild mit der Anforderungs- id unter fileName gespeichert wurde.

bool QImageCapture::isAvailable() const

Gibt „true“ zurück, wenn der Bildaufzeichnungsdienst einsatzbereit ist.

[signal] void QImageCapture::readyForCaptureChanged(bool ready)

Signalisiert, dass sich der ready -Wert einer Kamera für den Aufnahmestatus geändert hat.

QSize QImageCapture::resolution() const

Gibt die Auflösung des kodierten Bildes zurück.

Siehe auch „ setResolution()“.

[signal] void QImageCapture::resolutionChanged()

Gibt ein Signal aus, wenn sich die Bildauflösung ändert.

void QImageCapture::setFileFormat(QImageCapture::FileFormat format)

Legt die Bild format fest.

Die Zuweisung eines nicht unterstützten Bild FileFormat s hat keine Auswirkung.

Siehe auch „ fileFormat()“ und „ supportedFormats “.

void QImageCapture::setMetaData(const QMediaMetaData &metaData)

Ersetzt alle vorhandenen Metadaten, die in das aufgenommene Bild eingebettet werden sollen, durch einen Satz von metaData.

Siehe auch ` metaData()` .

void QImageCapture::setQuality(QImageCapture::Quality quality)

Legt die Bildkodierung fest quality.

Siehe auch ` quality()`.

void QImageCapture::setResolution(const QSize &resolution)

Legt den Wert „ resolution “ des kodierten Bildes fest.

Ein leerer ` QSize `-Parameter bedeutet, dass der Encoder eine optimale Wahl treffen soll, basierend auf den aus der Bildquelle verfügbaren Informationen und den Einschränkungen des Codecs.

Siehe auch resolution().

void QImageCapture::setResolution(int width, int height)

Legt die Werte „ width “ und „ height “ für die Auflösung des kodierten Bildes fest.

[static] QList<QImageCapture::FileFormat> QImageCapture::supportedFormats()

Gibt eine Liste der unterstützten Dateiformate zurück.

Siehe auch „ FileFormat “.