デモ・ランタイムガイド

小さい画面では、幅の広い表を横にスクロールするとすべての列を読めます。

デモを試し、各部品を確認する

1. Assets/DPTGames/Vertex_3D_Terrain/Vertex3DTerrain_Demo/VertexTerrain_DemoScene.unity を開きます。
2. 地形マテリアルと Ground Library を確認します。使用するマテリアルを Dynamic Biome Demo Controller に割り当てます。必要に応じて、Sun に Directional Light も指定します。
3. まず、地形マテリアルの Inspector で最初の見た目を設定します。コントローラーの + Capture Current Settings as NEW Profile をクリックしてプロファイルを作成し、Spring などの名前を付けます。
4. マテリアルの設定を実際に変更して次の見た目を作ります。もう一度キャプチャして Summer と名付けます。必要に応じて Autumn、Winter なども追加します。
5. 保存した状態に戻して編集するには、そのプロファイルの Apply Profile To Material をクリックします。保存済みの設定が実際の共有マテリアルに読み込まれます。編集内容を保存する場合は、続いて Capture Profile From Material をクリックします。
6. 最初のプロファイルを含め、それぞれの Transition Seconds、Easing、Channels to Animate を設定します。変更対象のバイオームスロットやライト、必要に応じて Wind を選択してください。各プロファイルの Animate To Profile を押すと、その状態まで移行して維持できます。
7. 全体の動作を確認するには、二つ以上のプロファイルをキャプチャし、Run Sequence From Start をクリックします。シーケンス再生と個別プロファイルへの移行は、どちらも Edit Mode と Play モードで使用できます。Pause、Resume、Stop & Restore で操作でき、Edit Mode では全シーケンスのスクラブも可能です。
8. Play モード開始時に自動再生したい場合は、Play On Start を有効にします。デモカメラで結果を確認します。
9. Surface Raycast Tester を使い、ペイントされた地表から返されるバイオーム ID を確認します。

Dynamic Biome Demo Controller

コンポーネントの Inspector 上部にある Open Documentation またはコンポーネントヘッダーの Help アイコンから、オンラインの Demo & Runtime Guide を開けます。

GameObject に DPT → Dynamic Biome Demo Controller を追加します。Terrain Material を指定するか、Renderer のある GameObject にコンポーネントを追加し、その Renderer の共有マテリアルを参照できるようにします。Directional Light の回転、強さ、色も補間する場合は Sun を指定します。

状態の作成は地形マテリアルの Inspector で行います。 Dynamic Biome の各スロット、対象バイオーム ID、Dusting、Scatter Density と Colour、Surface Overrides、Flow などをマテリアル側で設定します。これらのコントロールはデモコントローラー内には重複して配置されていません。キャプチャボタンを押した時点のマテリアル値が保存されます。

同じ共有マテリアルを使う地形は、すべて同じ変更を受けます。隣接する複数の地形タイルをまとめて変化させる場合に便利です。個別に変化させたい場合は別々のマテリアルを使ってください。

Inspector の各セクション

プロファイルに保存される内容

各プロファイルには四つの Modifier Slot が独立したスナップショットとして保存されます。各スロットの有効状態、バイオーム ID、Weight、Smoothness、Normal、Parallax、Emission、Flow、Dusting、Scatter Response が含まれます。対応する Stylized Lighting の値、割り当てた Sun の回転、強さ、色に加え、地形マテリアルの Wind の有効状態、Strength、Direction、Height To Tip も保存されます。

プロファイルはマテリアルの現在値を参照し続けるわけではありません。Winter を作るためにマテリアルを変更しても、以前にキャプチャした Autumn のスナップショットは変わりません。既存プロファイルを更新するときは、そのプロファイルのキャプチャボタンを使います。

Apply Profile To Material は、Channels to Animate のチェック状態に関係なく、保存された全設定を共有マテリアルと任意の Sun に即時適用します。Edit Mode で再生とプレビューを停止した状態で使用し、保存済みの見た目へ戻して編集する際に便利です。Unity Undo に対応し、保存済みプロファイルは変更しません。

