블루프린트와 Python 에서 스태틱 메시로 콜리전 구성

unreal.EditorStaticMeshLibrary 클래스에서 스태틱 메시 콜리전 관리에 필요한 함수 대부분을 찾을 수 있습니다.

LOD 를 설정하면 스태틱 메시 애셋이 수정됩니다. 변경사항을 유지한다 가정하면, 나중에 unreal.EditorAssetLibrary.save_asset() 또는 unreal.EditorAssetLibrary.save_loaded_asset() 과 같은 함수도 사용해야 합니다.

스태틱 메시에 단순화 콜리전 모양을 새로 추가하려면, 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)
# 경로의 모든 애셋 목록을 구합니다.
all_assets = unreal.EditorAssetLibrary.list_assets(asset_path)
# 모두 메모리에 로드합니다.
all_assets_loaded = [unreal.EditorAssetLibrary.load_asset(a) for a in all_assets]
# 스태틱 메시만 포함하도록 목록에 필터를 적용합니다.
static_mesh_assets = unreal.EditorFilterLibrary.by_class(all_assets_loaded, unreal.StaticMesh)
# 목록의 스태틱 메시마다 위 함수를 실행합니다.
map(add_box_collision, static_mesh_assets)

스태틱 메시의 보이는 지오메트리에서 컨벡스 콜리전 모양을 자동 생성하려면, unreal.EditorStaticMeshLibrary.set_convex_decomposition_collisions() 함수를 사용하세요. 전달할 내용은 다음과 같습니다.

• 수정하려는 unreal.StaticMesh 오브젝트입니다.

• 세 개의 정수로 최대 헐 수, 헐당 최대 버텍스 수, 헐 정밀도를 정의합니다. 이 파라미터는 스태틱 메시 에디터 유저 인터페이스에서 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)
# 경로의 모든 애셋 목록을 구합니다.
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]# 스태틱 메시만 포함하도록 목록에 필터를 적용합니다.
static_mesh_assets = unreal.EditorFilterLibrary.by_class(all_assets_loaded, unreal.StaticMesh)# 목록의 스태틱 메시마다 위 함수를 실행합니다.
map(set_convex_collision, static_mesh_assets)

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)
# 경로의 모든 애셋 목록을 구합니다.
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]# 스태틱 메시만 포함하도록 목록에 필터를 적용합니다.
static_mesh_assets = unreal.EditorFilterLibrary.by_class(all_assets_loaded, unreal.# 목록의 스태틱 메시마다 위 함수를 실행합니다.# 목록의 스태틱 메시마다 위 함수를 실행합니다.
map(remove_collision, static_mesh_assets)

이후 "단순" 피직스 콜리전 테스트에서는 메시를 찾을 수 없지만, 스태틱 메시의 보이는 지오메트리를 고려하는 "디테일" 데스트에서는 찾을 수 있습니다. 단순 vs 복합 콜리전 문서도 참고하세요.

콜리전에 LOD 사용

스태틱 메시에 이미 레벨 오브 디테일 (LOD) 설정을 한 경우, 콜리전 메시로 낮은 디테일의 LOD 중 하나를 사용할 수 있습니다.

unreal.StaticMesh 오브젝트에서 set_editor_property() 를 호출하고 lod_for_collision 프로퍼티를 사용하려는 LOD 인덱스로 설정합니다. 예:

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)
# 경로의 모든 애셋 목록을 구합니다.
all_assets = unreal.EditorAssetLibrary.list_assets(asset_path)
# 모두 메모리에 로드합니다.
all_assets_loaded = [unreal.EditorAssetLibrary.load_asset(a) for a in all_assets]
# 스태틱 메시만 포함하도록 목록에 필터를 적용합니다.
static_mesh_assets = unreal.EditorFilterLibrary.by_class(all_assets_loaded, unreal.StaticMesh)
# 목록의 스태틱 메시마다 위 함수를 실행합니다.
map(use_lod_for_collision, static_mesh_assets)

LOD 콜리전 설정 방법 문서도 참고하세요.