NavigationMesh - stingray.NavigationMesh オブジェクト リファレンス - Stingray Lua API リファレンス
説明
レベルのナビゲーション メッシュです。
コンストラクタとアクセサ 
その他の関連リファレンス項目
関数
 |
constrain_to_polygon ( self, p, poly ) : stingray.Vector3, boolean ポイント p を指定されたポリゴンに制限し、結果の位置を返します。
|
| |
destroy ( world, mesh )メッシュを破壊します。
|
world : | メッシュを所有するワールドです。 | |
mesh : | 破壊するメッシュです。 |
| この関数は値を返しません。 |
この関数は NavigationMesh.merge() で作成されたメッシュに対してのみ呼び出す必要があります。
注: メッシュを破壊する必要はありません。ワールドが破壊されると自動的にメッシュも破壊されます。メッシュを明示的に破壊する必要があるのはメモリを早く開放する必要がある場合のみです。
その他の関連リファレンス項目
| |
find_nearest_polygon ( self, p ) : integerポイント p に最も近いメッシュ内のポリゴンを検索して、そのインデックスを返します。
|
| |
find_polygon ( self, p ) : integer?ポイント p に最も近いメッシュ内のポリゴンを検索して、そのインデックスを返します。
|
self : | この関数を機能させるオブジェクト インスタンスを指定します。 この関数を呼び出す場合は、常にこの self パラメータを指定する必要があります。ドット . 呼び出し構文(オブジェクト指向のコロン : 呼び出し構文ではなく)を使用する必要があります。詳細については、この Stingray ヘルプ トピック、または Lua ドキュメントのこのページを参照してください。 | |
p : | 始点です。 |
integer? |
最も近いポリゴンのインデックスです(ポイントがメッシュの外側にある場合は nil)。 ? 表記は、このタイプが省略可能であることを示しています。ゼロ個または 1 個のインスタンスが存在します。 |
その他の関連リファレンス項目
| |
funnel ( self, path ) : integer[], integer[]ポリゴンのパスを指定すると、この関数はそのパスの右側および左側のエッジ頂点で構成される 2 つのリストを返します。
|
| |
is_obstructed ( self, poly ) : boolean指定されたインデックスが割り当てられているメッシュ内のノードの表示が妨げられているかどうかを示します。
|
| |
merge ( world, meshes, merge_tolerance ) : stingray.NavigationMeshmeshes テーブルで指定されたすべてのナビゲーション メッシュを合成して新しい NavigationMesh を作成します。
|
world : | 新しいメッシュを所有するワールドです。 | |
meshes : | 合成するナビゲーション メッシュをリストしたテーブルを指定します。 []表記は、この型が配列(メンバーのキーは連番、各要素の値は示されている型のインスタンス)であることを示します。 | |
merge_tolerance : | number | 隣接する 2 つの頂点を合成するときの最大距離をメートル単位で指定します。たとえば、merge_tolerance を 0.5 に設定すると、50cm 以内の距離にあるナビゲーション メッシュの頂点どうしがすべて合成されます。 |
|
新しく作成されたナビゲーション メッシュです。 |
この関数を呼び出すと、新しい NavigationMesh が指定されたワールドに作成されます。ワールドが破壊されるとナビゲーション メッシュも自動的に破壊されます。その前にナビゲーション メッシュを破壊するには、明示的に NavigationMesh.destroy() 関数を呼び出します。
合成を実行するには、合成されるエッジに沿ってすべての頂点が対応している必要があります。エッジが 1 つでも分割されていると、合成は実行されません。たとえば、次のようになります。
頂点どうしが対応しているので合成が実行されます。
合成は実行されません。
その他の関連リファレンス項目
| |
num_polygons ( ) : integerメッシュ内のポリゴンの数を取得します。
|
| |
num_vertices ( ) : integerメッシュ内の頂点の数を取得します。
|
| |
partial_search ( self, start, end, focus, max_search_nodes, max_distance ) : integer[]NavigationMesh.search() と同様に A* 検索を実行して最も近いパスを始点またはポリゴンから終点まで検索しますが、この関数は終点に達するパスが存在しない場合でも常にパスを返します。
|
| |
polygon_neighbors ( self, poly ) : any(integer, nil)+指定されたインデックスが割り当てられているポリゴンに隣接するポリゴンのインデックスを取得します。
|
| |
polygon_vertices ( self, poly ) : integer+指定されたインデックスが割り当てられているポリゴンの頂点のインデックスを取得します。
|
| |
project_to_polygon ( self, p, poly ) : stingray.Vector3指定されたポリゴンの平面に始点 p を投影します。
|
| |
search ( self, start, start_pos, end, end_pos, focus, max_search_nodes, max_distance ) : integer[]A* 検索を実行して最も近いパスを始点またはポリゴンから終点またはポリゴンまで検索し、見つかったパスを返します。
|
| |
search ( self, start, end, focus, max_search_nodes, max_distance ) : integer[]A* 検索を実行して最も近いパスを始点またはポリゴンから終点またはポリゴンまで検索し、見つかったパスを返します。
|
| |
search ( self, start, end, focus, max_search_nodes, max_distance ) : integer[]A* 検索を実行して最も近いパスを始点またはポリゴンから終点またはポリゴンまで検索し、見つかったパスを返します。
|
self : | この関数を機能させるオブジェクト インスタンスを指定します。 この関数を呼び出す場合は、常にこの self パラメータを指定する必要があります。ドット . 呼び出し構文(オブジェクト指向のコロン : 呼び出し構文ではなく)を使用する必要があります。詳細については、この Stingray ヘルプ トピック、または Lua ドキュメントのこのページを参照してください。 | |
start : | number | 最初に検索するポリゴンのインデックスです。 |
end : | number | 最後に検索するポリゴンのインデックスです。 |
focus : | number | どの程度アグレッシブに検索を行うかを指定します。1 よりも大きい値に設定すると、よりアグレッシブに検索が実行され、展開されるノード数が少なくなりますが、最短パスが必ず見つかるとは限りません。たとえば focus を 1.2 に設定すると、最短パスの 1.2 倍の長さまでのパスを返すことが許容されます。 |
max_search_nodes : | integer | 検索時に確認するグラフ ノードの最大数を指定します。この値を調整することで、検索の実行時間を制限できます。この値を低くすると、2 つのノード間にパスが存在している場合でも見つからない可能性があります。 |
max_distance : | number | 検索パスの最長距離を指定します。ターゲットまでのパスのうち、この値よりも短いパスが見つからなかった場合は、空のテーブルが返されます。 |
integer[] |
ポリゴン インデックスのテーブルとしてパスを返します。パスが見つからなかった場合は空のテーブルを返します。 []表記は、この型が配列(メンバーのキーは連番、各要素の値は示されている型のインスタンス)であることを示します。 |
その他の関連リファレンス項目
| |
set_obstructed ( self, poly, is_obstructed )メッシュ内で指定されたインデックスが割り当てられているポリゴンの表示が妨げられている状態かどうかを設定します。
|
| |
update_polygon ( self, p, poly ) : stingray.Vector3, stingray.Vector3, integer, booleanナビゲーション メッシュ上でキャラクタを移動するときに使用します。
|
| |
vertex ( self, v ) : stingray.Vector3指定されたインデックスが割り当てられている頂点の位置を取得します。
|
| |
visualize_last_search ( self, lines )指定された LineObject を使用してデバッグ用に最後の検索を視覚化します。
|