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]

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

準備完了状態（ready）の間にcapture()またはcaptureToFile()を呼び出すと、false となり、これは許可されず、エラーが発生します。

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

サポートされているファイル形式の一覧が含まれています。

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

「fileFormat」も参照してください 。

シグナルのドキュメント

errorOccurred(id, error, errorString)

このシグナルは、指定されたid によるキャプチャ中にエラーが発生したときに発せられます。error は、ImageCapture::Error型の列挙型です。説明メッセージはerrorString で確認できます。

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

imageCaptured(requestId, preview)

このシグナルは、リクエストされたID「requestId 」の画像がキャプチャされたものの、まだファイルシステムに保存されていない場合に発せられます。preview パラメータは、キャプチャされた画像です。

関連項目: imageSaved およびpreview 。

imageMetadataAvailable(id, metaData)

このシグナルは、リクエストされたid を持つ画像に新しいmetaData が追加されたときに発せられます。

「imageCaptured」も参照してください 。

imageSaved(id, fileName)

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

「imageCaptured」も参照してください 。

メソッドのドキュメント

int capture()

画像のキャプチャを開始します。キャプチャが完了すると、imageCaptured およびimageSaved シグナルが発信されます。

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

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

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

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

int captureToFile(location)

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

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

void saveToFile(location)

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

「 capture 」および「preview 」も参照してください 。