SpatialSurfaceInfo 类

定义

命名空间:

Windows.Perception.Spatial.Surfaces

表示在用户周围环境中观察到的图面的元数据快照。

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

继承

Object Platform::Object IInspectable SpatialSurfaceInfo

属性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 要求

设备系列	Windows 10 (在 10.0.10586.0 - for Xbox, see UWP features that aren't yet supported on Xbox 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v2.0 中引入)

注解

网格对象包含较大的顶点和索引缓冲区，因此，如果你没有充分的理由，它们会非常重。 为了在呈现或物理方面高效使用，应用应缓存其感兴趣的网格和缓冲区对象，并为用户不再操作的区域抛出网格。

可以使用 SpatialSurfaceObserver 提供的 SpatialSurfaceInfo 实例集，表示目标边界卷中存在的网格，以便管理缓存。

跨多个观察点关联 Id 和 UpdateTime 属性可以识别新网格、更新的网格和已删除的网格：

• 如果看到具有以前从未见过的 ID 的 SpatialSurfaceInfo，请将其视为新网格。
• 如果看到具有已知 ID 但具有新 UpdateTime 的 SpatialSurfaceInfo，请将其视为已更新的网格。
• 如果不再看到具有已知 ID 的 SpatialSurfaceInfo，请将其视为已删除的网格。

由于这是一个快照，因此 UpdateTime 属性不会随时间而更改。 若要查看此表面的网格是否已更新，或者表面是否已移除或移出边界卷，请返回 SpatialSurfaceObserver 并调用 GetObservedSurfaces 每帧或处理 ObservedSurfacesChanged 事件。

属性

Id	获取此图面的持久标识符。
UpdateTime	获取此图面元数据快照表示的上次更新时间。

方法

TryComputeLatestMeshAsync(Double)	为此图面生成网格对象及其顶点和索引缓冲区。 这将选择不超过指定三角形密度（以每立方米三角形为单位）的最详细网格。
TryComputeLatestMeshAsync(Double, SpatialSurfaceMeshOptions)	使用指定的网格生成选项为此图面生成网格对象及其顶点和索引缓冲区。 这将选择不超过指定三角形密度（以每立方米三角形为单位）的最详细网格。
TryGetBounds(SpatialCoordinateSystem)	获取此图面的边界，以指定的坐标系表示。

另请参阅

• 全息空间映射示例