SpatialSurfaceInfo Klasse

  • Referenz

Definition

Namespace:
Windows.Perception.Spatial.Surfaces
Bearbeiten

Stellt eine Momentaufnahme von Metadaten für eine Oberfläche dar, die in der Umgebung des Benutzers beobachtet wird.

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
Vererbung
Object Platform::Object IInspectable SpatialSurfaceInfo
Attribute
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows-Anforderungen

Gerätefamilie
Windows 10 (eingeführt in 10.0.10586.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v2.0)

Hinweise

Gitterobjekte enthalten große Vertex- und Indexpuffer, und daher sind sie schwer zu halten, wenn Sie keinen guten Grund haben. Für eine effiziente Verwendung in Rendering oder Physik wird erwartet, dass eine App das Gitter und die Pufferobjekte zwischenspeichert, an denen sie interessiert ist, und dass sie Gitter für Bereiche ausgibt, in denen der Benutzer nicht mehr arbeitet.

Sie können den Satz von SpatialSurfaceInfo-Instanzen verwenden, die Ihnen von SpatialSurfaceObserver zur Verfügung gestellt werden und das Gitternetz im zielgebundenen Volume darstellen, um Ihren Cache zu verwalten.

Wenn Sie die Eigenschaften Id und UpdateTime über mehrere Beobachtungen hinweg korrelieren, können Sie ein neues Gitter, ein aktualisiertes Gitter und ein entferntes Gitter identifizieren:

  • Wenn Ein SpatialSurfaceInfo mit einer ID angezeigt wird, die Sie noch nicht gesehen haben, behandeln Sie es als neues Gitter.
  • Wenn Ein SpatialSurfaceInfo mit einer bekannten ID, aber mit einem neuen UpdateTime-Objekt angezeigt wird, behandeln Sie es als aktualisiertes Gitter.
  • Wenn Ein SpatialSurfaceInfo mit einer bekannten ID nicht mehr angezeigt wird, behandeln Sie es als entferntes Gitter.

Da es sich um eine Momentaufnahme handelt, ändert sich die UpdateTime-Eigenschaft im Laufe der Zeit nicht. Um festzustellen, ob das Gitter dieser Oberfläche aktualisiert wurde oder ob eine Oberfläche aus dem umgebenden Volume entfernt oder verschoben wurde, kehren Sie zum SpatialSurfaceObserver zurück, und rufen Sie entweder GetObservedSurfaces für jeden Frame auf, oder behandeln Sie das ObservedSurfacesChanged-Ereignis .

Eigenschaften

Id

Ruft den persistenten Bezeichner für diese Oberfläche ab.
UpdateTime

Ruft den Zeitpunkt der letzten Aktualisierung ab, der durch diese Oberflächenmetadaten Momentaufnahme dargestellt wird.

Methoden

TryComputeLatestMeshAsync(Double)

Generiert ein Gitterobjekt und dessen Vertex- und Indexpuffer für diese Oberfläche. Dadurch wird das detaillierteste Gitter ausgewählt, das die angegebene Dreieckdichte in Dreiecken pro Kubikmeter nicht überschreitet.
TryComputeLatestMeshAsync(Double, SpatialSurfaceMeshOptions)

Generiert ein Gitterobjekt und dessen Vertex- und Indexpuffer für diese Oberfläche mit den angegebenen Gittergenerierungsoptionen. Dadurch wird das detaillierteste Gitter ausgewählt, das die angegebene Dreieckdichte in Dreiecken pro Kubikmeter nicht überschreitet.
TryGetBounds(SpatialCoordinateSystem)

Ruft die Grenzen dieser Fläche ab, ausgedrückt im angegebenen Koordinatensystem.

Gilt für:

Weitere Informationen