스태틱 메시에서 UV 채널 사용하기

에디터 스크립팅(Editor Scripting) > 스태틱 메시(Static Mesh) 카테고리에서 UV 채널을 관리하는 데 필요한 노드를 찾을 수 있습니다.

이러한 함수는 모두 일반적으로 에디터 스크립팅 > 에셋 라이브러리(Asset Library) > Load Asset 노드를 호출하여 로드해야 하는 스태틱 메시 에셋과 함께 작동합니다.

UV 채널을 변경하면 에셋도 변경됩니다. 유지해야 하는 변경 사항이 있는 경우 에디터 스크립팅 > 에셋 라이브러리 > Save Asset 또는 Save Loaded Asset 같은 노드를 사용해야 할 수도 있습니다. 자세한 내용은 아래의 예시를 참고하세요.

UV 채널 나열하기

Get Num UVChannels 노드를 사용하여 지정된 스태틱 메시 에셋에 현재 UV 채널이 얼마나 많이 있는지 확인할 수 있습니다.

예를 들면 다음과 같습니다.

전체 크기로 보려면 이미지를 클릭하세요.

UV 채널 제거하기

각 UV 채널은 각 버텍스의 텍스처 좌표를 스태틱 메시의 일부로 저장하므로 사용하지 않는 매핑을 삭제하면 런타임 메모리를 어느 정도 절약할 수 있습니다.

UV 채널을 제거하려면 Remove UV Channel 노드를 호출합니다. 그런 다음 제거하려는 스태틱 메시 에셋과 UV 채널 인덱스를 전달합니다.

예를 들면 다음과 같습니다.

전체 크기로 보려면 이미지를 클릭하세요.

목록에 이미 있는 UV 채널 중 지정된 인덱스 다음에 있는 다른 모든 UV 채널은 한 칸씩 위로 올라가 제거된 항목으로 인한 공백을 채웁니다.

새 UV 채널 추가하기

스태틱 메시 에셋에는 다음 노드 중 아무 노드나 호출하여 새 UV 채널을 추가할 수 있습니다.

• Add UV Channel - 기존 채널 목록 끝에 새 채널을 추가합니다.
• Insert UV Channel - 지정한 인덱스에 새 채널을 추가하고 다른 UV 채널은 목록에서 한 칸씩 아래로 내립니다. UV 채널의 배열은 분산시킬 수 없습니다. 즉, 새 채널은 목록에서 기존의 다른 채널 옆에만 삽입할 수 있습니다. 예를 들어 목록에 UV 채널이 3개(인덱스 0, 1, 2) 있는 경우, 새 채널을 인덱스 3으로 추가할 수는 있지만 인덱스 4로는 추가할 수 없습니다.

전체 크기로 보려면 이미지를 클릭하세요.

새 매핑은 비어 있습니다. 새 매핑을 사용하려면 메시 지오메트리를 프로젝션(아래 참고)하거나 이 매핑을 라이트맵 생성 대상으로 사용하여 먼저 채워야 합니다.

UV 채널에 메시 지오메트리 언랩하기

스태틱 메시 에디터를 사용하여 스태틱 메시 지오메트리를 구성하는 트라이앵글을 자동으로 펼치고 평탄화하여 새 UV 매핑을 생성할 수 있습니다. 트라이앵글의 표면 영역은 근처에 있는 트라이앵글의 인접성을 보존하기 위해 자동으로 조정되며, 인접한 표면 간의 각도가 설정된 한계치와 교차하는 모든 위치에는 이음새가 생깁니다.

Generate Unwrapped UVs 노드를 사용합니다. 이 노드에는 다음을 지정해야 합니다.

