SpatialSurfaceInfo Класс

  • Ссылка

Определение

Пространство имен:
Windows.Perception.Spatial.Surfaces
Изменить

Представляет snapshot метаданных для поверхности, наблюдаемой в окружении пользователя.

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)

Комментарии

Объекты сетки содержат большие буферы вершин и индексов, поэтому их тяжело удерживать, если у вас нет веских причин. Для эффективного использования в отрисовке или физике приложение должно кэшировать сетку и буфер объектов, в которых оно заинтересовано, и выбросить сетку для областей, где пользователь больше не работает.

Для управления кэшем можно использовать набор экземпляров SpatialSurfaceInfo, предоставленных spatialSurfaceObserver, которые представляют, какая сетка присутствует в целевом ограничивающем томе.

Сопоставление свойств Id и UpdateTime в нескольких наблюдениях позволяет определить новую, обновленную и удаленную сетку:

  • Если вы видите Объект SpatialSurfaceInfo с идентификатором, который вы ранее не видели, обработайте его как новую сетку.
  • Если вы видите SpatialSurfaceInfo с известным идентификатором, но с новым UpdateTime, обработайте его как обновленную сетку.
  • Если объект SpatialSurfaceInfo с известным идентификатором больше не отображается, обработайте его как удаленную сетку.

Так как это snapshot, свойство UpdateTime со временем не изменяется. Чтобы узнать, обновлена ли сетка этой поверхности, удалена ли поверхность или удалена из ограничивающего тома, вернитесь к spatialSurfaceObserver и вызовите Метод GetObservedSurfaces для каждого кадра или обработайте событие ObservedSurfacesChanged .

Свойства

Id

Возвращает постоянный идентификатор для этой поверхности.
UpdateTime

Возвращает время последнего обновления, представленное данным snapshot метаданных поверхности.

Методы

TryComputeLatestMeshAsync(Double)

Создает объект сетки, а также буферы вершин и индексов для этой поверхности. При этом выбирается наиболее подробная сетка, которая не превышает указанную плотность треугольника в треугольниках на кубический метр.
TryComputeLatestMeshAsync(Double, SpatialSurfaceMeshOptions)

Создает объект сетки, а также буферы вершин и индексов для этой поверхности с указанными параметрами создания сетки. При этом выбирается наиболее подробная сетка, которая не превышает указанную плотность треугольника в треугольниках на кубический метр.
TryGetBounds(SpatialCoordinateSystem)

Возвращает границы данной поверхности, выраженные в указанной системе координат.

Применяется к

См. также раздел