一方、Animate To Profile は現在の見た目から補間を開始し、移行先プロファイルでチェックされたチャンネルだけを変更して、その結果を維持します。Edit Mode、Play モード、別のプロファイルへの移行中にも使用できます。

シェーダーの設定は 地形マテリアル設定、バイオームの Scatter Response がインスタンシングされた植生に与える影響は 3D Scatter ガイド を参照してください。

環境プロファイルとタイムライン

Environment Profiles は、季節、干ばつ、洪水、気温の変化などを表現するために利用できます。Run Sequence From Start は最初のプロファイルでチェックされたチャンネルを開始時の見た目に適用し、その後のプロファイルへ順番に移行します。Animate To Profile では、最初のプロファイルも含め、キャプチャ済みの任意のプロファイルを直接指定できます。

プロファイル 1 にも他のプロファイルと同じコントロールがあります。 Transition Seconds、Easing、Slot 1–4、Stylized Lighting、Directional Light、Wind を設定できます。チェックされていないチャンネルは現在値を維持します。最初にキャプチャしたプロファイルではすべてのチャンネルが初期選択され、それ以降の新規キャプチャでは前の確定状態との差分が検出されます。既存のチェック状態は保持されます。

一連のプロファイルをキャプチャする

1. Spring：マテリアルと必要に応じて Sun を設定し、+ Capture Current Settings as NEW Profile をクリックします。名前を Spring にします。これがタイムラインの開始状態です。
2. Summer：マテリアルとライトを夏の状態に変更し、同じボタンで再びキャプチャします。Summer と名付け、Transition Seconds に移行時間を設定します。
3. Autumn：Dusting、Scatter、ライティングなどを調整し、三つ目のプロファイルとして保存します。
4. Winter：積雪用の Dusting、少ない植生、寒色寄りのライティングなどを設定します。四つ目のプロファイルをキャプチャして移行時間を設定します。
5. 最初のプロファイル以外では、新規キャプチャ時に前の確定状態と異なるバイオーム、ライティング、風のチャンネルが自動選択されます。Channels to Animate は最初のプロファイルも含め手動で変更できます。チェックを外したチャンネルは現在値を維持します。
6. Preview In Edit Mode と Preview Normalized でシーケンスを確認し、Stop Preview & Restore Material で終了します。Loop を有効にすると、最後の状態から最初のプロファイルでチェックしたチャンネルへ戻ります。チェックしていないチャンネルは変更されません。

操作一覧

指定したプロファイルへ移行して状態を維持する

1. 目標の見た目をキャプチャします。個別のプロファイル要求には一つのキャプチャ済みプロファイルだけで十分です。
2. 移行先プロファイルの Transition Seconds、Easing、変更するチャンネルを設定します。最初のプロファイルにも同じコントロールがあります。
3. Animate To Profile をクリックします。移行が完了すると、進行バーに Holding: プロファイル名 と表示されます。
4. 別の状態が必要になったら、そのプロファイルを要求します。移行中でも、元の開始状態に戻ることなく、その時点で補間された見た目から新しい移行が始まります。

要求した状態は、別のプロファイル要求、Stop & Restore、シーケンスの再開始、コンポーネントのクリーンアップまで維持されます。個別プロファイルの要求は Loop によって自動的に次へ進みません。Pause は未完了の移行を停止し、Resume で続行します。移行済みの保持状態には再開すべき処理がありません。

環境プロファイルでの風の制御

地形マテリアルの Inspector で Enable Wind、Wind Strength、Wind Direction、Height To Tip を設定してからプロファイルをキャプチャします。そのプロファイルの Wind チャンネルにチェックすると、これらの値がアニメーションします。チェックを外すと風の現在値は維持されます。

風を無効にする移行では、強さをゼロまでフェードさせてから到達時にシェーダー機能を無効化します。有効にする移行では、ゼロから保存した強さへ徐々に変化します。Direction と Height To Tip も補間されます。Stylized Lighting と異なり、Wind チャンネルは機能の有効状態も切り替えられます。

