MF_MT_DEPTH_VALUE_UNIT属性

[一部の情報はリリース前の製品に関することであり、正式版がリリースされるまでに大幅に変更される可能性があります。 ここに記載された情報について、Microsoft は明示または黙示を問わずいかなる保証をするものでもありません。]

ビデオ フレーム内の深度値の単位を定義する 値。

データ型

UINT64

解説

単位値は、ナノメートル単位の UINT64 値 (1e ~ 9 m) です。 この値が存在しない場合、単位の既定値は 1e-3 です。これは、各ピクセル レベルが物理空間で 1 ミリメートル単位で測定されていることを示します。

深度カメラは、すべてのピクセルの深度を検出できません。 素材、オクルージョン、範囲外などの理由でピクセルの信頼度が低い場合、そのピクセルの深度値が無効になる可能性があります。

深度ピクセル値が 0 の場合、ピクセルは無効です。

一部の深度カメラでは、深度値に加えて、各ピクセルのビットマスク メタデータをアタッチして、素材、オクルージョン、範囲外などによってピクセルの深度が無効である理由を表します。ピクセル シェーダーでこのような値を使用すると通常困難になるため、このようなメタデータは深度値のビットなどの添付は避けてください。 代わりに 同じ解像度の別の 8 ビット イメージ バッファーを使用し、 IMFSample の属性としてアタッチすることをお勧めします。 このようなメタデータはカメラ ベンダーごとに異なり、プラットフォームによって標準化されていません。 ダウンストリームでの処理を容易にし、無効に 0 などの固定値を使用するには、深度値に完全な 16 ビットを使用することをお勧めします。

必要条件

要件	値
サポートされている最小のクライアント	Windows 10バージョン 1709 [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server バージョン 1709 [デスクトップ アプリのみ]
ヘッダー	Mfapi.h