• 수정하려는 스태틱 메시 에셋에 대한 참조
• 언랩된 UV를 저장할 채널 인덱스. 이 채널이 아직 없는 경우 언랩 프로세스 중에 생성됩니다.
• 언랩 후에도 연결되어 있는 면에 맞닿은 두 면 사이의 최대 각도. 이 값을 올리면 별도의 UV '아일랜드' 수가 최소화되어 인접성을 유지하는 트라이앵글의 수를 늘리고 텍스처 매핑이 끊길 수 있는 이음새의 수를 줄입니다. 하지만 이 경우 트라이앵글의 인접성을 유지하려면 2D 공간에서 트라이앵글 크기를 보다 극적으로 바꿔야 할 수 있기 때문에 래핑된 텍스처에 더 많은 디스토션을 유발할 수도 있습니다.

예를 들면 다음과 같습니다.

전체 크기로 보려면 이미지를 클릭하세요.

UV 채널에 메시 지오메트리 프로젝션하기

스태틱 메시 내 트라이앵글을 2D 평면이나 단순 3D 볼륨으로 프로젝션하여 새 UV 매핑을 생성할 수 있습니다.

평면 프로젝션

Generate Planar UV Channel 노드를 사용하여 스태틱 메시 지오메트리를 평면에 프로젝션합니다. 이 유형의 프로젝션은 스태틱 메시의 한 면만 텍스처를 래핑하는 경우에 사용합니다.

예를 들면 다음과 같습니다.

전체 크기로 보려면 이미지를 클릭하세요.

원기둥 프로젝션

Generate Cylindrical UV Channel 노드를 사용하여 스태틱 메시 지오메트리를 원기둥 측면과 윗면, 밑면에 프로젝션합니다.

예를 들면 다음과 같습니다.

전체 크기로 보려면 이미지를 클릭하세요.

박스 프로젝션

Generate Box UV Channel 노드를 사용하여 스태틱 메시 지오메트리를 큐브의 각 면에 프로젝션합니다.

예를 들어 다음 스크립트는 스태틱 메시와 거의 같은 크기의 박스를 만든 후 스태틱 메시의 지오메트리를 박스의 측면에 프로젝션하여 새로운 UV 매핑을 만듭니다.

전체 크기로 보려면 이미지를 클릭하세요.

unreal.EditorStaticMeshLibrary 클래스에서 LOD 관리 함수를 찾을 수 있습니다.

이 함수는 전부 스태틱 메시 에셋과 함께 작동하며, 주로 unreal.EditorAssetLibrary.load_asset과 같은 함수를 호출하여 로드해야 합니다.

UV 채널을 변경하면 에셋도 변경됩니다. 변경 사항을 유지하려는 경우에는 unreal.EditorAssetLibrary.save_asset 또는 unreal.EditorAssetLibrary.save_loaded_asset 등의 함수를 사용해야 합니다.

UV 채널 나열하기

또 unreal.EditorStaticMeshLibrary.get_num_uv_channels 함수를 사용하여 주어진 스태틱 메시 에셋에 현재 UV 채널이 얼마나 많이 있는지 확인할 수도 있습니다.

예를 들면 다음과 같습니다.

	import unreal
	asset_name = '/Game/Path/MyStaticMeshAsset'
	# 스태틱 메시 에셋을 로드합니다.
	loaded_asset = unreal.EditorAssetLibrary.load_asset(asset_name)
	# 에셋에 저장된 UV 채널 수를 구합니다.
	num_uv_channels = unreal.EditorStaticMeshLibrary.get_num_uv_channels(asset_name)
	print("Number of UV channels: " + str(num_uv_channels))
Copy full snippet

UV 채널 제거하기

각 UV 채널은 각 버텍스의 텍스처 좌표를 스태틱 메시의 일부로 저장하므로, 사용하지 않는 매핑을 삭제하면 런타임 메모리를 어느 정도 절약할 수 있습니다.

UV 채널을 제거하려면 unreal.EditorStaticMeshLibrary.remove_uv_channel 함수를 호출합니다. 그런 다음 제거하려는 스태틱 메시 에셋과 UV 채널 인덱스를 전달합니다.

