Partager via

SpatialSurfaceInfo Classe

  • Référence

Définition

Espace de noms:
Windows.Perception.Spatial.Surfaces
Modifier

Représente une instantané de métadonnées pour une surface observée dans l’environnement de l’utilisateur.

public ref class SpatialSurfaceInfo sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 131072)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class SpatialSurfaceInfo final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 131072)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class SpatialSurfaceInfo
Public NotInheritable Class SpatialSurfaceInfo
Héritage
Object Platform::Object IInspectable SpatialSurfaceInfo
Attributs
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Configuration requise pour Windows

Famille d’appareils
Windows 10 (introduit dans 10.0.10586.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract
Windows.Foundation.UniversalApiContract (introduit dans v2.0)

Remarques

Les objets mesh contiennent des mémoires tampons de vertex et d’index volumineuses. Ils sont donc lourds à conserver si vous n’avez pas de raison valable. Pour une utilisation efficace dans le rendu ou la physique, une application est censée mettre en cache les objets de maillage et de mémoire tampon qui l’intéressent, et pour jeter le maillage pour les zones où l’utilisateur ne fonctionne plus.

Vous pouvez utiliser l’ensemble d’instances SpatialSurfaceInfo qui vous a été fourni par SpatialSurfaceObserver, représentant le maillage présent dans le volume englobant ciblé, afin de gérer votre cache.

La corrélation des propriétés Id et UpdateTime entre plusieurs observations vous permet d’identifier le nouveau maillage, le maillage mis à jour et le maillage supprimé :

  • Si vous voyez un SpatialSurfaceInfo avec un ID que vous n’avez pas vu auparavant, traitez-le comme un nouveau maillage.
  • Si vous voyez un SpatialSurfaceInfo avec un ID connu, mais avec un nouveau UpdateTime, traitez-le comme un maillage mis à jour.
  • Si vous ne voyez plus de SpatialSurfaceInfo avec un ID connu, traitez-le comme un maillage supprimé.

Étant donné qu’il s’agit d’un instantané, la propriété UpdateTime ne changera pas au fil du temps. Pour voir si le maillage de cette surface a été mis à jour ou si une surface a été supprimée ou déplacée hors du volume englobant, revenez au SpatialSurfaceObserver et appelez GetObservedSurfaces chaque image ou gérez l’événement ObservedSurfacesChanged .

Propriétés

Id

Obtient l’identificateur persistant pour cette surface.
UpdateTime

Obtient l’heure de la dernière mise à jour représentée par cette instantané de métadonnées de surface.

Méthodes

TryComputeLatestMeshAsync(Double)

Génère un objet de maillage et ses tampons de vertex et d’index pour cette surface. Cela choisit le maillage le plus détaillé qui ne dépasse pas la densité de triangle spécifiée, en triangles par mètre cube.
TryComputeLatestMeshAsync(Double, SpatialSurfaceMeshOptions)

Génère un objet de maillage et ses tampons de vertex et d’index pour cette surface, avec les options de génération de maillage spécifiées. Cela choisit le maillage le plus détaillé qui ne dépasse pas la densité de triangle spécifiée, en triangles par mètre cube.
TryGetBounds(SpatialCoordinateSystem)

Obtient les limites de cette surface, exprimées dans le système de coordonnées spécifié.

S’applique à

Voir aussi