GenerateMinimapTexture ja
このページでは、生成したダンジョンのミニマップを
テクスチャアセットとして保存する方法 と
実行時に Widget へ表示する方法 の 2 つに分けて説明します。
最初は、まずエディタ上でテクスチャを生成できることを確認してください。
そのあとで、実行時の UI 表示やアイコン表示へ進むと理解しやすくなります。
- エディタでミニマップテクスチャを生成できる
- 実行時にミニマップを UI に表示できる
- 必要に応じてアイコンを重ねて表示できる
- エディタでテクスチャを生成するには、直前にダンジョンを生成していること が必要です
- 実行時に表示するには、
ADungeonGenerateActorからミニマップ用オブジェクトを取得します - 最初はテクスチャだけを確認し、アイコン表示はあとから追加すると切り分けやすくなります
- QuickStart.ja.md が完了している
- ダンジョンを正常に生成できる
- エディタの
Window > DungeonGeneratorでプレビューできる、またはレベルにADungeonGenerateActorを配置している
まずは、コンテンツブラウザに保存されるミニマップテクスチャを作ります。
この方法は、見た目の確認や UI 試作に向いています。
ミニマップテクスチャは、直前に生成したダンジョン情報 を使って作られます。
まだダンジョンを生成していない場合は、先に Generate dungeon を実行してください。
ダンジョン生成情報が有効な場合だけ、次のボタンを使えます。
Generate texture with sizeGenerate texture with scale
ボタンが押せない場合は、ダンジョンが正常に生成されていない可能性があります。
目的に応じて、どちらかのボタンを使います。
-
Generate texture with size
出力サイズを直接決めたいときに向いています -
Generate texture with scale
密度を基準に出力したいときに向いています
ボタンを押すと、テクスチャアセットがコンテンツブラウザの ProceduralTextures フォルダに作成されます。
ミニマップは 階層ごとに別テクスチャ として生成されます。
多階層ダンジョンでも、今どの高さにいるか把握しやすくなります。
下層の階層ほど薄い色で表現されます。
ゲーム中にダンジョンを生成する場合は、テクスチャアセットを保存せず、
ミニマップをそのまま Widget に表示できます。
ADungeonGenerateActor によってダンジョンが生成されると、
DungeonMinimapTextureLayer オブジェクトを取得できます。
DungeonMinimapTextureLayer から、プレイヤーの高さに応じた現在階層のテクスチャを取り出します。
取り出したテクスチャを Widget の Brush に設定して表示します。
ミニマップにプレイヤー位置や目標物のアイコンを出すと、探索しやすくなります。
アイコン表示の補助には DungeonIconWidget を使います。
まず、ブラシに表示したいアイコンを設定します。
表示位置の登録には Register or Set を使います。
同じ ID のアイコンがすでに存在する場合は更新として扱えます。
不要になったアイコンは Unregister で登録を解除します。
- テクスチャ生成ボタンを押すと
ProceduralTexturesにアセットが作られる - 階層ごとにテクスチャが分かれている
- プレイヤーの高さに応じて現在階層のミニマップが切り替わる
- アイコンが期待した位置に表示される
-
Generate texture with size/Generate texture with scaleが押せない
直前にダンジョンが生成されているか確認してください - テクスチャは作れたが UI に何も表示されない
DungeonMinimapTextureLayerから取得したテクスチャを Widget 側へ設定できているか確認してください - 表示される階層がずれる
プレイヤーの高さからどの階層を選ぶかの条件を見直してください - アイコンが出ない
Register or Setの ID と表示座標、ブラシ設定を見直してください
実際の組み込み例は、サンプルプロジェクトの Content/Widget/Main/PlayGameWidget が参考になります。