ImageCapture QML Type
カメラ画像をキャプチャするためのインターフェース。詳細...
Import Statement: | import QtMultimedia |
プロパティ
- error : enumeration
- errorString : string
- fileFormat : enumeration
- metaData : mediaMetaData
- preview : string
- quality : enumeration
- readyForCapture : bool
信号
- errorOccurred(id, error, errorString)
- imageCaptured(requestId, preview)
- imageMetadataAvailable(id, metaData)
- imageSaved(id, fileName)
方法
- capture()
- captureToFile(location)
- saveToFile(location)
詳細説明
この型は、静止画をキャプチャし、利用可能になったときやディスクに保存されたときに通知することができます。
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 |
このプロパティは、最後に発生したエラータイプを保持する。以下のいずれかを指定する。
定数 | 説明 |
---|---|
ImageCapture.NoError | エラーなし。 |
ImageCapture.NotReadyError | サービスはまだキャプチャの準備ができていない。 |
ImageCapture.ResourceError | デバイスの準備ができていないか、利用できない。 |
ImageCapture.OutOfSpaceError | デバイスに空き容量がない。 |
ImageCapture.NotSupportedFeatureError | デバイスが静止画キャプチャをサポートしていない。 |
ImageCapture.FormatError | 現在のフォーマットはサポートされていません。 |
errorStringも参照 。
fileFormat : enumeration |
このプロパティは、画像が書き込まれるファイル形式を保持します。以下のいずれかを指定します。
定数 | 説明 |
---|---|
UnspecifiedFormat | フォーマット指定なし |
JPEG | .jpg または フォーマット.jpeg |
PNG | .png フォーマット |
WebP | .webp フォーマット |
Tiff | .tiff フォーマット |
metaData : mediaMetaData |
このプロパティは、画像に埋め込まれるメタデータを保持します。
preview : string |
このプロパティは、最新のキャプチャ画像への URL を保持します。最後にキャプチャした画像を表示するために、Image 要素の source プロパティに接続することができます。
CaptureSession { camera: Camera {} imageCapture: ImageCapture { id: capture } } Image { source: capture.preview }
saveToFileも参照してください 。
quality : enumeration |
このプロパティは、キャプチャ画像を保存する際の品質ヒントを保持します。以下の値のいずれかを指定します。
定数 | 説明 |
---|---|
VeryLowQuality | 非常に低い |
LowQuality | 低い |
NormalQuality | 普通 |
HighQuality | 高い |
VeryHighQuality | 非常に高い |
readyForCapture : bool |
このプロパティは、カメラが写真を撮影する準備ができているかどうかを示す bool 値を保持する。
readyがfalse
のときに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() |
画像キャプチャを開始する。キャプチャが完了すると、imageCaptured とimageSaved シグナルが発行されます。
キャプチャされた画像は、QML画像アイテムのソースとして利用可能なプレビュープロパティを通じて利用可能になります。saveToFile ()メソッドを使って画像を保存することができます。
Cameraは、露出設定や画像処理パラメータのようなすべてのキャプチャパラメータを保存するので、 capture()が呼ばれた後にカメラパラメータを変更しても、以前のキャプチャリクエストには影響しません。
capture()は、imageExposed(),imageCaptured(),imageMetadataAvailable(),imageSaved() シグナルで使用される capture requestId パラメータを返す。
readyForCapture および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.