Le mode Outils de l'Éditeur de PCG est une fonctionnalité qui permet de placer du contenu de PCG dans les niveaux, notamment des splines, des surfaces, de la peinture et des volumes, à l'aide d'une bibliothèque d'outils personnalisables en vue de créer des préréglages qui exploitent le framework de PCG, chacun étant associé à un graphique PCG et à des paramètres.
Pour accéder au mode Outils de l'Éditeur de PCG, ouvrez le menu déroulant Modes et sélectionnez PCG.
Bien qu'il s'agisse d'une première version de ce mode, nous l'améliorerons progressivement pour le rendre plus modulable afin que, en plus de configurer et de placer des graphiques et des acteurs par défaut, vous puissiez également développer les outils disponibles.
Outils du mode PCG
Lorsque vous choisissez l'un de ces outils, les résultats dépendent de la sélection de l'acteur approprié.
Si un acteur est sélectionné, un composant PCG est ajouté à l'acteur au besoin, et une nouvelle ressource de données d'outil est créée s'il n'en existe pas.
Si aucun acteur n'est sélectionné, un acteur est créé pour effectuer l'opération, qui change en fonction du graphique ou du préréglage sélectionné.
Les boutons d'outils sont désactivés lorsque vous sélectionnez un acteur qui n'appartient pas à la classe d'acteur appropriée ou qui ne dispose pas des composants nécessaires au bon fonctionnement du graphique. De la même manière, les préréglages qui ne sont pas compatibles avec l'acteur sélectionné ne sont pas affichés.
Cliquez sur un bouton d'outil pour commencer à utiliser l'outil. Les boutons Appliquer et Annuler s'affichent, ainsi qu'une deuxième ligne de boutons pour les préréglages.
Les préréglages sont des graphiques et des instances marqués comme préréglages d'outil. Ils vous permettent de sélectionner rapidement un graphique sans passer par le menu déroulant. L'utilisation d'un préréglage équivaut fonctionnellement à sélectionner un graphique dans le menu déroulant.
Paramètres d'instance d'outil
Lorsque vous sélectionnez un outil, le panneau affiche les paramètres d'instance auxquels vous pouvez accéder directement sur le composant PCG, ce qui vous permet de les modifier tout en interagissant avec l'outil.
| Paramètre d'instance | Description |
|---|---|
Graphique d'outil | Ce graphique est défini sur le composant PCG et détermine les paramètres disponibles ; vous pouvez l'utiliser pour sélectionner la classe d'acteur lors de la création d'un nouvel acteur. |
Remplacements de paramètres | Tous les paramètres de graphique exposés dans le graphique sont disponibles dans cette section. |
Instance de données | Ce paramètre détermine sur quelle "instance de données" écrit l'outil. Ce paramètre a une utilité limitée pour les splines ou les volumes ; pour les outils de peinture, il vous permet cependant d'écrire sur différentes couches (et d'effectuer différents traitements par couche). Vous pouvez changer de couche à l'aide des raccourcis clavier (1, 2, …). |
Étiquette d'acteur | L'étiquette de l'acteur généré, si aucune étiquette n'a été sélectionnée. Si vous modifiez cette étiquette dans ce champ, le nom de l'acteur change. La valeur par défaut provient des paramètres de l'outil du graphique. |
Nom du composant | Nom du composant ajouté à l'acteur (si vous n'utilisez pas un nom existant). |
Classe d'acteur à générer | Il s'agit de la classe de l'acteur qui apparaît au démarrage de l'outil sans sélection. Ce paramètre ne peut être modifié que lorsque l'outil a généré l'acteur lui-même, et les données de l'outil sont perdues lors du changement de classe. Toutefois, il permet de créer des acteurs de BP pour des configurations plus complexes. Ce champ n'est pas visible lors du lancement de l'outil sur un acteur existant, car dans cet état, il n'est pas possible de modifier la classe de l'acteur. |
Outils du mode PCG
Outil Créer une spline
Vous pouvez utiliser le mode Créer une spline pour placer des objets "sur une spline" projetée dans l'environnement, notamment pour des clôtures, des routes, etc. ; ce mode fonctionne avec des splines ouvertes et fermées. Il est similaire aux autres modes de création de spline, mais il est conçu pour la PCG. Les propriétés des graphiques qui prennent en charge cet outil disposent de la balise d'outil SplineTool.
Tracer la surface de spline
Vous pouvez utiliser le mode Tracer la surface de spline pour définir une zone fermée délimitée par une spline, à l'intérieur de laquelle un graphique PCG remplit l'espace, par exemple, des champs, des rangées de maïs, de l'herbe, etc. Cet outil utilise la balise d'outil SplineSurfaceTool.
Peindre
L'outil Peindre vous permet de peindre sur le monde (en fonction des collisions) ou sur l'acteur sélectionné. Il est similaire au mode Végétation.
Il permet de créer des points aux endroits où les rayons frappent des objets physiques. Vous pouvez aussi supprimer des points en maintenant l'appui sur la touche Maj (le pinceau devient rouge). Cet outil utilise la balise d'outil PaintTool.
Volume
L'outil Volume permet de créer des volumes PCG en faisant glisser l'empreinte, puis la hauteur de la boîte. Cet outil est désactivé, à moins que l'acteur soit un volume ou un composant de boîte. Cet outil utilise la balise d'outil VolumeTool.
Contrôles propres à l'outil
Contrôles de spline
Les modes de génération contrôlent la façon dont vous interagissez avec l'outil. Ils sont similaires à d'autres outils de spline.
Règles de ray-casting
Les règles de ray-casting contrôlent la manière dont plusieurs outils interagissent avec le monde. Lorsque cette option est activée, chaque règle définit une interaction particulière avec votre projet.
| Règle de ray-casting | Description |
|---|---|
Paysage | Cette règle prend en charge les interactions sur le paysage. |
Maillages | Cette règle prend en charge les interactions avec les maillages (par exemple, les acteurs avec des collisions). |
Ignorer les composants PCG | Cette règle ne prend en charge aucune interaction sur les composants créés par PCG. |
Classes autorisées | Cette règle prend en charge les interactions uniquement sur les classes d'acteur de la liste (ou celles dérivées d'une classe parente de la liste). |
Se limiter à l'acteur | Cette règle prend en charge uniquement les interactions sur l'acteur sélectionné. |
Configurer un graphique d'outil
Pour configurer un graphique d'outil, recherchez les paramètres du graphique PCG dans la section Données d'outil, puis définissez les valeurs appropriées pour votre nouveau graphique d'outil.
| Paramètres du graphique de données d'outil | Description |
|---|---|
Nom d'affichage | Ce paramètre définit le nom qui apparaît sur les boutons prédéfinis de l'outil. |
Infobulle | Ce paramètre définit l'infobulle qui s'affiche lorsque vous placez le pointeur de la souris sur le bouton prédéfini de l'outil. |
Balises d'outil compatibles | Ce paramètre dresse la liste des balises compatibles avec ce graphique. Vous devez définir ce paramètre pour que le graphique apparaisse dans le menu déroulant du graphique de l'outil correspondant. Les valeurs valides actuelles sont les suivantes :
|
Classe d'acteur initiale à générer | Ce paramètre définit la classe d'acteur à générer lors du lancement de l'outil sans sélection, et agit comme une restriction sur les classes d'acteur qui correspondent à ce graphique. Par exemple, lorsque vous définissez ce paramètre sur Volume PCG, si la sélection n'est pas un volume PCG, le graphique ne figure pas dans le menu déroulant du graphique d'outil. |
Nouvelle étiquette d'acteur | Ce paramètre définit l'étiquette d'acteur par défaut utilisée lors de la génération d'un acteur. |
Est prédéfini | Ce paramètre détermine si le graphique apparaît ou non sous la forme d'un bouton prédéfini d'outil. Vous pouvez remplacer ce paramètre dans des instances. |
Configurer une instance en tant que préréglage
À l'instar d'un graphique d'outil, les instances de graphique comportent une section intitulée Remplacement des données d'outil.
| Remplacement des données d'outil | Description |
|---|---|
Nom d'affichage | Même valeur que celle des graphiques. |
Infobulle | Même valeur que celle des graphiques. |
Est prédéfini | Ce remplacement détermine si cette instance est un préréglage, quelle que soit la valeur du graphique d'origine. |
Paramètres du mode Éditeur de PCG
Les paramètres du mode Éditeur de PCG contrôlent le comportement du mode d'outil de PCG. Ils se trouvent dans Préférences de l'éditeur > Mode Éditeur de PCG.
| Paramètre du mode Éditeur de PCG | Description |
|---|---|
Taux d'actualisation du graphique | Ce paramètre détermine la vitesse de propagation des modifications de façon à ce que PCG puisse les récupérer. Si la génération est très lente, vous pouvez augmenter cette valeur. |
Masquer les boutons d'outils pendant l'utilisation de l'outil | Si ce paramètre est activé, lorsque vous accédez à un outil, l'interface masque la rangée d'outils et n'affiche que les préréglages. |
Afficher l'éditeur de toast sur les erreurs d'outils | Ce paramètre détermine si les erreurs sont affichées dans un toast ou uniquement dans la fenêtre d'outils. |
Paramètres d'outil interactif | Ce paramètre détermine les contrôles d'outil qui s'affichent et leurs valeurs par défaut. Si cette liste est vide, elle est renseignée avec Réinitialiser aux valeurs par défaut. Cette liste contient :
Les graphiques par défaut doivent fonctionner sur la classe d'acteur par défaut ; dans le cas contraire, l'outil ne s'ouvrira pas systématiquement. |
Nom du nouvel acteur par défaut | Si le nom d'un acteur n'est pas fourni dans le graphique, cette valeur est utilisée. |
Nom du nouveau composant PCG par défaut | Si le nom d'un composant PCG n'est pas fourni dans le graphique, cette valeur est utilisée. |
Nom du nouveau composant de spline par défaut | Si le nom d'un composant de spline n'est pas fourni dans le graphique, cette valeur est utilisée. |