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에서 도입되었습니다.)

설명

메시 개체는 큰 꼭짓점 및 인덱스 버퍼를 포함하므로 충분한 이유가 없으면 버퍼를 유지해야 합니다. 렌더링 또는 물리학에서 효율적으로 사용하기 위해 앱은 관심 있는 메시 및 버퍼 개체를 캐시하고 사용자가 더 이상 작동하지 않는 영역에 대해 메시를 throw해야 합니다.

SpatialSurfaceObserver에서 제공한 SpatialSurfaceInfo 인스턴스 집합을 사용하여 캐시를 관리하기 위해 대상 경계 볼륨에 있는 메시를 나타낼 수 있습니다.

ID 및 UpdateTime 속성을 여러 관찰에서 상관 관계를 지정하면 새 메시, 업데이트된 메시 및 제거된 메시를 식별할 수 있습니다.

• 이전에 본 적이 없는 ID가 있는 SpatialSurfaceInfo가 표시되면 새 메시로 처리합니다.
• 알려진 ID가 있지만 새 UpdateTime이 있는 SpatialSurfaceInfo가 표시되는 경우 업데이트된 메시로 처리합니다.
• 알려진 ID가 있는 SpatialSurfaceInfo가 더 이상 표시되지 않으면 제거된 메시로 처리합니다.

스냅샷 UpdateTime 속성은 시간이 지남에 따라 변경되지 않습니다. 이 표면의 메시가 업데이트되었는지 또는 표면이 경계 볼륨에서 제거 또는 이동되었는지 확인하려면 SpatialSurfaceObserver로 돌아가서 각 프레임마다 GetObservedSurfaces 를 호출하거나 ObservedSurfacesChanged 이벤트를 처리합니다.

속성

Id	이 표면의 영구 식별자를 가져옵니다.
UpdateTime	이 표면 메타데이터 스냅샷 표시되는 마지막 업데이트 시간을 가져옵니다.

메서드

TryComputeLatestMeshAsync(Double)	이 표면에 대한 메시 개체와 해당 꼭짓점 및 인덱스 버퍼를 생성합니다. 이렇게 하면 지정된 삼각형 밀도를 초과하지 않는 가장 자세한 메시(입방 미터당 삼각형)를 선택합니다.
TryComputeLatestMeshAsync(Double, SpatialSurfaceMeshOptions)	지정된 메시 생성 옵션을 사용하여 이 표면에 대한 메시 개체와 해당 꼭짓점 및 인덱스 버퍼를 생성합니다. 이렇게 하면 지정된 삼각형 밀도를 초과하지 않는 가장 자세한 메시(입방 미터당 삼각형)를 선택합니다.
TryGetBounds(SpatialCoordinateSystem)	지정된 좌표계에 표현된 이 표면의 경계를 가져옵니다.

추가 정보

• 홀로그램 공간 매핑 샘플