KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_ISPCONTROL
KSPROPERTY_CAMERACONTROL_EXTENDED_PROPERTY リストで定義されている KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_ISPCONTROL プロパティ ID を使用して ROI 設定を取得または構成し、必要な処理を適用します。
用法の要点
| 範囲 | コントロール | Type |
|---|---|---|
Version 1 |
Assert |
非同期、キャンセル可能 |
ドライバーから現在の ROI 設定を取得するか、ROI 設定を構成して目的の処理 (3A) を適用するには、KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_ISPCONTROL 拡張プロパティ コントロールが標準の KSCAMERA_EXTENDEDPROP_HEADER 構造体と共にドライバーに送信され、その後に KSCAMERA_EXTENDEDPROP_ROI_ISPCONTROLHEADER 構造体が続き、その後には KSCAMERA_EXTENDEDPROP_ROI_ISPCONTROL 構造体が続き、さらに複数の ISP 固有の制御ペイロード構造が続きます。 次のリストは、1 つのフォーカス ROI と 2 つの露出 ROI を持つデータ構造レイアウトを示しています。
KSCAMERA_EXTENDEDPROP_HEADER
KSCAMERA_EXTENDEDPROP_ROI_ISPCONTROLHEADER
KSCAMERA_EXTENDEDPROP_ROI_ISPCONTROL (フォーカス)
KSCAMERA_EXTENDEDPROP_ROI_FOCUS
KSCAMERA_EXTENDEDPROP_ROI_ISPCONTROL (2 つの ROI による露出)
KSCAMERA_EXTENDEDPROP_ROI_EXPOSURE (ROI 1)
KSCAMERA_EXTENDEDPROP_ROI_EXPOSURE (ROI 2)
以下の表は、拡張 ROI コントロールの KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_ISPCONTROL プロパティを使用する場合の KSCAMERA_EXTENDEDPROP_HEADER 構造体フィールドの説明と要件を示しています。
| メンバー | 説明 |
|---|---|
バージョン |
これは 1 である必要があり、 |
PinId |
これは、KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF) である必要があり、 |
サイズ |
最初の GET 呼び出し (SET 呼び出しが行われなかった場合) の場合、これは sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_ROI_ISPCONTROLHEADER) である必要があります。 さらに、ドライバーは、ISO コントロール ヘッダー ペイロード内の ControlCount 内で 0 を返す必要があります。 その他の SET 呼び出しまたは GET 呼び出しの場合、これは sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_ ROI_ISPCONTROLHEADER) + ControlCount * sizeof(KSCAMERA_EXTENDEDPROP_ROI_ISPCONTROL) + sizeof(KSCAMERA_EXTENDEDPROP_ROI_FOCUS) * ROICount(focus) + sizeof(KSCAMERA_EXTENDEDPROP_EXPOSURE) * ROICount(exposure) + sizeof(KSCAMERA_EXTENDEDPROP_WHITEBALANCE) * ROICount(whitebalance) である必要があります。 |
結果 |
これは最後の SET 操作のエラー結果を示します。 SET 操作が実行されていない場合は、0 にする必要があります。 値 0 は、構成されているすべての ISP コントロールに対してエラーが検出されなかったことを示します。 |
機能 |
これは、KSCAMERA_EXTENDEDPROP_CAPS_ASYNCONTROL と KSCAMERA_EXTENDEDPROP_CAPS_CANCELLABLE ビット論理和である必要があります。 |
Flags |
これは読み取り/書き込みフィールドです。これは SET 呼び出しの KSCAMERA_EXTENDEDPROP_FLAG_CANCELOPERATION である可能性があります。 GET 呼び出しの場合、これは 0 である必要があります。 |
調整可能な出力ウィンドウに関する考慮事項
カメラに送信される 3A ROI 座標は、カメラの現在の出力ウィンドウに対して送信されます。 ズーム、パン、または傾斜または デジタル ウィンドウなどのコントロールを使用して視野が変更された場合、カメラ (またはデジタル ウィンドウ/PTZ コントロールを実装するコンポーネント) は、提供された座標をセンサーの全視野にマッピングする役割を担います。現在の出力ウィンドウを考慮して、カメラの 3A アルゴリズムが正しいスポットをターゲットにしていることを確認します。 ビューのフィールドの変更が行われる場所によっては、座標マッピングを双方向にする必要がある場合があります。 たとえば、カメラで顔検出に Windows プラットフォーム DMFT を使用しているが、ドライバー チェーンのプラットフォーム DMFT の後にビューの視野の変更がコンポーネントに実装されている場合、アプリケーションによって提供される ROI 座標をカメラに送信する前に全視野にマッピングし直す必要があり、プラットフォーム DMFT で計算された ROI 座標は、要求するアプリに送信する前に、変更された視野にマッピングする必要があります。
要件
ヘッダー |
Ksmedia.h |