SpatialSurfaceInfo Classe

  • Referência

Definição

Namespace:
Windows.Perception.Spatial.Surfaces
Editar

Representa uma instantâneo de metadados para uma superfície observada no ambiente do usuário.

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
Herança
Object Platform::Object IInspectable SpatialSurfaceInfo
Atributos
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos do Windows

Família de dispositivos
Windows 10 (introduzida na 10.0.10586.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract
Windows.Foundation.UniversalApiContract (introduzida na v2.0)

Comentários

Os objetos de malha contêm buffers de vértice e índice grandes e, portanto, eles são pesados para manter se você não tiver um bom motivo. Para uso eficiente em renderização ou física, espera-se que um aplicativo armazene em cache os objetos de malha e buffer em que está interessado e jogue fora a malha para áreas em que o usuário não está mais operando.

Você pode usar o conjunto de instâncias SpatialSurfaceInfo fornecidas por SpatialSurfaceObserver, representando qual malha está presente no volume delimitador de destino, a fim de gerenciar seu cache.

Correlacionar as propriedades Id e UpdateTime em várias observações permite identificar a nova malha, a malha atualizada e a malha removida:

  • Se você vir um SpatialSurfaceInfo com uma ID que não viu antes, trate-o como uma nova malha.
  • Se você vir um SpatialSurfaceInfo com uma ID conhecida, mas com um novo UpdateTime, trate-o como malha atualizada.
  • Se você não vir mais um SpatialSurfaceInfo com uma ID conhecida, trate-o como malha removida.

Como essa é uma instantâneo, a propriedade UpdateTime não será alterada ao longo do tempo. Para ver se a malha dessa superfície foi atualizada ou se uma superfície foi removida ou movida para fora do volume delimitador, retorne ao SpatialSurfaceObserver e chame GetObservedSurfaces em cada quadro ou manipule o evento ObservedSurfacesChanged .

Propriedades

Id

Obtém o identificador persistente para essa superfície.
UpdateTime

Obtém a hora da última atualização representada por esse instantâneo de metadados da superfície.

Métodos

TryComputeLatestMeshAsync(Double)

Gera um objeto de malha e seus buffers de vértice e índice para essa superfície. Isso escolhe a malha mais detalhada que não excede a densidade de triângulo especificada, em triângulos por medidor cúbico.
TryComputeLatestMeshAsync(Double, SpatialSurfaceMeshOptions)

Gera um objeto de malha e seus buffers de vértice e índice para essa superfície, com as opções de geração de malha especificadas. Isso escolhe a malha mais detalhada que não excede a densidade de triângulo especificada, em triângulos por medidor cúbico.
TryGetBounds(SpatialCoordinateSystem)

Obtém os limites dessa superfície, expressos no sistema de coordenadas especificado.

Aplica-se a

Confira também