風のデータが保存されていない古いプロファイルは、Wind にチェックがあっても現在の風を変更しません。風の設定を追加する場合は停止・復元し、古いプロファイルを適用してマテリアルの風を設定し、再キャプチャしてください。Scatter グループ側にも独自の Enable Wind の選択と対応マテリアルが必要です。全体の風をキャプチャしても、グループごとの風の設定は変更されません。

コードや UnityEvent からのプロファイル切り替え

AnimateToProfile(string profileName) で名前を指定するか、AnimateToProfile(int profileIndex) でリスト中の位置を指定できます。インデックスは 0 から始まります。 例えば controller.AnimateToProfile(0) は最初のプロファイルを要求します。名前の大文字と小文字は区別されません。重複する名前では最初に一致する項目が選択されるため、固有の名前を使用してください。無効な指定や未キャプチャのプロファイルでは警告が出て、進行中の移行は変更されません。

次の例を EnvironmentProfileRequests.cs として保存し、GameObject に追加して Demo Controller の参照を指定します。Winter と Summer という名前のプロファイルを用意し、ゲームロジックまたは UI から対応するメソッドを呼び出します。

using UnityEngine;
using DPT.Vertex3DTerrain.Demo;

public class EnvironmentProfileRequests : MonoBehaviour
{
    [SerializeField] private DPT_DynamicBiomeDemoController controller;

    public void RequestWinter()
    {
        if (controller != null)
            controller.AnimateToProfile("Winter");
    }

    public void RequestSummer()
    {
        if (controller != null)
            controller.AnimateToProfile("Summer");
    }
}

ラッパースクリプトなしで UnityEvent に接続する

1. UI Button の On Click() などにイベントを追加します。
2. Dynamic Biome Demo Controller がある GameObject を指定します。
3. 文字列または整数を受け取る AnimateToProfile メソッドを選択します。
4. Winter などのプロファイル名、または 0 から始まるインデックスを入力します。イベントを呼び出すと Inspector のボタンと同じように移行し、その状態を維持します。

再生状態を取得する

PlayFromStart() はシーケンス全体を実行します。PauseTimeline()、ResumeTimeline()、StopAndRestore() はどちらの再生方法にも対応します。SetTimelineNormalized(float) は個別要求セッション中に 0～1 の範囲でその移行をシークし、それ以外ではシーケンスを操作します。ApplyProfileToMaterial(int) と CaptureCurrentMaterialIntoProfile(int) は、再生とプレビューを停止した状態で使う Edit Mode の編集用メソッドです。

ライティングと移行の制限

• Stylized Lighting は任意です。 プレビューまたは再生開始時点で _STYLIZED_LIGHTING が有効な場合にのみ値をアニメーションします。コントローラーはシェーダーキーワードをオン・オフしません。Sun の移行は独立して動作します。
• 数値と色は補間されます。 Weight、Dusting Strength、Scatter Density と Colour、Flow Speed、Emission、シェーディング、Sun の回転などは指定時間に沿って変化します。
• ID とスイッチは離散的です。 対象バイオーム ID、Overlay Biome ID、シェーダー機能の切り替えは連続補間されません。滑らかに変化させたい場合は、可能な限り同じ対象 ID を使用し、Strength、Weight、Density を調整してください。
• 地形マテリアルで Dynamic Biomes を有効にする必要があります。全体スイッチが無効な場合、ライブ Modifier の効果は表示されません。
• プレビューは共有マテリアルを一時的に変更します。 アセット保存やマテリアル編集の前に停止・復元してください。Editor が予期せず終了した場合に備え、元のマテリアルを保存しておくと安全です。

プロファイルは地形の再ペイント、地形ジオメトリやシームの変更、水位の物理的な引き上げ、降水シミュレーションを行いません。ライブ Weight の変化は既存のペイント済みバイオームの寄与に作用します。雪の Dusting には適切なバイオーム ID と、あらかじめペイントされた Dusting マスクが必要です。

