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();

メンバ関数のドキュメント

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

parent から、カメラで撮影された個々の静止画像をキャプチャできる画像キャプチャオブジェクトを作成します。

画像をキャプチャするには、画像キャプチャオブジェクトとQCamera の両方をキャプチャセッションに接続する必要があります。

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

画像を削除し、オブジェクトをキャプチャします。

void QImageCapture::addMetaData(const QMediaMetaData &metaData)

既存のメタデータに、metaData を追加し、それをキャプチャされた画像に埋め込みます。

[slot] int QImageCapture::capture()

画像をキャプチャし、QImage として利用可能にします。この操作は、ほとんどの場合非同期で行われ、その後、QImageCapture::imageExposed()、QImageCapture::imageCaptured()、またはQImageCapture::error()のシグナルが発生します。

QImageCapture::capture は、imageExposed()、imageCaptured()、およびimageSaved() シグナルで使用されるキャプチャ ID パラメータを返します。

isReadyForCapture()も参照してください 。

QMediaCaptureSession *QImageCapture::captureSession() const

このカメラが接続されているキャプチャセッションを返します。カメラがキャプチャセッションに接続されていない場合は、nullptr を返します。

QMediaCaptureSession::setImageCapture() を使用して、画像キャプチャをセッションに接続します。

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

画像をキャプチャし、file に保存します。この操作は、ほとんどの場合非同期で行われ、その後、QImageCapture::imageExposed()、QImageCapture::imageCaptured()、QImageCapture::imageSaved()、またはQImageCapture::error() のシグナルが発生します。

空の `file ` が渡された場合、カメラのバックエンドはシステム上の写真に対するデフォルトの保存場所と命名規則を選択します。フルパスなしでファイル名のみが指定された場合、画像はデフォルトのディレクトリに保存され、imageCaptured() およびimageSaved() シグナルによってフルパスが報告されます。

QCamera 露出設定や画像処理パラメータなどのすべてのキャプチャパラメータを保存するため、capture() の呼び出し後にカメラパラメータを変更しても、それ以前のキャプチャ要求には影響しません。

QImageCapture::capture imageExposed()、 ()、 () シグナルで使用されるキャプチャ ID パラメータを返します。imageCaptured imageSaved

isReadyForCapture()も参照してください 。

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

キャプチャ要求「id 」が、error およびerrorString という説明とともに失敗したことを示します。

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

指定されたファイル形式「f 」の説明を返します。

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

指定されたフォーマット「f 」の名前を返します。

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

リクエスト「id 」を持つframe が利用可能になった際に送信されるシグナル。

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

リクエスト「id 」を含むフレームがキャプチャされたものの、まだ処理・保存されていない場合に送信されるシグナルです。フレーム「preview 」をユーザーに表示することができます。

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

リクエスト「id 」を含むフレームが公開された際に発信されるシグナル。

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

id で特定された画像にmetaData が含まれていることを示します。

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

QImageCapture::CaptureToFile が設定され、リクエスト IDid を持つフレームがfileName に保存された際に発せられるシグナルです。

bool QImageCapture::isAvailable() const

画像キャプチャサービスが利用可能な状態であれば、trueを返します。

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

カメラのキャプチャ状態に関するready が変更されたことを通知します。

QSize QImageCapture::resolution() const

エンコードされた画像の解像度を返します。

setResolution()も参照してください 。

[signal] void QImageCapture::resolutionChanged()

画像の解像度が変更されたときに通知します。

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

画像をformat に設定します。

サポートされていないFileFormat を割り当てても、何の効果もありません。

fileFormat() およびsupportedFormatsも参照してください 。

void QImageCapture::setMetaData(const QMediaMetaData &metaData)

キャプチャされた画像に埋め込まれる既存のメタデータを、metaData のセットに置き換えます。

metaData()も参照してください 。

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

画像のエンコーディング「quality 」を設定します。

quality()も参照してください 。

void QImageCapture::setResolution(const QSize &resolution)

エンコードされた画像のresolution を設定します。

QSize が空の場合、エンコーダは画像ソースから得られる情報とコーデックの制限に基づいて最適な選択を行うことを示します。

resolution()も参照してください 。

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

エンコードされた画像の解像度に関するwidth およびheight を設定します。

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

サポートされているファイル形式のリストを返します。

関連項目: ` FileFormat`。