ImageCapture QML Type

カメラ画像をキャプチャするためのインターフェース。詳細...

Import Statement: import QtMultimedia

プロパティ

信号

方法

詳細説明

この型は、静止画をキャプチャし、利用可能になったときやディスクに保存されたときに通知することができます。

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

プロパティ説明

error : enumeration [read-only]

このプロパティは、最後に発生したエラータイプを保持する。以下のいずれかを指定する。

定数説明
ImageCapture.NoErrorエラーなし。
ImageCapture.NotReadyErrorサービスはまだキャプチャの準備ができていない。
ImageCapture.ResourceErrorデバイスの準備ができていないか、利用できない。
ImageCapture.OutOfSpaceErrorデバイスに空き容量がない。
ImageCapture.NotSupportedFeatureErrorデバイスが静止画キャプチャをサポートしていない。
ImageCapture.FormatError現在のフォーマットはサポートされていません。

errorStringも参照


errorString : string [read-only]

このプロパティは、最後に発生したエラーメッセージを保持します。

error参照


fileFormat : enumeration

このプロパティは、画像が書き込まれるファイル形式を保持します。以下のいずれかを指定します。

定数説明
UnspecifiedFormatフォーマット指定なし
JPEG.jpg または フォーマット.jpeg
PNG.png フォーマット
WebP.webp フォーマット
Tiff.tiff フォーマット

metaData : mediaMetaData

このプロパティは、画像に埋め込まれるメタデータを保持します。


preview : string [read-only]

このプロパティは、最新のキャプチャ画像への URL を保持します。最後にキャプチャした画像を表示するために、Image 要素の source プロパティに接続することができます。

CaptureSession {
    camera: Camera {}
    imageCapture: ImageCapture {
        id: capture
    }
}
Image {
    source: capture.preview
}

saveToFileも参照してください


quality : enumeration

このプロパティは、キャプチャ画像を保存する際の品質ヒントを保持します。以下の値のいずれかを指定します。

定数説明
VeryLowQuality非常に低い
LowQuality低い
NormalQuality普通
HighQuality高い
VeryHighQuality非常に高い

readyForCapture : bool [read-only]

このプロパティは、カメラが写真を撮影する準備ができているかどうかを示す bool 値を保持する。

readyfalse のときにcapture() やcaptureToFile() を呼び出すことは許されず、エラーとなる。


シグナル・ドキュメント

errorOccurred(id, error, errorString)

id error は ImageCapture::Error 型の列挙です。説明メッセージは にあります。errorString

注意: 対応するハンドラはonErrorOccurred です。

error およびerrorStringも参照してください


imageCaptured(requestId, preview)

このシグナルは、要求IDrequestId の画像がキャプチャされたが、まだファイルシステムに保存されていない場合に発行されます。preview パラメータはキャプチャされた画像です。

注意: 対応するハンドラはonImageCaptured です。

imageSaved およびpreviewも参照してください


imageMetadataAvailable(id, metaData)

このシグナルは、要求されたid の画像に新しいmetaData が追加されたときに発せられます。

注意 : 対応するハンドラはonImageMetadataAvailable です。

imageCapturedも参照して ください。


imageSaved(id, fileName)

このシグナルは、要求されたid の画像がファイルシステムに書き込まれた後に発せられます。fileName はURLではなくローカルファイルパスです。

注意: 対応するハンドラはonImageSaved です。

imageCapturedも参照して ください。


メソッドの説明

capture()

画像キャプチャを開始する。キャプチャが完了すると、imageCapturedimageSaved シグナルが発行されます。

キャプチャされた画像は、QML画像アイテムのソースとして利用可能なプレビュープロパティを通じて利用可能になります。saveToFile ()メソッドを使って画像を保存することができます。

Cameraは、露出設定や画像処理パラメータのようなすべてのキャプチャパラメータを保存するので、 capture()が呼ばれた後にカメラパラメータを変更しても、以前のキャプチャリクエストには影響しません。

capture()は、imageExposed(),imageCaptured(),imageMetadataAvailable(),imageSaved() シグナルで使用される capture requestId パラメータを返す。

readyForCapture およびpreviewも参照


captureToFile(location)

capture() と同じだが、キャプチャした画像を指定したlocation に自動的に保存する。

captureも参照


saveToFile(location)

最後にキャプチャした画像をlocation に保存する。

capture および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.