HolographicQuadLayer クラス

リファレンス

定義

名前空間:: Windows.Graphics.Holographic

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

編集

アプリのプライマリレンダリングコンテンツの上の指定した場所に表示されるシステムの保持テクスチャを表します。

public ref class HolographicQuadLayer sealed : IClosable

/// [Windows.Foundation.Metadata.Activatable(Windows.Graphics.Holographic.IHolographicQuadLayerFactory, 327680, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 327680)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class HolographicQuadLayer final : IClosable

[Windows.Foundation.Metadata.Activatable(typeof(Windows.Graphics.Holographic.IHolographicQuadLayerFactory), 327680, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 327680)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class HolographicQuadLayer : System.IDisposable

function HolographicQuadLayer(size, pixelFormat)

Public NotInheritable Class HolographicQuadLayer
Implements IDisposable

継承: Object Platform::Object IInspectable HolographicQuadLayer

属性: ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

実装: IClosable IDisposable

Windows の要件

デバイスファミリ	Windows 10 Fall Creators Update (10.0.16299.0 で導入)
API contract	Windows.Foundation.UniversalApiContract (v5.0 で導入)

注釈

クワッドレイヤーは、システムのホログラフィックコンポジターがアプリの代わりに世界の特定の場所にレンダリングするテクスチャです。これにより、コンポジターは最終的な合成イメージを生成するときに、そのクワッドテクスチャから直接サンプリングでき、テキスト品質が向上し、解像度の低いワールドコンテンツが可能になります。各フレームを塗りつぶす必要があるプライマリレイヤーのイミディエイトモードバックバッファーとは異なり、クワッドレイヤーは保持されます。特定の HolographicCamera に追加されると、各四角形レイヤーは、四角形レイヤーが移動、更新、または削除されるまで、そのフレームのプライマリレイヤーのバックバッファー上の指定した位置にレンダリングされ続けます。

クワッドレイヤーを表示するために、アプリは必要な HolographicQuadLayer インスタンスを作成し、HolographicCamera の変更可能な QuadLayers リストに追加します。保持されているクワッドレイヤーの更新を特定のイミディエイトモードのホログラフィックフレームと同期するために、アプリは HolographicFrame.GetQuadLayerUpdateParameters を呼び出して、そのフレームから HolographicQuadLayerUpdateParameters インスタンスを要求します。その HolographicQuadLayerUpdateParameters インスタンスで要求されたすべての更新は、そのフレームから適用されます。

アプリは、クワッドレイヤーを静止モードまたは表示相対モードで配置する場合があります。これは、明示的に移動しない場合、将来のフレームでの配置方法に影響します。

固定クワッドの場合、アプリは UpdateLocationWithStationaryMode を呼び出して、クワッドレイヤーを表示するワールド内の空間位置と向きを指定します。これにより、平面と、指定した位置を中心とする平面内のクワッドの 2D サイズが定義されます。
表示相対クワッドの場合、アプリは UpdateLocationWithDisplayRelativeMode を呼び出して、ディスプレイに対する相対的なワールド座標の空間位置と向きを指定します。

四角形レイヤーは、完全にプライマリレイヤーの上に、ペインターのアルゴリズムを使用して、指定した順序でレンダリングされます。レンダリング中に深度テストは行われません。ある四角形を別の四角形の前に移動するアプリでは、テクスチャバッファーを補充しなくてもレイヤーリスト内の四角形を並べ替えることができます。たとえば、シーンの読み込み中など、クワッドレイヤーのみをレンダリングするアプリでは、 IsPrimaryLayerEnabled を false に設定することで、プライマリレイヤーを完全に無効にすることができます。

アプリに四角形レイヤーが不要になった場合は、カメラからレイヤーを削除することでそのレイヤーを無効にできます。これにより、システムは割り当てられたコンテンツバッファーを再利用できます。アプリがレイヤーで完全に行われることを認識している場合は、完全に閉じる可能性があります。

HolographicQuadLayer オブジェクトは、デバイスベースのリソースを使用して保持する場合があることに注意してください。 HolographicQuadLayer を 1 回作成し、それを作成して破棄するのではなく、可能な限り再利用することをお勧めします。たとえば、メニューが起動されるたびにです。 HolographicQuadLayer オブジェクトは、Direct3D デバイスの紛失シナリオで破棄して再作成する必要があります。

コンストラクター

HolographicQuadLayer(Size)	既定のピクセル形式のDXGI_FORMAT_B8G8R8A8_UNORMを使用して、指定したテクスチャサイズの新しい四角形レイヤーを作成します。
HolographicQuadLayer(Size, DirectXPixelFormat)	指定したテクスチャサイズとピクセル形式で新しい四角形レイヤーを作成します。

プロパティ

PixelFormat	この四角形レイヤーを戻すテクスチャのピクセル形式。
Size	この四角形レイヤーを戻すテクスチャのサイズ (ピクセル単位)。

メソッド

Close()	クアッドレイヤーを閉じ、関連付けられているシステムリソースを再利用します。
Dispose()	アンマネージリソースの解放またはリセットに関連付けられているアプリケーション定義のタスクを実行します。

適用対象