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)

指定した座標系で表される、このサーフェスの境界を取得します。

適用対象

こちらもご覧ください