KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2
KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2 は、カメラの対角視野 (FoV) を度単位で指定するプロパティ ID です。 対角 FoV 値は、センサーのネイティブ アスペクト比での対角 FoV に対応します。 その結果、実際の対角 FoV がわずかに異なる非ネイティブのアスペクト比が生成されます。
このコントロールは、KSPROPERTY_CAMERACONTROL_EXTENDED_DIGITALWINDOW, KSPROPERTY_CAMERACONTROL_ZOOM、 KSPROPERTY_CAMERACONTROL_EXTENDED_ZOOMに関連しています。 相互運用性の要件については、以下の備考セクションを参照してください。
使用状況の概要表
| 範囲 | Yammer の入手 | 設定 | コントロール | タイプ |
|---|---|---|---|---|
| Version 1 | はい | はい | フィルター | 同期 |
KSCAMERA_EXTENDEDPROP_HEADER 構造フィールド
次の表には、コントロールを使用する場合の KSCAMERA_EXTENDEDPROP_HEADER 構造フィールドの要件が記載されています。
| メンバー | 説明 |
|---|---|
| バージョン | 1 にする必要があります。 |
| PinId | KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF) |
| サイズ | sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE) である必要があります。 |
| 結果 | 0 を含める必要があります。 このフィールドは、最後の非同期 SET 操作の結果を返すためにのみ使用されます。 |
| 機能 | 0 を指定する必要があります。 |
| フラグ | 0 を指定する必要があります。 |
KSCAMERA_EXTENDEDPROP_VALUE ペイロード
ペイロードは、ULONG 型の既存の KSCAMERA_EXTENDEDPROP_VALUE 構造を使用します。
解説
KSPROPERTY_CAMERACONTROL_ZOOM および KSPROPERTY_CAMERACONTROL_EXTENDED_ZOOM との相互運用性
ドライバー/デバイスがこの新しい FoV コントロールと古い >KSPROPERTY_CAMERACONTROL_ZOOM または KSPROPERTY_CAMERACONTROL_EXTENDED_ZOOM の両方をサポートすることを選択した場合、ズーム コントロールは新しい視野 (FoV) 選択内で機能する必要があります。 つまり、ズームは FoV に相対的であるということです。 FoV の値が異なると、同じズーム値でも見かけのズームの量が異なります。 さらに、FoV を設定すると、実際の FoV 値が変更されていても、ズームは常にデフォルト値にリセットされます。
たとえば、古いズーム コントロール範囲が 10 ～ 600 に指定され、ズームがデフォルト値の 10 である場合、新しい FoV 設定が 75 度～ 90 度に設定されると、古いズーム コントロールは 10 のままで、範囲は 10 ～ 600 のままになります。 ただし、古いズームが 50 だった場合、新しい FoV 値が設定されると 10 にリセットされます。
KSPROPERTY_CAMERACONTROL_EXTENDED_DIGITALWINDOWおよびDIGITALWINDOW_CONFIGCAPSとの相互運用性
ドライバー/デバイスがこの新しい FoV2 コントロールとデジタル ウィンドウ (DW) コントロールの両方をサポートすることを選択した場合は、次の要件に従う必要があります。
デジタル ウィンドウ サポートを実装する唯一の目的が KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING をサポートすることである場合、手動のデジタル ウィンドウが完全なウィンドウを表す 1 つのウィンドウ サイズのみをサポートすることは許容されます。 この完全なウィンドウは、FIELDOFVIEW2_CONFIGCAPS の DefaultDiagonalFieldOfViewInDegrees と一致する必要がありますが、最大 FoV はより広くなる可能性があります。 この場合、手動デジタル ウィンドウは完全にはサポートされていないため、手動デジタル ウィンドウに関する以下の要件は無視できます。
サポートされている手動のデジタル ウィンドウ領域は、少なくとも最も広い FoV 設定をカバーする必要があります。たとえば、デジタル ウィンドウを使用すると、サポートされている FoV 設定のいずれかに一致するデジタル クロップを作成できます。 デフォルトの FoV が最も広い FoV でない場合は、デジタル ウィンドウは Porch 値を使用して、より広いウィンドウを表す必要があります。
KSPROPERTY_CAMERACONTROL_EXTENDED_DIGITALWINDOW_CONFIGCAPS は、FoV 制御の状態に関係なく、同じ機能を報告する必要があります。
現在の手動デジタル ウィンドウは現在の FoV 設定を反映する必要があり、その逆も同様で、最後の制御が優先されます。
手動デジタルウィンドウが設定されている場合、FoV は、選択されたウィンドウ領域を囲む利用可能な最小の FoV 設定に内部的に変更される必要があります。 つまり、デジタル ウィンドウのウィンドウ サイズが同じであっても、デジタル ウィンドウの原点座標によって FoV が変化する可能性があります。 たとえば、デジタル ウィンドウの原点座標がウィンドウ サイズ 0.4 で左上隅にある場合、FoV 設定は利用可能な最も広い FoV (この例では 120°) をアドバタイズします。そうでない場合、その領域はカバーされません。 ただし、同じウィンドウ サイズの 2 番目のデジタル ウィンドウを中央クロップとして実行すると、反映される FoV はおそらく狭くなります (この例では 75°)。
KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING がサポートされ設定されている場合、ドライバー/デバイスは内部的に FoV を最も広い設定に変更する必要があります。 たとえば、KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2 の GET 操作は、KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING が有効な場合に最も広い FoV 設定を返します。 ただし、KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2 の SET 操作が成功すると、最後の制御が優先されるため、デジタル ウィンドウは KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_MANUAL モードに戻ります。
関心領域コントロールとの相互運用性
このコントロールは見かけの視野 (FoV) を変更するため、このコントロールに SET が発行されるたびに、任意の関心領域 (ROI) コントロールを通じて選択された座標をデフォルトにリセットする必要があります。 現在の ROI 制御の一覧には、次のものが含まれます。
KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_PROPERTY_ID
KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_CONFIGCAPS / KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_ISPCONTROL
将来、長方形の領域を定義するコントロールを定義する場合は、そのコントロールもリセットする必要があります。
さらに、関心領域コントロールは出力ウィンドウを基準にして領域を指定するため、指定する座標は常に現在の視野内の四角形になります。 このコントロールは現在の視野を変更するため、関心領域の四角形は、現在の視野内に収まるようにカメラによって再マップされる必要があります。
要件
サポートされている最小クライアント: Windows 11、バージョン 24H2
ヘッダー: ksmedia.h (Ksmedia.h を含む)