Back to Qt.io
Contact Us Blog Download Qt

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

プロパティ Documentation

preview : string [read-only]

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

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

saveToFileも参照 。


readyForCapture : bool [read-only]

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

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


シグナル・ドキュメント

errorOccurred(id, error, errorString)

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

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


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も参照 。


captureToFile(location)

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

captureも参照 。


saveToFile(location)

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

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


本書に含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。