Utiliser des canaux UV avec des maillages statiques

Les nœuds dont vous avez besoin pour gérer les canaux UV se trouvent dans la catégorie Editor Scripting > Maillage statique.

Toutes ces fonctions sont disponibles avec une ressource de maillage statique, que vous devrez généralement charger en appelant le nœud Editor Scripting > Bibliothèque de ressources > Load Asset.

La modification des canaux UV modifie la ressource. En supposant que vous souhaitiez conserver les modifications que vous apportez, vous devez également utiliser un nœud tel que Editor Scripting > Bibliothèque de ressources > Save Asset ou Save Loaded Asset par la suite. Consultez les exemples ci-dessous.

Dresser la liste des canaux UV

Vous pouvez utiliser le nœud Get Num UV Channels pour déterminer le nombre de canaux UV qui existent actuellement dans une ressource de maillage statique donnée.

Par exemple :

Cliquez sur l'image pour l'afficher à taille réelle.

Supprimer un canal UV

Étant donné que chaque canal UV stocke les coordonnées de texture de chaque vertex dans le cadre du maillage statique, vous pouvez économiser de la mémoire lors de l'exécution en supprimant tous les texturages que vous n'utilisez pas.

Pour supprimer un canal UV, appelez le nœud Remove UV Channel. Transmettez-lui la ressource de maillage statique et l'index du canal UV que vous souhaitez supprimer.

Par exemple :

Cliquez sur l'image pour l'afficher à taille réelle.

Tous les autres canaux UV déjà présents dans la liste après l'index spécifié sont déplacés d'une position vers le haut pour remplir l'espace vide laissé par l'entrée supprimée.

Ajouter un nouveau canal UV

Vous pouvez ajouter un nouveau canal UV à votre ressource de maillage statique en appelant l'un des nœuds suivants :

• Add UV Channel - Ajoute le nouveau canal à la fin de la liste de canaux existante.
• Insert UV Channel - Ajoute le nouveau canal à l'index que vous spécifiez, en déplaçant chaque autre canal UV d'un numéro vers le bas dans la liste. Notez que la matrice des canaux UV ne peut pas être disséminée : vous ne pouvez insérer un nouveau canal qu'à une position dans la liste qui se trouve à la suite d'un autre canal existant. Par exemple, si la liste comporte trois canaux UV (index 0, 1 et 2), vous pouvez en ajouter un nouveau avec l'index 3, mais pas avec l'index 4.

Cliquez sur l'image pour l'afficher à taille réelle.

Le nouveau texturage est vide. Vous souhaitez le remplir d'une manière ou d'une autre avant de l'utiliser, soit en projetant la géométrie du maillage (voir ci-dessous), soit en l'utilisant comme destination pour la génération de textures de lumière.

Déballer la géométrie du maillage dans un canal UV

Vous pouvez créer de nouveaux texturages des UV en laissant l'éditeur de maillage statique déplier et aplanir automatiquement les triangles qui composent votre géométrie de maillage statique. La surface des triangles est automatiquement ajustée pour préserver la contiguïté des triangles voisins, et des jointures sont introduites partout où l'angle entre les surfaces adjacentes dépasse un seuil que vous définissez.

Utilisez le nœud Generate Unwrapped UVs. Vous devez attribuer à ce nœud :

