Spatial Mapping Renderer

Spatial Mapping Renderer コンポーネントは、空間マッピングしたサーフェスを表示します。これは視覚的にサーフェスをデバッグしたり、環境に視覚的なエフェクトを加えるのに利用できます。

Spatial Mapping システムは、Spatial Mapping Renderer コンポーネントに現実世界の変化を定期的に送信します。コンポーネントが変化を受信すると、サーフェスのデータは Mesh Filter と Mesh Renderer コンポーネントを持つゲームオブジェクトにベイクされます。Spatial Mapping Renderer コンポーネントはサーフェス (の情報を持つ) ゲームオブジェクトの生存期間を管理します。つまり、Spatial Mapping Renderer コンポーネントは、シーンにおけるサーフェスゲームオブジェクトの Mesh Renderer の作成、更新、削除を処理します。

Render Settings

以下の表は、Spatial Mapping Renderer コンポーネントで可能なすべてのレンダー設定を説明しています。

General Settings

以下は Spatial Mapping Renderer と Spatial Mapping Collider コンポーネントで共通のプロパティーです。

Level of Detail

Spatial Mapping コンポーネントでは、各コンポーネントが生成する空間メッシュの LOD を、以下の画像に表示された 3 種類 Low、Medium、High のいずれかに指定できます。

可能な場合は、Spatial Mapping Colliders の Level of Detail を Low に設定します。これにより、衝突計算のパフォーマンスが向上し、パワーの消費が軽減されます。ただし、Level of Detail を Low に設定すると、アプリケーションの視覚的効果に悪影響をもたらす可能性があります。

Spatial Mapping Renderer の使用

Render State

このコンポーネントを使うと、生成されたすべてのサーフェスで簡単に動的にマテリアルを変更することができます。Unity は事前に構築済みの 2 種類のマテリアルタイプを提供しています。

Occlusion Material

このマテリアルは、ゲームオブジェクトを透明にしますが、そのゲームオブジェクトを通してホログラムを見ることはできません。例えば、現実世界の机の下にゲームで使うホログラフィックオブジェクトを隠す必要がある場合に利用できます。

Visual Material

このマテリアルは、Unity が Spatial Mapping Renderer コンポーネントのすべてのサーフェスに適用するワイヤーフレームマテリアルです。デフォルトのワイヤーフレームシェーダーでは、ワイヤーフレームの色は現実世界の距離を表します。通常は、これがデバッグに最も便利なオプションですが、視覚効果にも使用できます。シェーダーは距離を示すためにカラーマッピングを使用します。以下の表は、カラーマッピングを示しています。

新しいマテリアルを Visual Material か Occlusion Material のいずれかに指定するとき、該当するサーフェスゲームオブジェクトのマテリアルは自動的に変更されるわけではありません。新しいマテリアルをすべてのサーフェスに適用するためには、Render Setting を新たに変更したマテリアル (Visual Material か Occlusion Material) に設定する必要があります。

Unity エディターから（シーンのゲームオブジェクトに直接）__Render State__ の Occlusion Material、Visual Material プロパティーを割り当てただけの場合、Spatial Mapping は Spatial Mapping Renderer コンポーネントと同時にそれらを破棄します。 ただし、Spatial Mapping は、コンポーネントをスクリプトを通して割り当てられたり、変更された Visualization マテリアル や Occlusion マテリアル を破棄しないため、手動で破棄する必要があります。

以下のコードスニペットは、Spatial Mapping が実行時にすべてのサーフェスゲームオブジェクトに動的に適用するマテリアルを変更します。

SpatialMappingRenderer renderer = spatialMappingGameObject.AddComponent<SpatialMappingRenderer>();
renderer.visualMaterial = new Material(Shader.Find("VR/SpatialMapping/Wireframe"));
renderer.renderState = SpatialMappingRenderer.RenderState.Visualization;

サーフェスゲームオブジェクト

Spatial Mapping Renderer コンポーネントは、それぞれ につき 1 組のサーフェスゲームオブジェクトを作成します。これらは、サーフェスゲームオブジェクトの親となるシーンの下に表示されます。

Spatial Mapping Renderer がサーフェスゲームオブジェクトを生成するときに、以下のコンポーネントが含まれます。

• Mesh Filter

• World Anchor

• Mesh Renderer

• 共有の マテリアル (Visualization マテリアルか Occlusion マテリアルかのいずれか。Render State 設定によります)

シーンに複数の Spatial Mapping Renderer コンポーネントを追加すると、各コンポーネントはそれぞれ 1 組のサーフェスゲームオブジェクトを生成します。例えば、Spatial Mapping Renderer コンポーネントを持つ 2 つのゲームオブジェクトがある場合、シーンには ランタイムに各コンポーネントによって生成された 2 組のサーフェスゲームオブジェクトが含まれます。これは、最適化を行う上で注意する必要があります。

• 2018–05–01 編集レビュー を行ってパブリッシュされたページ

• Hololens の空間マッピングは 2017.3 に更新