ImageCapture QML Type

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

• 継承されたメンバを含む全メンバのリスト

プロパティ

• error : enumeration
• errorString : string
• fileFormat : enumeration
• metaData : mediaMetaData
• preview : string
• quality : enumeration
• readyForCapture : bool
• supportedFormats : list<FileFormat> (since 6.10)

信号

• errorOccurred(id, error, errorString)
• imageCaptured(requestId, preview)
• imageMetadataAvailable(id, metaData)
• imageSaved(id, fileName)

方法

• int capture()
• int captureToFile(location)
• void 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 [read-only]

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

errorStringも参照 。

errorString : string [read-only]

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

errorも参照してください 。

fileFormat : enumeration

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

metaData : mediaMetaData

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

preview : string [read-only]

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

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

saveToFileも参照してください 。

quality : enumeration

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

readyForCapture : bool [read-only]

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

readyがfalse のときにcapture() またはcaptureToFile() を呼び出すことは許可されておらず、エラーとなる。

supportedFormats : list<FileFormat> [read-only, since 6.10]

サポートされているファイル形式のリスト。

このプロパティは Qt 6.10 で導入されました。

fileFormatも参照してください 。

Signal ドキュメント

errorOccurred(id, error, errorString)

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

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

imageCaptured(requestId, preview)

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

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

imageMetadataAvailable(id, metaData)

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

imageCapturedも参照してください 。

imageSaved(id, fileName)

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

imageCapturedも参照してください 。

メソッドのドキュメント

int capture()

画像キャプチャを開始する。キャプチャが完了すると、imageCaptured とimageSaved シグナルが出力されます。

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

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

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

readyForCapture およびpreviewも参照 。

int captureToFile(location)

capture() と同じだが、キャプチャした画像を、指定したlocation に自動的に保存する。capture requestId パラメータを返します。

capture()も参照 。

void saveToFile(location)

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

capture およびpreviewも参照 。