En bref
- Une Material Parameter Collection regroupe des paramètres scalaires et vectoriels que plusieurs matériaux peuvent utiliser en commun.
- L’exemple du guide utilise le paramètre scalaire Global_Desaturation pour modifier la saturation des couleurs d’un matériau.
- Un Material peut référencer jusqu’à deux Material Parameter Collections différentes.
- Il est possible de modifier les valeurs de la collection pendant l’exécution à l’aide d’un Blueprint.
Ce que vous allez apprendre dans ce guide
Lorsque de nombreux matériaux d’une même scène doivent réagir à une valeur commune dans Unreal Engine, modifier les paramètres séparément dans chaque Material Instance peut compliquer la gestion. Une Material Parameter Collection (MPC) permet de stocker des valeurs scalaires et vectorielles dans un seul asset et de les utiliser dans plusieurs matériaux.
Dans cet exercice, vous allez créer un paramètre scalaire et l’utiliser pour contrôler la saturation des couleurs d’un matériau simple. Vous découvrirez ensuite un exemple où cette même valeur peut être modifiée depuis un Blueprint. Vous pourrez ainsi observer comment la valeur unique d’une collection se répercute sur les matériaux qui l’utilisent.
Prérequis
Ce tutoriel suit le flux de travail décrit dans la documentation officielle sur les Material Parameter Collections, publiée pour Unreal Engine 4.27. La source ne précise pas d’autre prérequis de compte ni de matériel particulier pour cet exercice. Vous aurez besoin d’un projet dans l’éditeur, d’un espace de travail dans le Content Browser et d’objets de la scène auxquels un matériau est appliqué afin d’observer les changements.
Le paramètre de l’exemple s’appellera Global_Desaturation. Ce nom servira tout au long du tutoriel à faire correspondre la valeur scalaire de la collection au paramètre de collection utilisé dans le graphe du Material. Si vous choisissez un autre nom, veillez à ce que les noms des paramètres dans la collection, le Material et le Blueprint correspondent.
Étape par étape : créer une collection et un matériau
Créez un asset Material Parameter Collection. Dans le Content Browser, faites un clic droit dans une zone vide. Dans le menu qui s’ouvre, sélectionnez Material Parameter Collection sous Materials & Textures. Donnez à l’asset créé un nom qui décrit son contenu.
Ajoutez un paramètre scalaire à la collection. Double-cliquez sur l’asset pour ouvrir sa fenêtre d’édition. Cliquez sur le bouton d’ajout dans la section Scalar Parameters pour créer une nouvelle valeur, puis nommez-la Global_Desaturation. Pour cet exemple, conservez la valeur par défaut 0,0. Des paramètres vectoriels peuvent également être stockés dans le même type de collection ; cet exercice utilise uniquement une valeur scalaire.
Préparez un Material simple pour le test. Créez un nouveau Material et ajoutez au graphe les nœuds de paramètres qui permettront de définir les valeurs de surface, comme la couleur de base, la métallicité et la rugosité. L’exemple du guide utilise les paramètres Base_Color, Metallic et Roughness correspondant à ces entrées. Le résultat visuel du Material doit être perceptible sur les objets de la scène utilisés pour tester la valeur de la collection.
Connectez la valeur de la collection au graphe. Ajoutez un nœud Desaturation dans le graphe du Material. Faites ensuite glisser l’asset de la collection depuis le Content Browser vers le graphe : un nœud utilisant le paramètre de la collection est alors ajouté. Connectez la sortie Base_Color à la première entrée du nœud Desaturation, puis la sortie du paramètre de collection à l’entrée Fraction. Connectez la sortie de Desaturation à l’entrée Base Color du Material, puis compilez le Material.
Testez le Material dans la scène. Appliquez le Material créé aux objets de la scène. Ouvrez l’asset de la collection depuis le Content Browser et faites passer la valeur Global_Desaturation de 0 à 1. Dans l’exemple de la source, ce changement rapproche du blanc la couleur des objets bleus. L’objectif est d’observer qu’une seule valeur de collection peut modifier simultanément l’apparence des matériaux qui y sont associés.
Modifier la valeur pendant l’exécution avec Blueprint
Vous n’êtes pas obligé de modifier la valeur de la collection uniquement depuis sa fenêtre d’édition. L’exemple officiel effectue cette opération depuis un Blueprint. Pour cela, créez d’abord plusieurs Material Instances à partir du Material de base et appliquez-les aux objets de la scène. L’exemple utilise des versions rouge, verte et bleue ; des couleurs différentes facilitent la comparaison.
Ouvrez le Level Blueprint et indiquez la collection et le nom du paramètre Global_Desaturation à utiliser dans le nœud Set Scalar Parameter Value. Dans l’exemple du document, une Timeline fait varier la valeur au fil du temps : ajoutez deux clés à la Float Track, l’une au temps 0 avec la valeur 0, l’autre au temps 1 avec la valeur 1. Dans l’exemple, la piste s’appelle Des_Amount. Une fois les connexions des nœuds terminées, compilez le Blueprint et lancez la scène. Dans l’exemple, les matériaux deviennent gris lorsque le bouton gauche de la souris est maintenu enfoncé, puis retrouvent leurs couleurs initiales lorsqu’il est relâché.
Erreurs fréquentes et limites
Ne pas faire correspondre les noms : le nom du paramètre sélectionné dans le Blueprint doit être identique à celui de la collection. Si le paramètre est renommé, son nouveau nom doit également être renseigné dans le Blueprint qui l’utilise.
Oublier l’étape de compilation : après avoir modifié les connexions dans le graphe du Material, appliquez les changements avec Apply ; après avoir modifié le Blueprint, utilisez Compile.
Multiplier inutilement les collections : un Material peut référencer jusqu’à deux Material Parameter Collections différentes. Le document précise que l’une peut servir aux valeurs générales et l’autre aux valeurs propres à un niveau.
Ajouter beaucoup de valeurs ultérieurement : une collection peut contenir jusqu’à 1024 paramètres scalaires et 1024 paramètres vectoriels. Modifier le nombre de paramètres d’une collection entraîne la recompilation des matériaux qui la référencent. Si un grand nombre de paramètres est nécessaire, il peut être plus efficace de les planifier dès le départ.
Conséquences pour les flux de travail en architecture et en visualisation
Les présentations architecturales peuvent comporter de nombreux objets partageant le même langage de matériaux. L’approche par collection permet de gérer les paramètres depuis un seul endroit, par exemple dans les scènes où les matériaux doivent suivre une valeur scalaire ou vectorielle commune. Il est également possible de lier la modification de la valeur à une interaction dans la scène à l’aide d’un Blueprint. Cela ne signifie toutefois pas que chaque besoin visuel doit automatiquement être transféré dans une collection : il faut déterminer au début du projet quelles valeurs seront communes et lesquelles resteront propres à chaque matériau.
Étapes suivantes
Commencez par reproduire l’exemple dans une petite scène de test et vérifiez l’effet d’un paramètre sur plusieurs matériaux. Ensuite, envisagez d’organiser les valeurs communes au projet et celles qui doivent varier selon le niveau dans des collections distinctes. Dans le Blueprint, vérifiez les noms des paramètres ; après un renommage, assurez-vous que les nœuds concernés restent associés à la bonne valeur.
Source et licence
Ce guide est une adaptation en turc de la documentation officielle d’Unreal Engine 4.27 d’Epic Games intitulée Material Parameter Collections. La source indique que son utilisation est libre dans la section consacrée à la licence.
Sources
1 sourceLes textes sources ne sont pas republiés ; les courtes citations sont signalées, le reste est notre propre résumé et commentaire.
Pour les bureaux d’architecture et les équipes de visualisation en Turquie, l’intérêt pratique de cette méthode tient à la possibilité de gérer depuis un seul endroit une réaction commune des matériaux sur de nombreux objets. Elle peut notamment réduire les réglages répétés lors de la préparation de variantes de scène ou de présentations interactives.
La source ne mentionnant ni matériel spécifique ni tarif requis pour la configuration, il serait inapproprié d’en déduire un avantage en matière d’achat ou de performances. Avant de l’utiliser, vérifiez la version d’Unreal Engine et la structure du projet ; concevez les collections en tenant compte de la limite de deux références et de l’incidence des noms de paramètres sur les connexions Blueprint.
Questions fréquentes
À quoi sert une Material Parameter Collection dans Unreal Engine ?
Elle stocke des paramètres scalaires et vectoriels dans un asset et permet à plusieurs matériaux d’utiliser ces valeurs.
Combien de Material Parameter Collections un Material peut-il utiliser ?
La documentation officielle indique qu’un Material peut référencer jusqu’à deux Material Parameter Collections différentes.
Peut-on modifier une valeur de Material Parameter Collection avec un Blueprint ?
Oui. Le document montre comment modifier une valeur scalaire de la collection depuis un Blueprint à l’aide du nœud Set Scalar Parameter Value.