예를 들면 다음과 같습니다.

	import unreal
	asset_name = '/Game/Path/MyStaticMeshAsset'
	# 스태틱 메시 에셋을 로드합니다.
	loaded_asset = unreal.EditorAssetLibrary.load_asset(asset_name)
	# 에셋에 저장된 UV 채널 수를 구합니다.
	num_uv_channels = unreal.EditorStaticMeshLibrary.get_num_uv_channels(asset_name)
	# 목록의 마지막 항목을 제거합니다.
	channel_to_remove = num_uv_channels - 1
	unreal.EditorStaticMeshLibrary.remove_uv_channel(asset_name, channel_to_remove)
	# 변경된 에셋을 저장합니다.
	unreal.EditorAssetLibrary.save_asset(asset_name)
Copy full snippet

목록에 이미 있는 UV 채널 중 지정된 인덱스 다음에 있는 다른 모든 UV 채널은 한 칸씩 위로 올라가 제거된 항목으로 인한 공백을 채웁니다.

새 UV 채널 추가하기

스태틱 메시 에셋에는 다음 함수 중 아무 거나 호출하여 신규 UV 채널을 추가할 수 있습니다.

• unreal.EditorStaticMeshLibrary.add_uv_channel - 기존 채널 목록 끝에 새 채널을 추가합니다.
• unreal.EditorStaticMeshLibrary.insert_uv_channel - 지정한 인덱스에 새 채널을 추가하고, 다른 UV 채널은 목록에서 한 칸씩 아래로 내립니다. UV 채널의 배열은 분산시킬 수 없습니다. 즉, 새 채널은 목록에서 기존의 다른 채널 옆에만 삽입할 수 있습니다. 예를 들어 목록에 UV 채널이 3개(인덱스 0, 1, 2) 있는 경우, 새 채널을 인덱스 3으로 추가할 수는 있지만 인덱스 4로는 추가할 수 없습니다.

예를 들면 다음과 같습니다.

	import unreal
	asset_name = '/Game/Path/MyStaticMeshAsset'
	# 스태틱 메시 에셋을 로드합니다.
	loaded_asset = unreal.EditorAssetLibrary.load_asset(asset_name)
	# 에셋에 저장된 UV 채널 수를 구합니다.
	num_uv_channels = unreal.EditorStaticMeshLibrary.get_num_uv_channels(asset_name)
	print("Number of UV channels before: " + str(num_uv_channels))
	# 목록 끝에 하나를 추가합니다.
	unreal.EditorStaticMeshLibrary.add_uv_channel(asset_name)
	# 목록 처음에 하나를 추가합니다.
	unreal.EditorStaticMeshLibrary.insert_uv_channel(asset_name, 0)
	# 에셋에 저장된 새 UV 채널 수를 구합니다.
	num_uv_channels = unreal.EditorStaticMeshLibrary.get_num_uv_channels(asset_name)
	print("Number of UV channels after: " + str(num_uv_channels))
	# 변경된 에셋을 저장합니다.
	unreal.EditorAssetLibrary.save_asset(asset_name)
Copy full snippet

새 매핑은 비어 있습니다. 새 매핑을 사용하려면 메시 지오메트리를 프로젝션(아래 참고)하거나 이 매핑을 라이트맵 생성 대상으로 사용하여 먼저 채워야 합니다.

UV 채널에 메시 지오메트리 언랩하기

스태틱 메시 에디터를 사용하여 스태틱 메시 지오메트리를 구성하는 트라이앵글을 자동으로 펼치고 평탄화하여 새 UV 매핑을 생성할 수 있습니다. 트라이앵글의 표면 영역은 근처에 있는 트라이앵글의 인접성을 보존하기 위해 자동으로 조정되며, 인접한 표면 간의 각도가 설정된 한계치와 교차하는 모든 위치에는 이음새가 생깁니다.

unreal.UVGenerationFlattenMapping.generate_flatten_mapping_u_vs() 함수를 사용합니다. 그리고 다음을 전달합니다.

