スタティックメッシュでの 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))

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)

指定したインデックスのチャンネルが削除されると、リストに残ったすべての UV チャンネルは、削除によって空いたスペースを埋めるように上に移動されます。

新規 UV チャンネルを追加する

新規 UV チャンネルをスタティックメッシュ アセットに、次の関数のいずれかを呼び出すことによって追加できます。

• unreal.EditorStaticMeshLibrary.add_uv_channel - 既存のチャンネル リストの最後に新しいチャンネルを追加します。

• unreal.EditorStaticMeshLibrary.insert_uv_channel - 指定したインデックスで新しいチャンネルを追加します。リストで他の UV チャンネルのインデックスを 1 つずつ移動します。UV チャンネルの配列に間を空けることはできないことに注意してください。隣に別の既存のチャンネルがある場所にのみ新しいチャンネルを挿入できます。例えば、リストに 3 つの 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)

新しいマッピングは空なので、使用する前に、メッシュ ジオメトリを投影するか (下記を参照)、ライトマップ生成の宛先として使用することで入力を行います。

メッシュ ジオメトリの UV チャンネルにアンラップする

スタティックメッシュ エディタを使用して、スタティックメッシュ ジオメトリを構成する三角ポリゴンを自動的に展開および平坦化することにより、新しい UV マッピングを作成できます。三角ポリゴンのサーフェス領域は、三角ポリゴンの隣接されたままになるように自動的に調整され、隣接するサーフェス間の角度が設定したしきい値を超えると継ぎ目が追加されます。

unreal.UVGenerationFlattenMapping.generate_flatten_mapping_u_vs() 関数を使用します。これに次を渡します。

• 変更するスタティックメッシュ アセットへの参照。

• アンラップされた UV を保存する UV チャンネルのインデックス。この UV チャンネルが存在しない場合は、アンラップを行うプロセスで作成されます。

• アンラップ後も接続されたままになっている面の、2 つの隣接する面の間の最大角度。この値を上げると、個別の 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)

メッシュ ジオメトリを UV チャンネルに投影する

新しい UV マッピングは、スタティックメッシュのトライアングルを 2D 平面またはシンプルな 3D ボリュームに投影することで作成できます。

これは現在、スタティックメッシュ エディタの UI ではなく、Unreal Editor スクリプティング API でのみ公開されていますただし、3ds Max のツールのような、メッシュ投影用のビジュアル ツールの知識がある場合は、API で必要なプロセスと設定が簡単に理解できます。詳細については、3ds Max ヘルプの UVW Map Modifier をご参照ください。

平面投影

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)

円筒投影

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)

ボックス投影

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)   # Find the center of the object's bounding box.
# 回転角 (度単位) を設定します。
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)