KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_ISPCONTROL
KSPROPERTY_CAMERACONTROL_EXTENDED_PROPERTY 列挙で定義されている KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_ISPCONTROL プロパティ ID は、ROI 設定を取得または構成し、必要な処理を適用するために使用されます。
使用状況の概要テーブル
| スコープ | コントロール | 種類 |
|---|---|---|
バージョン 1 |
フィルター |
非同期、キャンセル可能 |
ドライバーから現在の ROI 設定を取得するか、ROI 設定を構成して目的の処理 (3A) を適用するには、KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_ISPCONTROL 拡張プロパティ コントロールが標準の KSCAMERA_EXTENDEDPROP_HEADER 構造と共にドライバーに送信され、その後に KSCAMERA_EXTENDEDPROP_ROI_ISPCONTROLHEADER 構造が続き、KSCAMERA_EXTENDEDPROP_ROI_ISPCONTROL 構造が続きます。1 つ以上の対応する 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 つの ROIs による露出)
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(フォーカス) + sizeof(KSCAMERA_EXTENDEDPROP_EXPOSURE) * ROICount(露出) + sizeof(KSCAMERA_EXTENDEDPROP_WHITEBALANCE) * ROICount (ホワイトバランス) である必要があります。 |
結果 |
これは、最後の SET 操作のエラー結果を示します。 SET 操作が実行されていない場合は、0 にする必要があります。 値 0 は、構成されているすべての ISP コントロールに対してエラーが検出されなかったことを示します。 |
力 |
これは、KSCAMERA_EXTENDEDPROP_CAPS_ASYNCCONTROL と KSCAMERA_EXTENDEDPROP_CAPS_CANCELLABLEのビットごとのORでなければなりません. |
フラグ |
これは読み取り/書き込みフィールドです。SET 呼び出しに KSCAMERA_EXTENDEDPROP_FLAG_CANCELOPERATION 可能性があります。 GET 呼び出しの場合、これは 0 である必要があります。 |
調整可能な出力ウィンドウに関する考慮事項
カメラに送信される 3A ROI 座標は、カメラの現在の出力ウィンドウに対して送信されます。 Zoom、Pan、Tilt、Digital Windowなどのコントロールの使用によってビューのフィールドが変更された場合、カメラ (またはデジタル ウィンドウ/PTZ コントロールを実装するコンポーネント) は、指定された座標をセンサーの完全な視野にマッピングする役割を担い、現在の出力ウィンドウを考慮して、カメラの 3A アルゴリズムが適切なスポットをターゲットにしていることを確認します。 ビューのフィールドの変更が行われる場所によっては、座標マッピングを双方向にする必要がある場合があります。 たとえば、カメラで顔検出に Windows プラットフォーム DMFT を使用しているが、ドライバー チェーンのプラットフォーム DMFT の後にビューの変更フィールドがコンポーネントに実装されている場合、アプリケーションによって提供される ROI 座標をカメラに送信する前に完全なビュー フィールドにマップし直す必要があり、プラットフォーム DMFT で計算された ROI 座標は、変更されたビューフィールドにマップする必要があります。を要求するアプリに送信されます。
必要条件
ヘッダ |
Ksmedia.h |