Scatter の安定したフェードと編集時の表示

Scatter の配置はペイントされたバイオームの範囲から生成されます。Dynamic Weight Multiplier と Scatter Density は、既存の安定したクランプ群から描画時に間引く方式です。泥、黄ばんだ草、干ばつなどを表現するために草の強さを下げても、毎ステップで配置を再生成しません。元の強さに戻すと同じ配置が復元されます。色の変更もライブで反映されます。

Strength は Scatter のフェード制御で、上限は 1 です。 Strength が 0 なら該当する動的 Scatter は非表示、0.5 ならおおむね半分、1 以上ならペイントされた設定量が表示されます。1 を超える値は地形シェーディングには影響する場合がありますが、Scatter の密度は増やしません。配置の最大密度を増やすには Scatter グループの Density を調整してください。Strength と Scatter Density Response は乗算され、重複するスロットの Weight Multiplier は上限適用前に合成されます。

季節によるバイオーム変更から除外したいクリスタルなどの Scatter には、そのグループの Wind の隣にある Static Scatter を有効にします。Static グループは Dynamic Biome の Weight、Scatter Density、Colour / Surface Overrides を無視します。ただし、ペイントやスカルプトに応じて配置は更新され、共有インスタンス数の上限も適用されます。

Scatter Settings の Disable While Brushing は、サーフェスまたはジオメトリのツールが選択されている間、ストロークの合間も含めて Scatter を非表示にし、配置更新を停止します。両方のツール選択を None にするか、地形ツールウィンドウを閉じると再表示されます。このオプションは Edit Mode のみ対象です。別の Update After Stroke は、非表示設定がオフのときストローク中も配置を表示し、ストローク終了後に影響を受けたソースを更新します。

Surface Raycast Tester

レイキャストは、Unity に「この線上にどのコライダーがあるか」を問い合わせます。テスターはヒットを表示し、次に地形の Surface Target にバイオームを問い合わせます。二つは別の処理です。コライダーに当たっても、サーフェスデータがあるとは限りません。

自分の地形にプローブを置く

1. 小さなテスト地形を塗り、メッシュを保存します。
2. ベイクするメッシュと同じ三角形配置の MeshCollider を用意します。
3. 地形ツールの Bake Surface Data を使います。
4. 適切な地形オブジェクトに DPT → Terrain Surface Target があり、ベイクした Surface Data が指定されていることを確認します。Renderer も必要です。
5. 地形の上に別の空オブジェクトを作り、DPT → Surface Raycast Tester を追加します。
6. Downward Probe、十分な Max Ray Distance、地形のコライダーを含むレイヤーマスクを指定します。
7. Scene Gizmos か Game HUD を有効にし、対象、三角形番号、ID、名前を確認します。異なる地表間でプローブを動かして比較します。

結果の読み方

Hit Object はレイを受けたコライダー、Triangle Index は参照する三角形番号です。Biome ID と Name が地表の結果、Hit Point、Normal、Distance は交点、法線、距離です。

当たっているのにバイオームが不明なら、Surface Target とデータを確認します。BoxCollider や SphereCollider は、この三角形ベースの処理で一致した地形 MeshCollider の代わりにはなりません。負の値など無効な三角形番号を、有効な問い合わせとして扱わないでください。

Terrain Demo Camera

確認用カメラに DPT → Terrain Demo Camera を追加します。自由移動とマウス視点操作ができます。歩行の物理、衝突回避、接地、惑星の重力は提供しません。

Movement Speed は通常の速度、Fast Multiplier は Shift の倍率、Mouse Sensitivity は視点の感度です。操作表示は、覚える間に便利です。小さな形状の確認では遅く、大きな地形を移動するときは速くします。

確認用カメラには衝突制御がないため、地形を通り抜けます。橋、洞窟、階段を実際に移動できるかは、自分のゲームプレイ用コントローラーで確認します。

