QImageCapture Class

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

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

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

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

Member Function Dokumentation

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

Konstruiert ein Image-Capture-Objekt aus einem parent, das einzelne von einer Kamera erzeugte Standbilder erfassen kann.

Sie müssen sowohl ein Image-Capture-Objekt als auch eine QCamera mit einer Aufnahmesitzung verbinden, um Bilder aufzunehmen.

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

Zerstört das Bildaufnahmeobjekt.

void QImageCapture::addMetaData(const QMediaMetaData &metaData)

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

[slot] int QImageCapture::capture()

Erfasst das Bild und stellt es als QImage zur Verfügung. Dieser Vorgang erfolgt in den meisten Fällen asynchron, gefolgt von den Signalen QImageCapture::imageExposed(), QImageCapture::imageCaptured() oder QImageCapture::error().

QImageCapture::capture gibt den Parameter capture Id zurück, der mit 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 eine 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())

Erfassen Sie das Bild und speichern Sie es unter file. Dieser Vorgang ist in den meisten Fällen asynchron, gefolgt von den Signalen QImageCapture::imageExposed(), QImageCapture::imageCaptured(), QImageCapture::imageSaved() oder QImageCapture::error().

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 ein vollständiger Pfad mit den Signalen imageCaptured() und imageSaved() gemeldet wird.

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

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

Siehe auch isReadyForCapture().

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

Signalisiert, dass die Erfassungsanfrage id fehlgeschlagen ist, mit einer error und errorString Beschreibung.

[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 die frame mit der Anfrage id verfügbar ist.

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

Signal, das ausgegeben wird, wenn der Frame mit der Anfrage id erfasst, aber noch nicht verarbeitet und gespeichert wurde. Frame preview kann dem Benutzer angezeigt werden.

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

Signal, das ausgegeben wird, wenn der Rahmen mit der Anfrage id ausgesetzt wurde.

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

Signalisiert, dass ein mit id identifiziertes Bild metaData hat.

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

Signal, das ausgegeben wird, wenn QImageCapture::CaptureToFile gesetzt ist und das Bild mit der Anfrage id in fileName gespeichert wurde.

bool QImageCapture::isAvailable() const

Gibt true zurück, wenn der Bilderfassungsdienst einsatzbereit ist.

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

Signalisiert, dass sich der Zustand der Kamera ready für die Aufnahme geändert hat.

QSize QImageCapture::resolution() const

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

Siehe auch setResolution().

[signal] void QImageCapture::resolutionChanged()

Signalisiert, wenn sich die Bildauflösung ändert.

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

Legt das Bild format fest.

Siehe auch fileFormat().

void QImageCapture::setMetaData(const QMediaMetaData &metaData)

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

Siehe auch metaData().

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

Legt die Bildkodierung quality fest.

Siehe auch quality().

void QImageCapture::setResolution(const QSize &resolution)

Legt die resolution des kodierten Bildes fest.

Ein leeres QSize zeigt an, dass der Encoder eine optimale Auswahl treffen sollte, die auf den verfügbaren Daten der Bildquelle und den Einschränkungen des Codecs basiert.

Siehe auch resolution().

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

Legt die width und height der Auflösung des kodierten Bildes fest.

Dies ist eine überladene Funktion.

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

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

Siehe auch FileFormat.