SpatialSurfaceInfo Classe

  • Riferimento

Definizione

Spazio dei nomi:
Windows.Perception.Spatial.Surfaces
Modifica

Rappresenta uno snapshot dei metadati per una superficie osservata nell'ambiente circostante dell'utente.

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
Ereditarietà
Object Platform::Object IInspectable SpatialSurfaceInfo
Attributi
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisiti Windows

Famiglia di dispositivi
Windows 10 (è stato introdotto in 10.0.10586.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract
Windows.Foundation.UniversalApiContract (è stato introdotto in v2.0)

Commenti

Gli oggetti Mesh contengono buffer di vertici e indici di grandi dimensioni e quindi sono pesanti da contenere se non si ha un buon motivo. Per un uso efficiente nel rendering o nella fisica, è previsto che un'app memorizza nella cache gli oggetti mesh e buffer a cui è interessato e generi mesh per le aree in cui l'utente non funziona più.

È possibile usare il set di istanze spatialSurfaceInfo fornite da SpatialSurfaceObserver, che rappresenta la mesh presente nel volume di delimitazione di destinazione, per gestire la cache.

La correlazione delle proprietà Id e UpdateTime tra più osservazioni consente di identificare nuove mesh, mesh aggiornata e mesh rimossa:

  • Se viene visualizzato un Elemento SpatialSurfaceInfo con un ID non visualizzato in precedenza, considerarlo come una nuova mesh.
  • Se viene visualizzato un Elemento SpatialSurfaceInfo con un ID noto, ma con un nuovo updateTime, considerarlo come mesh aggiornata.
  • Se spatialSurfaceInfo non viene più visualizzato con un ID noto, considerarlo come mesh rimossa.

Poiché si tratta di uno snapshot, la proprietà UpdateTime non cambierà nel tempo. Per verificare se la mesh di questa superficie è stata aggiornata o se una superficie è stata rimossa o spostata all'esterno del volume di delimitazione, tornare al server SpatialSurfaceObserver e chiamare GetObservedSurfaces ogni frame o gestire l'evento ObservedSurfacesChanged .

Proprietà

Id

Ottiene l'identificatore permanente per questa superficie.
UpdateTime

Ottiene l'ora dell'ultimo aggiornamento rappresentata da questo snapshot dei metadati della superficie.

Metodi

TryComputeLatestMeshAsync(Double)

Genera un oggetto mesh e i relativi buffer di indice e vertice per questa superficie. In questo modo viene scelta la mesh più dettagliata che non supera la densità del triangolo specificata, in triangoli per metro cubico.
TryComputeLatestMeshAsync(Double, SpatialSurfaceMeshOptions)

Genera un oggetto mesh e i relativi buffer di indice e vertice per questa superficie, con le opzioni di generazione di mesh specificate. In questo modo viene scelta la mesh più dettagliata che non supera la densità del triangolo specificata, in triangoli per metro cubico.
TryGetBounds(SpatialCoordinateSystem)

Ottiene i limiti di questa superficie, espressi nel sistema di coordinate specificato.

Si applica a

Vedi anche