• 수정하려는 스태틱 메시 에셋에 대한 참조
• 언랩된 UV를 저장할 채널 인덱스. 이 채널이 아직 없는 경우 언랩 프로세스 중에 생성됩니다.
• 언랩 후에도 연결되어 있는 면에 맞닿은 두 면 사이의 최대 각도(도 단위)입니다. 이 값을 올리면 별도의 UV '아일랜드' 수가 최소화되어 인접성을 유지하는 트라이앵글의 수를 늘리고 텍스처 매핑이 끊길 수 있는 이음새의 수를 줄입니다. 하지만 이 경우 트라이앵글의 인접성을 유지하려면 2D 공간에서 트라이앵글 크기를 보다 극적으로 바꿔야 할 수 있기 때문에 래핑된 텍스처에 더 많은 디스토션을 유발할 수도 있습니다.

예를 들면 다음과 같습니다.

	import unreal
	asset_name = '/Game/Meshes/StaticMesh'
	# 스태틱 메시 에셋을 로드합니다.
	loaded_asset = unreal.EditorAssetLibrary.load_asset(asset_name)
	# 저장할 UV 채널을 지정합니다.
	channel_index = 2
	# 각도 한계치를 설정합니다.
	angle_threshold = 55
	# 메시를 UV 채널에 언랩합니다.
	unreal.UVGenerationFlattenMapping.generate_flatten_mapping_u_vs(loaded_asset, channel_index, angle_threshold)
	# 변경된 에셋을 저장합니다.
	unreal.EditorAssetLibrary.save_asset(asset_name)
Copy full snippet

UV채널에 메시 지오메트리 프로젝션하기

스태틱 메시 내 트라이앵글을 2D 평면이나 단순 3D 볼륨으로 프로젝션하여 새 UV 매핑을 생성할 수 있습니다.

이 기능은 현재 언리얼 에디터 스크립팅 API에만 노출되어 있으며 스태틱 메시 에디터의 UI에는 노출되어 있지 않습니다. 하지만 3ds Max 등에서 제공하는 메시 프로젝션 비주얼 툴에 이미 익숙한 경우 해당 API에 필요한 프로세스 및 세팅은 비교적 쉽게 이해할 수 있습니다. 관련된 배경 지식은 3ds Max 도움말의 UVW 맵 모디파이어를 참고하세요.

평면 프로젝션

unreal.EditorStaticMeshLibrary.generate_planar_uv_channel 함수를 사용하여 스태틱 메시 지오메트리를 평면에 프로젝션합니다. 이 유형의 프로젝션은 스태틱 메시의 한 면만 텍스처를 래핑하는 경우에 사용합니다.

예를 들면 다음과 같습니다.

	import unreal
	asset_name = '/Game/Path/MyStaticMeshAsset'
	# 스태틱 메시 에셋을 로드합니다.
	loaded_asset = unreal.EditorAssetLibrary.load_asset(asset_name)
	# 프로젝션할 LOD를 지정합니다.
	lod_index = 0
	# 프로젝션에 새 채널을 추가합니다.
	num_uv_channels = unreal.EditorStaticMeshLibrary.get_num_uv_channels(asset_name)
	unreal.EditorStaticMeshLibrary.add_uv_channel(asset_name)
	channel_index = num_uv_channels
	# 프로젝션 평면 또는 "기즈모"를 구성합니다.
	bbox = loaded_asset.get_bounding_box()
	gizmo_pos = ((bbox.min + bbox.max) * 0.5) # Find the center of the object's bounding box.
	# 회전 각도(각도 단위)을 설정합니다.
	pitch = 0 # Around the X axis
	yaw = 0 # Around the Y axis
	roll = 0 # Around the Z axis
	gizmo_orientation = unreal.Rotator(pitch, yaw, roll)
	# 값을 높이거나 낮추면 프로젝션도 커지거나 작아집니다.
	tiling = unreal.Vector2D(1, 1)
	# 스태틱 메시 지오메트리를 UV 채널에 프로젝션합니다.
	unreal.EditorStaticMeshLibrary.generate_planar_uv_channel(loaded_asset, lod_index, channel_index, gizmo_pos, gizmo_orientation, tiling)
	# 변경된 에셋을 저장합니다.
	unreal.EditorAssetLibrary.save_asset(asset_name)
