カスタム データでタグ付けする

NavTag データ形式

各 NavTag には次のものが含まれています。

• 指定する整数の配列。これらの値の意味は、全面的に開発者が定義します。
• NavTag を排他的とみなすべきかどうかを指定するフラグ。つまり、すべてのキャラクタが歩行不能となります。たとえば、上のイメージの「V」は排他的とタグ付けされ、NavMesh に事実上、穴を開けています。

NavTags は次のいずれかによって表されることがあります。

• 静的な NavTag クラス。これは通常、特定のパスのイベントや NavData 要素に関連付けられている NavTag を読み取るときに返されます。
• 可変の DynamicNavTag クラス。通常は、Gameware Navigation に提供する NavTags を構築するためにこのクラスを使用します。

生成時に NavTags を埋め込む

地形用に事前生成する静的 NavData に NavTags を埋め込むには複数の方法があります。

実行時に NavTags を動的に追加する

NavTags は実行時に動的に追加できます。それには、TagVolumes を生成して Databases に割り当てるか、動的障害管理システムによって提供される動的な BoxObstacle クラスと CylinderObstacle クラスを使用します。新しい TagVolume または障害物のエリアの NavMesh は、カスタム NavTag を反映するように自動的に再生成され、再三角形化されます。

詳細は、「動的な障害物や TagVolume を使用する」を参照してください。

NavTag カラー

NavTag に基づいて三角形と TagVolume をレンダリングするためのカラーを選択することができます。このようなカラーは NavTag をすばやく識別するのに役立ちます。

次の関数を使用して DynamicNavTag カラーを設定することができます。

• SetColor(VisualColor color): DynamicNavTag のカラーを、入力された VisualColor と置き換えます。
• SetColor(KyUInt8 r, KyUInt8 g, KyUInt8 b): DynamicNavTag のカラーを、入力された RGB カラーと置き換えます。

NavTag を排他に設定した場合、そのカラーは次の図に示すように自動的に赤に設定されます。

さらに、ランタイム TagVolume のデフォルトのカラーが、次の図に示すように暗いオレンジ色になっています。

NavTag カラーの次のパラメータが、GeneratorAdvancedParamaters クラスに追加されます。

• VisualColor m_emptyDefaultNavTagColor
• VisualColor m_nonEmptyDefaultNavTagColor
• VisualColor m_nonDefaultNavTagColor

これらのカラーは、生成時に自動的に NavTag に設定されます。m_emptyDefaultNavTagColor パラメータまたは m_nonEmptyDefaultNavTagColor パラメータは、デフォルトの NavTag が空であるかどうかに応じてデフォルトの NavTag に設定されます。これはデフォルトですべての三角形に適用されます。

m_nonDefaultNavTagColor パラメータは、次の場合に NavTag に設定されます。

• 三角形が NavTag 付きで提供されており、そのカラーがユーザによって変更されていない
• 生成 TagVolume が NavTag 付きで提供されており、そのカラーがユーザによって変更されていない

三角形や TagVolume を追加する前に NavTag のカラーを変更した場合、m_nonDefaultNavTagColor パラメータは設定されません。

これらのカラーは、Navigation Lab の Advanced Parameters パネルで変更することができます。次の図を参照してください。

次のメソッドが DynamicNavTag クラスに追加されます。

• DynamicNavTag::IsExclusive(): NavTag が排他の場合に true を返します。
• DynamicNavTag::IsOnNavMesh(): NavTag の現在のインスタンスが NavMesh の三角形に関連付けられている場合に true を返します。
• DynamicNavTag::IsOnNavGraph(): NavTag の現在のインスタンスが NavGraph のエッジまたは頂点に関連付けられている場合に true を返します。
• DynamicNavTag::IsFromGeneration(): NavTag の現在のインスタンスが生成中に NavMesh の三角形に関連付けられている場合に true を返します。NavTag の現在のインスタンスが、実行時の NavMesh の動的なタグ付けから取得されたものの場合、false を返します。
• DynamicNavTag::IsFromRuntime(): NavTag の現在のインスタンスが生成中に NavMesh の三角形に関連付けられている場合に false を返します。NavTag の現在のインスタンスが、実行時の NavMesh の動的なタグ付けから取得されたものの場合、true を返します。
• DynamicNavTag::IsGenerationDefault(): NavTag の現在のインスタンスが生成中の三角形のタグ付けに使用されるデフォルトの NavTag の場合に true を返します。
• DynamicNavTag::GetVisualColor(): NavTag の VisualColor を返します。

NavGraphs にタグ付けする

地形に NavGraphs を使用する場合は、頂点とエッジにも NavTags でタグを付けることができます。

1. NavGraph の設定に使用する NavGraphBlobBuilder を作成したら、NavGraphBlobBuilder::AddNavTag() のシーケンシャルな呼び出しに、NavGraph の頂点またはエッジに追加する各タイプの NavTag のインスタンスを渡します。NavTag の各タイプは、メソッドによって返されるインデックスで識別されます。
2. 頂点またはエッジを追加するたびに、NavGraphBlobBuilder::AddVertexWithNavTag() メソッド、NavGraphBlobBuilder::AddBidirectionalEdgeWithNavTag() メソッド、または NavGraphBlobBuilder::AddMonodirectionalEdgeWithNavTag() メソッドを使用して、頂点またはエッジにタグ付けする NavTag のタイプに対応するインデックスを渡します。

「NavGraph を作成する」を参照してください。

マージと衝突を処理する

異なる NavTags でタグ付けされた 2 つ以上のエリアがオーバーラップする場合、NavTags はマージされません。代わりに、NavTag クラスの < 演算子を呼び出すことによって下位にあると判定された NavTag が保持されます。

たとえば次のイメージでは、排他的ボリュームがオレンジ色のボリュームより低く、オレンジ色のボリュームが緑色のボリュームより低く、緑色のボリュームが青色のボリュームより低くなっています。

詳細については、navtag.h ファイルの実装を参照してください。