ブループリントおよび Python でスタティックメッシュを使用してコリジョンを設定する

スタティックメッシュ コリジョンの管理が必要なノードは、[Editor Scripting] > [Static Mesh] カテゴリに表示されます。

コリジョンを設定するとスタティック メッシュ アセットに変更が加えられます。加える変更を維持する場合は、後から Save Asset または Save Loaded Asset などのノードも使用する必要があります。

スタティック メッシュ コリジョンの管理が必要なほとんどの関数は unreal.EditorStaticMeshLibrary クラスにあります。

LOD を設定することで、スタティック メッシュ アセットに変更が加えられます。加える変更を維持する場合は、後から unreal.EditorAssetLibrary.save_asset() または unreal.EditorAssetLibrary.save_loaded_asset() などの関数も使用する必要があります。

単純化された新しいコリジョン形状をスタティック メッシュに追加するには、Add Simple Collisions ノードを使用します。Shape Type の入力値を使用して、追加するコリジョン形状を制御します。これらのオプションは、スタティック メッシュ エディタの [Collision] メニューに表示されるものと同じです。

単純化された新しいコリジョン形状をスタティック メッシュに追加するには、unreal.EditorStaticMeshLibrary.add_simple_collisions() 関数を使用します。

修正したい unreal.StaticMesh オブジェクト。 作成するコリジョン プリミティブの種類を表示するunreal.ScriptingCollisionShapeType 列挙型変数からの項目これらのオプションは、スタティック メッシュ エディタの [Collision] メニューに表示されるものと同じです。

次に例を示します。

import unreal asset_path = "/Game/ArchVis/Mesh" def add_box_collision (static_mesh): # 代わりに .SPHERE, .CAPSULE, .NDOP10_X, .NDOP10_Y, .NDOP10_Z, .NDOP18, .NDOP26 を使用することもできます。 shape_type = unreal.ScriptingCollisionShapeType.BOX unreal.EditorStaticMeshLibrary.add_simple_collisions(static_mesh, shape_type) unreal.EditorAssetLibrary.save_loaded_asset(static_mesh) # get a list of all Assets in the path. all_assets = unreal.EditorAssetLibrary.list_assets(asset_path) # load them all into memory. all_assets_loaded = [unreal.EditorAssetLibrary.load_asset(a) for a in all_assets] # filter the list to include only Static Meshes. static_mesh_assets = unreal.EditorFilterLibrary.by_class(all_assets_loaded, unreal.StaticMesh) # run the function above on each Static Mesh in the list. map(add_box_collision, static_mesh_assets)

スタティック メッシュの可視ジオメトリから凸型コリジョン形状を自動生成するには、 Set Convex Decomposition Collisions ノードを使用します。

このノードの入力値は、スタティック メッシュ エディタのユーザー インターフェースで [Collisions] > [Auto Convex Collisions] を選択した際に入力するよう求められるオプションと同じです。これらは、生成したコリジョン メッシュの複雑度と忠実度を制御します。一般的に、より大きな値にすると、コリジョン メッシュがスタティック メッシュの可視ジオメトリに近づきますが、ランタイム時のシミュレーションでの負荷も高くなります。

スタティック メッシュの可視ジオメトリから凸型コリジョン形状を自動生成するには、unreal.EditorStaticMeshLibrary.set_convex_decomposition_collisions() 関数を使用します。

修正したい unreal.StaticMesh オブジェクト。 最大ハル数、ハル当たりの最大頂点数およびハルの精度を定義する 3 つの整数。これらのパラメータは、スタティック メッシュ エディタのユーザー インターフェースで [Collisions] > [Auto Convex Collisions] を選択した際に入力するよう求められるオプションと同じです。これらは、生成したコリジョン メッシュの複雑度と忠実度を制御します。一般的に、より大きな値にすると、コリジョン メッシュがスタティック メッシュの可視ジオメトリに近づきますが、ランタイム時のシミュレーションでの負荷も高くなります。

次に例を示します。

import unreal asset_path = "/Game/ArchVis/Mesh" def set_convex_collision (static_mesh): unreal.EditorStaticMeshLibrary.set_convex_decomposition_collisions(static_mesh, 4, 12, 460000) unreal.EditorAssetLibrary.save_loaded_asset(static_mesh) # get a list of all Assets in the path. all_assets = unreal.EditorAssetLibrary.list_assets(asset_path)# load them all into memory. all_assets_loaded = [unreal.EditorAssetLibrary.load_asset(a) for a in all_assets]# filter the list to include only Static Meshes. static_mesh_assets = unreal.EditorFilterLibrary.by_class(all_assets_loaded, unreal.StaticMesh)# run the function above on each Static Mesh in the list. map(set_convex_collision, static_mesh_assets)

Remove Collisions ノードを使用して、スタティック メッシュに割り当てられているすべてのコリジョン メッシュをクリアすることができます。

次に、「単純な」物理コリジョン テストにではメッシュは検出されなくなりますが、スタティック メッシュの可視ジオメトリも対象となる「詳細な」テストでは検出されます。「Simple コリジョンと Complex コリジョン」も参照してください。

unreal.EditorStaticMeshLibrary.remove_collisions() 関数を使用して、スタティック メッシュに割り当てられているすべてのコリジョン メッシュをクリアすることができます。

次に例を示します。

import unreal asset_path = "/Game/ArchVis/Mesh" def remove_collisions (static_mesh): unreal.EditorStaticMeshLibrary.remove_collisions(static_mesh) unreal.EditorAssetLibrary.save_loaded_asset(static_mesh) # get a list of all Assets in the path. all_assets = unreal.EditorAssetLibrary.list_assets(asset_path)# load them all into memory. all_assets_loaded = [unreal.EditorAssetLibrary.load_asset(a) for a in all_assets]# filter the list to include only Static Meshes. static_mesh_assets = unreal.EditorFilterLibrary.by_class(all_assets_loaded, unreal.StaticMesh)# run the function above on each Static Mesh in the list. map(remove_collision, static_mesh_assets)

次に、「単純な」物理コリジョン テストにではメッシュは検出されなくなりますが、スタティック メッシュの可視ジオメトリも対象となる「詳細な」テストでは検出されます。「Simple コリジョンと Complex コリジョン」も参照してください。

## コリジョンに LOD を使用する

スタティック メッシュに対して既に詳細度 (LOD) が設定されている場合は、詳細度の低い LOD の 1 つをコリジョン メッシュとして使用できます。

unreal.StaticMesh オブジェクトの set_editor_property() 関数を呼び出して、使用する LOD のインデックスに lod_for_collision プロパティを設定します。例：

import unreal asset_path = "/Game/ArchVis/Mesh" def use_lod_for_collisions (static_mesh): static_mesh.set_editor_property("lod_for_collision", 3) unreal.EditorAssetLibrary.save_loaded_asset(static_mesh) # get a list of all Assets in the path. all_assets = unreal.EditorAssetLibrary.list_assets(asset_path) # load them all into memory. all_assets_loaded = [unreal.EditorAssetLibrary.load_asset(a) for a in all_assets] # filter the list to include only Static Meshes. static_mesh_assets = unreal.EditorFilterLibrary.by_class(all_assets_loaded, unreal.StaticMesh) # run the function above on each Static Mesh in the list. map(use_lod_for_collision, static_mesh_assets)

「LOD のコリジョンのセットアップ方法」も参照してください。