Attribut MF_MT_DEPTH_MEASUREMENT

[Certaines informations portent sur la préversion du produit, qui est susceptible d’être en grande partie modifié avant sa commercialisation. Microsoft ne donne aucune garantie, expresse ou implicite, concernant les informations fournies ici.]

Valeur qui définit le système de mesure pour une valeur de profondeur dans une image vidéo.

Type de données

UINT32

Notes

Cette valeur est membre de l’énumération _MFDepthMeasurement

Si cet attribut n’est pas présent, il est supposé être DistanceToFocalPlane. La distance du plan focal est généralement plus facile à consommer dans un système de coordonnées euclidien 3D.

La distance du format centre focal est généralement des données brutes provenant du capteur, telles que le temps de caméras de vol.

Les caméras de profondeur ne peuvent pas détecter la profondeur de tous les pixels. Lorsque la confiance d’un pixel est faible, en raison du matériau, de l’occlusion, si hors limites, etc., la valeur de profondeur sur ce pixel peut être non valide.

Lorsqu’une valeur de pixel de profondeur est 0, le pixel n’est pas valide.

Certaines caméras de profondeur attachent des métadonnées de masque de bits pour chaque pixel en plus de la valeur de profondeur, pour représenter la raison pour laquelle la profondeur du pixel n’est pas valide (en raison du matériau, de l’occlusion, si hors limite, etc.). Nous vous recommandons d’éviter d’attacher des métadonnées telles que des bits en valeur de profondeur, car elles entraînent généralement des difficultés lors de l’utilisation de ces valeurs dans le nuanceur de pixels. À la place. nous vous recommandons d’utiliser une mémoire tampon d’image 8 bits distincte avec la même résolution et de l’attacher en tant qu’attribut du IMFSample. Ces métadonnées varient pour chaque fournisseur de caméras et ne sont pas normalisées par la plateforme. Nous vous recommandons d’utiliser 16 bits complets pour la valeur de profondeur pour faciliter le traitement en aval et l’utilisation d’une valeur fixe telle que 0 pour l’invalidation.

Configuration requise

Condition requise	Value
Client minimal pris en charge	Windows 10, version 1709 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server, version 1709 [applications de bureau uniquement]
En-tête	Mfapi.h