Copy full snippet

원기둥 프로젝션

unreal.EditorStaticMeshLibrary.generate_cylindrical_uv_channel 함수를 사용하여 스태틱 메시 지오메트리를 원기둥 측면과 윗면, 밑면에 프로젝션합니다.

예를 들면 다음과 같습니다.

	import unreal
	asset_name = '/Game/Path/MyStaticMeshAsset'
	# 스태틱 메시 에셋을 로드합니다.
	loaded_asset = unreal.EditorAssetLibrary.load_asset(asset_name)
	# 프로젝션할 LOD를 지정합니다.
	lod_index = 0
	# 프로젝션에 새 채널을 추가합니다.
	num_uv_channels = unreal.EditorStaticMeshLibrary.get_num_uv_channels(asset_name)
	unreal.EditorStaticMeshLibrary.add_uv_channel(asset_name)
	channel_index = num_uv_channels
	# 프로젝션 원기둥 또는 "기즈모"를 구성합니다.
	bbox = loaded_asset.get_bounding_box()
	gizmo_pos = ((bbox.min + bbox.max) * 0.5) # Find the center of the object's bounding box.
	# 회전 각도(각도 단위)을 설정합니다.
	pitch = 0 # Around the X axis
	yaw = 0 # Around the Y axis
	roll = 0 # Around the Z axis
	gizmo_orientation = unreal.Rotator(pitch, yaw, roll)
	# 값을 높이거나 낮추면 프로젝션도 커지거나 작아집니다.
	tiling = unreal.Vector2D(1, 1)
	# 스태틱 메시 지오메트리를 UV 채널에 프로젝션합니다.
	unreal.EditorStaticMeshLibrary.generate_cylindrical_uv_channel(teapot, lod_index, channel_index, gizmo_pos, gizmo_orientation, tiling)
	# 변경된 에셋을 저장합니다.
	unreal.EditorAssetLibrary.save_asset(asset_name)
Copy full snippet

박스 프로젝션

unreal.EditorStaticMeshLibrary.generate_box_uv_channel 함수를 사용하여 스태틱 메시 지오메트리를 큐브의 면에 프로젝션합니다.

예를 들어 다음 스크립트는 스태틱 메시와 거의 같은 크기의 박스를 만든 후 스태틱 메시의 지오메트리를 박스의 측면에 프로젝션하여 새로운 UV 매핑을 만듭니다.

	import unreal
	asset_name = '/Game/Path/MyStaticMeshAsset'
	# 스태틱 메시 에셋을 로드합니다.
	loaded_asset = unreal.EditorAssetLibrary.load_asset(asset_name)
	# 프로젝션할 LOD를 지정합니다.
	lod_index = 0
	# 프로젝션에 새 채널을 추가합니다.
	num_uv_channels = unreal.EditorStaticMeshLibrary.get_num_uv_channels(asset_name)
	unreal.EditorStaticMeshLibrary.add_uv_channel(asset_name)
	channel_index = num_uv_channels
	# 프로젝션 볼륨 또는 "기즈모"를 구성합니다.
	bbox = loaded_asset.get_bounding_box()
	gizmo_pos = ((bbox.min + bbox.max) * 0.5) # Find the center of the object's bounding box.
	# 회전 각도(각도 단위)을 설정합니다.
	pitch = 0 # Around the X axis
	yaw = 0 # Around the Y axis
	roll = 0 # Around the Z axis
	gizmo_orientation = unreal.Rotator(pitch, yaw, roll)
	# 박스 크기를 구합니다.
	gizmo_size = bbox.max - bbox.min
	# 스태틱 메시 지오메트리를 UV 채널에 프로젝션합니다.
	unreal.EditorStaticMeshLibrary.generate_box_uv_channel(box, channel_index, lod_index, gizmo_pos, gizmo_orientation, gizmo_size)
	# 변경된 에셋을 저장합니다.
	unreal.EditorAssetLibrary.save_asset(asset_name)
Copy full snippet