attribut MF_MT_DEPTH_VALUE_UNIT

[Einige Informationen beziehen sich auf die Vorabversion, die vor der kommerziellen Freigabe möglicherweise wesentlichen Änderungen unterliegt. Microsoft übernimmt für die hier bereitgestellten Informationen keine Gewährleistung, weder ausdrücklicher noch impliziter Art.]

Ein Wert, der die Einheiten für einen Tiefenwert in einem Videoframe definiert.

Datentyp

UINT64

Bemerkungen

Der Einheitswert ist ein UINT64-Wert in Nanometern im Bereich von 1e bis 9 Metern. Wenn dieser Wert nicht vorhanden ist, ist der Standardwert der Einheit 1e-3, was angibt, dass jede Pixelebene in 1 Millimeter im physischen Raum gemessen wird.

Tiefenkameras können die Tiefe aller Pixel nicht erkennen. Wenn die Zuverlässigkeit eines Pixels aufgrund von Material, Okklusion oder außerhalb des Bereichs usw. gering ist, kann der Tiefenwert für dieses Pixel ungültig sein.

Wenn ein Tiefenpixelwert 0 ist, ist das Pixel ungültig.

Einige Tiefenkameras fügen zusätzlich zum Tiefenwert Bitmaskenmetadaten für jedes Pixel an, um den Grund darzustellen, warum die Tiefe des Pixels aufgrund von Material, Okklusion oder außerhalb des Bereichs ungültig ist. Es wird empfohlen, das Anfügen solcher Metadaten als Bits in depth-Wert zu vermeiden, da dies in der Regel zu Schwierigkeiten bei der Verwendung solcher Werte im Pixel-Shader führt. Stattdessen: Es wird empfohlen, einen separaten 8-Bit-Bildpuffer mit derselben Auflösung zu verwenden und ihn als Attribut des IMFSample anzufügen. Solche Metadaten variieren für jeden Kamerahersteller und werden nicht von der Plattform standardisiert. Es wird empfohlen, vollständige 16 Bit für den Tiefenwert zu verwenden, um die nachgelagerte Verarbeitung zu erleichtern und einen festen Wert wie 0 für ungültig zu verwenden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10, Version 1709 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server, Version 1709 [nur Desktop-Apps]
Header	Mfapi.h