将UV通道用于静态网格体

你将在 编辑器脚本编写（Editor Scripting）> 静态网格体（Static Mesh） 类别下找到管理UV通道所需的节点。

所有这些函数都用于静态网格体资产，你通常需要调用 Editor Scripting> Asset Library> Load Asset 节点来加载该资产。

修改UV通道会修改资产。假如你需要保留所做的更改，此后你还需要使用 Editor Scripting> Asset Library> Save Asset 或 Save Loaded Asset 之类的节点。请参阅以下示例。

列出UV通道

你可以使用 Get Num UV Channels 节点了解给定静态网格体资产中目前存在多少个UV通道。

例如：

点击查看大图。

删除UV通道

每个UV通道将每个顶点的纹理坐标存储为静态网格体的一部分，这样你可以删除不使用的映射来节省一些运行时内存。

要删除UV通道，请调用 Remove UV Channel 节点。为其传递静态网格体资产以及你想删除的UV通道的索引。

例如：

点击查看大图。

列表中指定索引后面已经存在的其他所有UV通道会上移一个位置，填补所删除条目留下的空白。

添加新的UV通道

你可以调用以下任一节点，将新的UV通道添加到静态网格体资产：

• Add UV Channel - 在现有通道列表末尾添加新的通道。
• Insert UV Channel - 在你指定的索引处添加新的通道，将列表中的其他每个UV通道下移一个数字。请注意，UV通道的数组不能是稀疏的：你只能在列表中另一个现有通道旁边的位置插入新通道。例如，如果列表中有三个UV通道（索引0、1和2），你可以添加索引为3的新通道，但不能添加索引为4的新通道。

点击查看大图。

新的映射为空。你需要以某种方式填充它，然后才能使用，具体方法可以是投影网格体几何体（见下文），也可以是将其用作目标来生成光照贴图。

将网格体几何体解包到UV通道

你可以让静态网格体编辑器自动展开并展平组成静态网格体几何体的三角形，从而创建新的UV映射。三角形的表面区域会自动调整，以保留相邻三角形的相邻性，相邻表面之间的角度超出你设置的阈值的地方会引入接缝。

使用 Generate Unwrapped UVs 节点。你需要为此节点提供以下内容：

• 对你想修改的静态网格体资产的引用。
• 你想将解包的UV保存到的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通道添加到静态网格体资产：

• unreal.EditorStaticMeshLibrary.add_uv_channel - 在现有通道列表末尾添加新的通道。
• unreal.EditorStaticMeshLibrary.insert_uv_channel - 在你指定的索引处添加新的通道，将列表中的其他每个UV通道下移一个数字。请注意，UV通道的数组不能是稀疏的：你只能在列表中另一个现有通道旁边的位置插入新通道。例如，如果列表中有三个UV通道（索引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通道的索引。如果此通道尚不存在，解包过程将创建它。
• 要使两个相邻面在解包后保持连接，这两个面之间允许的最大角度（以度为单位）。该值越高，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
	# 为我们的投影添加新的UV通道。
	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)   # 找到对象的边界框的中心。
	# 设置旋转角度（以度为单位）。
	pitch = 0   # 围绕X轴
	yaw = 0     # 围绕Y轴
	roll = 0    # 围绕Z轴
	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
	# 为我们的投影添加新的UV通道。
	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)   # 找到对象的边界框的中心。
	# 设置旋转角度（以度为单位）。
	pitch = 0   # 围绕X轴
	yaw = 0     # 围绕Y轴
	roll = 0    # 围绕Z轴
	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
	# 为我们的投影添加新的UV通道。
	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)   # 找到对象的边界框的中心。
	# 设置旋转角度（以度为单位）。
	pitch = 0   # 围绕X轴
	yaw = 0     # 围绕Y轴
	roll = 0    # 围绕Z轴
	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