• une référence à la ressource de maillage statique que vous souhaitez modifier ;
• l'index du canal UV où vous souhaitez que l'UV déballé soit enregistré (si ce canal n'existe pas encore, le processus de déballage le crée) ;
• l'angle maximal entre deux faces adjacentes pour que ces faces restent connectées après le déballage. L'augmentation de cette valeur minimise le nombre d'« îles » UV séparées, en conservant davantage de triangles connectés à leurs voisins et en réduisant le nombre de jointures susceptibles de provoquer des ruptures dans le texturage. Cependant, cela peut également introduire davantage de distorsion dans les textures enveloppées, car il est possible que les triangles doivent être redimensionnés de manière plus agressive dans l'espace 2D afin de rester connectés à leurs voisins.

Par exemple :

Cliquez sur l'image pour l'afficher à taille réelle.

Projeter la géométrie du maillage dans un canal UV

Vous pouvez créer de nouveaux texturages des UV en projetant les triangles du maillage statique sur un plan 2D ou un simple volume 3D.

Projection planaire

Utilisez le nœud Generate Planar UV Channel pour projeter votre géométrie de maillage statique sur un plan. Utilisez ce type de projection si un seul côté de votre maillage statique doit être entouré de textures.

Par exemple :

Cliquez sur l'image pour l'afficher à taille réelle.

Projection cylindrique

Utilisez le nœud Generate Cylindrical UV Channel pour projeter votre géométrie de maillage statique sur les côtés, le haut et le bas d'un cylindre.

Par exemple :

Cliquez sur l'image pour l'afficher à taille réelle.

Projection de boîte

Utilisez le nœud Generate Box UV Channel pour projeter votre géométrie de maillage statique sur les faces d'un cube.

Par exemple, le script suivant crée une boîte de la même taille approximative que le maillage statique, puis crée un nouveau texturage des UV en projetant la géométrie du maillage statique sur les côtés de cette boîte :

Cliquez sur l'image pour l'afficher à taille réelle.

Les fonctions de gestion de LOD se trouvent dans la classe unreal.EditorStaticMeshLibrary.

Toutes ces fonctions sont disponibles avec une ressource de maillage statique, que vous devez généralement charger en appelant une fonction comme unreal.EditorAssetLibrary.load_asset.

La modification des canaux UV modifie la ressource. En supposant que vous souhaitiez conserver les modifications que vous apportez, vous devez également utiliser une fonction comme unreal.EditorAssetLibrary.save_asset ou unreal.EditorAssetLibrary.save_loaded_asset par la suite.

Dresser la liste des canaux UV

Vous pouvez utiliser la fonction unreal.EditorStaticMeshLibrary.get_num_uv_channels pour déterminer le nombre de canaux UV qui existent actuellement dans une ressource de maillage statique donnée.

Par exemple :

	import unreal
	asset_name = '/Game/Path/MyStaticMeshAsset'
	# Chargez la ressource de maillage statique.
	loaded_asset = unreal.EditorAssetLibrary.load_asset(asset_name)
	# Obtenir le nombre de canaux UV enregistrés dans la ressource.
	num_uv_channels = unreal.EditorStaticMeshLibrary.get_num_uv_channels(asset_name)
	print("Number of UV channels: " + str(num_uv_channels))

Copy full snippet

Supprimer un canal UV

Étant donné que chaque canal UV stocke les coordonnées de texture de chaque vertex dans le cadre du maillage statique, vous pouvez économiser de la mémoire lors de l'exécution en supprimant tous les texturages que vous n'utilisez pas.

Pour supprimer un canal UV, appelez la fonction unreal.EditorStaticMeshLibrary.remove_uv_channel. Transmettez-lui la ressource de maillage statique et l'index du canal UV que vous souhaitez supprimer.

Par exemple :

	import unreal
	asset_name = '/Game/Path/MyStaticMeshAsset'
	# Chargez la ressource de maillage statique.
	loaded_asset = unreal.EditorAssetLibrary.load_asset(asset_name)
	# Obtenir le nombre de canaux UV enregistrés dans la ressource.
	num_uv_channels = unreal.EditorStaticMeshLibrary.get_num_uv_channels(asset_name)
	# Supprimez le dernier de la liste.
	channel_to_remove = num_uv_channels - 1
	unreal.EditorStaticMeshLibrary.remove_uv_channel(asset_name, channel_to_remove)
	# Enregistrez la ressource modifiée.
	unreal.EditorAssetLibrary.save_asset(asset_name)

Copy full snippet

Tous les autres canaux UV déjà présents dans la liste après l'index spécifié sont déplacés d'une position vers le haut pour remplir l'espace vide laissé par l'entrée supprimée.

Ajouter un nouveau canal UV

Vous pouvez ajouter un nouveau canal UV à votre ressource de maillage statique en appelant l'une des fonctions suivantes :

• unreal.EditorStaticMeshLibrary.add_uv_channel - Ajoute le nouveau canal à la fin de la liste de canaux existante.
• unreal.EditorStaticMeshLibrary.insert_uv_channel - Ajoute le nouveau canal à l'index que vous spécifiez, en déplaçant chaque autre canal UV d'un numéro vers le bas dans la liste. Notez que la matrice des canaux UV ne peut pas être disséminée : vous ne pouvez insérer un nouveau canal qu'à une position dans la liste qui se trouve à la suite d'un autre canal existant. Par exemple, si la liste comporte trois canaux UV (index 0, 1 et 2), vous pouvez en ajouter un nouveau avec l'index 3, mais pas avec l'index 4.

Par exemple :

	import unreal
	asset_name = '/Game/Path/MyStaticMeshAsset'
	# Chargez la ressource de maillage statique.
	loaded_asset = unreal.EditorAssetLibrary.load_asset(asset_name)
	# Obtenir le nombre de canaux UV enregistrés dans la ressource.
	num_uv_channels = unreal.EditorStaticMeshLibrary.get_num_uv_channels(asset_name)
	print("Number of UV channels before: " + str(num_uv_channels))
	# Ajoutez-en un à la fin de la liste.
	unreal.EditorStaticMeshLibrary.add_uv_channel(asset_name)
	# Ajoutez-en un au début de la liste.
	unreal.EditorStaticMeshLibrary.insert_uv_channel(asset_name, 0)
	# Obtenez le nouveau nombre de canaux UV enregistrés dans la ressource.
	num_uv_channels = unreal.EditorStaticMeshLibrary.get_num_uv_channels(asset_name)
	print("Number of UV channels after: " + str(num_uv_channels))
	# Enregistrez la ressource modifiée.
	unreal.EditorAssetLibrary.save_asset(asset_name)

Copy full snippet

Le nouveau texturage est vide. Vous souhaitez le remplir d'une manière ou d'une autre avant de l'utiliser, soit en projetant la géométrie du maillage (voir ci-dessous), soit en l'utilisant comme destination pour la génération de textures de lumière.

Déballer la géométrie du maillage dans un canal UV

Vous pouvez créer de nouveaux texturages des UV en laissant l'éditeur de maillage statique déplier et aplanir automatiquement les triangles qui composent votre géométrie de maillage statique. La surface des triangles est automatiquement ajustée pour préserver la contiguïté des triangles voisins, et des jointures sont introduites partout où l'angle entre les surfaces adjacentes dépasse un seuil que vous définissez.

Utilisez la fonction unreal.UVGenerationFlattenMapping.generate_flatten_mapping_u_vs() . Transmettez-lui :

• une référence à la ressource de maillage statique que vous souhaitez modifier ;
• l'index du canal UV où vous souhaitez que l'UV déballé soit enregistré (si ce canal n'existe pas encore, le processus de déballage le crée) ;
• l'angle maximal, en degrés, entre deux faces adjacentes pour que ces faces restent connectées après le déballage. L'augmentation de cette valeur minimise le nombre d'« îles » UV séparées, en conservant davantage de triangles connectés à leurs voisins et en réduisant le nombre de jointures susceptibles de provoquer des ruptures dans le texturage. Cependant, cela peut également introduire davantage de distorsion dans les textures enveloppées, car il est possible que les triangles doivent être redimensionnés de manière plus agressive dans l'espace 2D afin de rester connectés à leurs voisins.

Par exemple :

	import unreal
	asset_name = '/Game/Meshes/StaticMesh'
	# Chargez la ressource de maillage statique.
	loaded_asset = unreal.EditorAssetLibrary.load_asset(asset_name)
	# Spécifiez le canal UV dans lequel enregistrer.
	channel_index = 2
	# Définissez le seuil d'angle.
	angle_threshold = 55
	# Déballez le maillage dans le canal UV.
	unreal.UVGenerationFlattenMapping.generate_flatten_mapping_u_vs(loaded_asset, channel_index, angle_threshold)
	# Enregistrez la ressource modifiée.
	unreal.EditorAssetLibrary.save_asset(asset_name)

Copy full snippet

Projeter la géométrie du maillage dans un canal UV

Vous pouvez créer de nouveaux texturages des UV en projetant les triangles du maillage statique sur un plan 2D ou un simple volume 3D.

Ces éléments ne sont actuellement exposés que dans les API de script de l'Unreal Editor et non dans l'interface utilisateur de l'éditeur de maillage statique. Cependant, le processus et les paramètres requis par l'API sont plus faciles à comprendre si vous êtes familiarisé avec les outils visuels de projection de maillage, tels que ceux disponibles dans 3ds Max. Consultez la page Modificateur Texture UVW dans l'aide de 3ds Max pour en savoir plus.

Projection planaire

Utilisez la fonction unreal.EditorStaticMeshLibrary.generate_planar_uv_channel pour projeter votre géométrie de maillage statique sur un plan. Utilisez ce type de projection si un seul côté de votre maillage statique doit être entouré de textures.

Par exemple :

	import unreal
	asset_name = '/Game/Path/MyStaticMeshAsset'
	# Chargez la ressource de maillage statique.
	loaded_asset = unreal.EditorAssetLibrary.load_asset(asset_name)
	# Spécifiez le LOD à projeter.
	lod_index = 0
	# Ajoutez un nouveau canal UV pour votre projection.
	num_uv_channels = unreal.EditorStaticMeshLibrary.get_num_uv_channels(asset_name)
	unreal.EditorStaticMeshLibrary.add_uv_channel(asset_name)
	channel_index = num_uv_channels
	# Configurez le plan de projection, ou « gadget ».
	bbox = loaded_asset.get_bounding_box()
	gizmo_pos = ((bbox.min + bbox.max) * 0.5)   # Recherchez le centre de la boîte englobante de l'objet.
	# Définissez les angles de rotation, en degrés.
	tangage = 0 # Autour de l'axe X
	lacet = 0 # Autour de l'axe Y
	roulis = 0 # Autour de l'axe Z
	gizmo_orientation = unreal.Rotator(pitch, yaw, roll)
	# Augmentez ou diminuez les valeurs pour agrandir ou réduire la projection.
	tiling = unreal.Vector2D(1, 1)
	# Projetez la géométrie du maillage statique dans le canal UV.
	unreal.EditorStaticMeshLibrary.generate_planar_uv_channel(loaded_asset, lod_index, channel_index, gizmo_pos, gizmo_orientation, tiling)
	# Enregistrez la ressource modifiée.
	unreal.EditorAssetLibrary.save_asset(asset_name)

Copy full snippet

Projection cylindrique

Utilisez la fonction unreal.EditorStaticMeshLibrary.generate_cylindrical_uv_channel pour projeter votre géométrie de maillage statique sur les côtés, le haut et le bas d'un cylindre.

Par exemple :

	import unreal
	asset_name = '/Game/Path/MyStaticMeshAsset'
	# Chargez la ressource de maillage statique.
	loaded_asset = unreal.EditorAssetLibrary.load_asset(asset_name)
	# Spécifiez le LOD à projeter.
	lod_index = 0
	# Ajoutez un nouveau canal UV pour votre projection.
	num_uv_channels = unreal.EditorStaticMeshLibrary.get_num_uv_channels(asset_name)
	unreal.EditorStaticMeshLibrary.add_uv_channel(asset_name)
	channel_index = num_uv_channels
	# Configurez le cylindre de projection, ou « gadget ».
	bbox = loaded_asset.get_bounding_box()
	gizmo_pos = ((bbox.min + bbox.max) * 0.5)   # Recherchez le centre de la boîte englobante de l'objet.
	# Définissez les angles de rotation, en degrés.
	tangage = 0 # Autour de l'axe X
	lacet = 0 # Autour de l'axe Y
	roulis = 0 # Autour de l'axe Z
	gizmo_orientation = unreal.Rotator(pitch, yaw, roll)
	# Augmentez ou diminuez les valeurs pour agrandir ou réduire la projection.
	tiling = unreal.Vector2D(1, 1)
	# Projetez la géométrie du maillage statique dans le canal UV.
	unreal.EditorStaticMeshLibrary.generate_cylindrical_uv_channel(teapot, lod_index, channel_index, gizmo_pos, gizmo_orientation, tiling)
	# Enregistrez la ressource modifiée.
	unreal.EditorAssetLibrary.save_asset(asset_name)

Copy full snippet

Projection de boîte

Utilisez la fonction unreal.EditorStaticMeshLibrary.generate_box_uv_channel pour projeter votre géométrie de maillage statique sur les faces d'un cube.

Par exemple, le script suivant crée une boîte de la même taille approximative que le maillage statique, puis crée un nouveau texturage des UV en projetant la géométrie du maillage statique sur les côtés de cette boîte :

	import unreal
	asset_name = '/Game/Path/MyStaticMeshAsset'
	# Chargez la ressource de maillage statique.
	loaded_asset = unreal.EditorAssetLibrary.load_asset(asset_name)
	# Spécifiez le LOD à projeter.
	lod_index = 0
	# Ajoutez un nouveau canal UV pour votre projection.
	num_uv_channels = unreal.EditorStaticMeshLibrary.get_num_uv_channels(asset_name)
	unreal.EditorStaticMeshLibrary.add_uv_channel(asset_name)
	channel_index = num_uv_channels
	# Configurez le volume de projection, ou « gadget ».
	bbox = loaded_asset.get_bounding_box()
	gizmo_pos = ((bbox.min + bbox.max) * 0.5)   # Recherchez le centre de la boîte englobante de l'objet.
	# Définissez les angles de rotation, en degrés.
	tangage = 0 # Autour de l'axe X
	lacet = 0 # Autour de l'axe Y
	roulis = 0 # Autour de l'axe Z
	gizmo_orientation = unreal.Rotator(pitch, yaw, roll)
	# Obtenez la taille de la boîte.
	gizmo_size = bbox.max - bbox.min
	# Projetez la géométrie du maillage statique dans le canal UV.
	unreal.EditorStaticMeshLibrary.generate_box_uv_channel(box, channel_index, lod_index, gizmo_pos, gizmo_orientation, gizmo_size)
	# Enregistrez la ressource modifiée.
	unreal.EditorAssetLibrary.save_asset(asset_name)

Copy full snippet