次の方法で共有


HolographicQuadLayer クラス

定義

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

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
属性
実装

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()

アンマネージ リソースの解放またはリセットに関連付けられているアプリケーション定義のタスクを実行します。

適用対象