サーフェスデータをゲームプレイに使う

基本の流れは、地形を塗る → サーフェスデータをベイクする → 地形に関連付ける → 一致するコライダーへレイを飛ばす → ID を読む → ゲーム側の反応を選ぶです。

ベイクしたアセットは、ライブの重み変更に使う候補 ID と重みを含め、三角形ごとの代表的な地表情報を記録します。Surface Target は、その情報とマテリアルの現在の修正を読みます。一回のヒットに一つの ID を返すもので、テクスチャ全体や見えているすべての素材の一覧を返すものではありません。

小さな連携例

以下を TerrainSurfaceProbe.cs として保存し、テスト地形の上のオブジェクトに追加します。地形のレイヤーと距離を設定し、コンポーネントのメニューの Read Surface で一回問い合わせます。Console 出力は例です。ゲームに組み込むときは、自分の音、パーティクル、移動設定の参照に置き換えてください。

using UnityEngine;
using DPT.Vertex3DTerrain;

public class TerrainSurfaceProbe : MonoBehaviour
{
    public LayerMask terrainLayers = ~0;
    public float distance = 2f;

    [ContextMenu("Read Surface")]
    public void ReadSurface()
    {
        if (!Physics.Raycast(transform.position, Vector3.down,
                out RaycastHit hit, distance, terrainLayers))
        {
            Debug.Log("指定距離内にコライダーがありません。");
            return;
        }

        if (hit.triangleIndex < 0)
        {
            Debug.Log("このコライダーには有効な地形の三角形番号がありません。");
            return;
        }

        if (DPT_TerrainSurfaceTarget.TryGetHitBiome(
                hit, out int biomeID, out string biomeName))
        {
            Debug.Log($"地表: {biomeName} (ID {biomeID})");
            // biomeID を使って、ゲーム側の処理を選びます。
        }
        else
        {
            Debug.Log("当たった対象に地形のサーフェスデータがありません。");
        }
    }
}

足音では、足音が発生するタイミングに、足やキャラクターの適した位置から問い合わせます。返った ID を、自分の音・効果の表に対応させます。ライブラリ変更後はその表も更新してください。名前は確認に便利ですが、問い合わせが返す数値はライブラリの ID です。

惑星や独自の重力では、例のワールド下方向を、自分のゲームの局所的な重力方向に置き換えます。このスクリプトで、その方向が自動推定されるわけではありません。

再ベイクするタイミング

• ゲームプレイで問い合わせる場所を塗り直した後。
• バイオームの追加、削除、並べ替えにより、データで使う ID が変わった後。
• 分割、削除、トンネル生成、簡略化などで三角形が変わった後。
• その他の形状変更により、ベイクや代表的な地表情報に影響した後。
• 簡略化した LOD コライダーなど、別のコライダーメッシュへ切り替えたとき。

通常の対応するライブ倍率は、問い合わせ時に読まれるため、毎回塗り直したり三角形データを作り直したりする必要はありません。ただし、候補はベイク済みのものです。古いベイクから、新しく塗った情報を読み出すことはできません。

問い合わせは見た目とどこまで一致するか

付属の問い合わせは代表的な地表の選択に役立ちますが、シェーダーが描く画素を完全に取得するものではありません。すべての境界や雪の領域で、カーソル下の見た目と正確に一致すると考えず、自分のゲームの要件で確認します。

正確な小領域、局所重力に合う雪、画素単位の被覆がゲームに必要なら、そのルール用の問い合わせを作り、検証してください。付属コンポーネントは、ここで説明した制約を持つ出発点です。

実行時・デモの問題

サポート

相談するときは、期待した結果、使った項目、実際に起きたことを説明してください。Unity のバージョン、選択したパイプライン、関連する設定のスクリーンショットも添えます。実行時の問い合わせの問題では、コライダーの種類と、最後にサーフェスデータをベイクした時期も記載してください。

DPT Games お問い合わせフォーム、または DPT Games Discord をご利用ください。

ページの先頭へ