KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2

[アーティクル]
05/30/2024

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 を含む)

次の方法で共有