attribut MF_MT_DEPTH_VALUE_UNIT

[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 les unités d’une valeur de profondeur dans une trame vidéo.

Type de données

UINT64

Notes

La valeur d’unité est une valeur UINT64 en nanomètres, comprise entre 1e et 9 mètres. Si cette valeur n’est pas présente, la valeur par défaut de l’unité est 1e-3, ce qui indique que chaque niveau de pixels est mesuré en 1 millimètre dans l’espace physique.

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 de la matière, de l’occlusion, ou hors plage, etc., la valeur de profondeur de 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 d’un matériau, d’une occlusion ou d’une distance hors plage, etc. Nous vous recommandons d’éviter d’attacher des métadonnées telles que des bits en valeur de profondeur, car cela entraîne généralement des difficultés lors de l’utilisation de ces valeurs dans le nuanceur de pixels. Utilisez plutôt 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 d’appareils photo 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 d’utiliser une valeur fixe telle que 0 pour l’invalidation.

Spécifications

Condition requise	Valeur
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