Groupe de nœuds¶
Exemple de groupe de nœuds.¶
Le regroupement des nœuds peut simplifier une arborescence de nœuds en masquant la complexité et en réutilisant les fonctionnalités courantes. Un groupe de nœuds est identifié visuellement par sa barre de titre verte.
D’un point de vue conceptuel, les groupes de nœuds vous permettent de traiter un ensemble de nœuds comme une seule unité. Ils sont similaires à des fonctions en programmation : réutilisables, composables et paramétrables.
Par exemple, supposons que vous créiez un matériau “Bois” et que vous souhaitiez l’utiliser en plusieurs couleurs. Vous pouvez dupliquer l’ensemble de la configuration du nœud pour chaque couleur, mais la maintenance de ces doublons serait fastidieuse si vous décidez ultérieurement de modifier les détails du grain du bois. Au lieu de cela, vous pouvez déplacer les nœuds qui génèrent le motif de bois dans un groupe de nœuds. Chaque matériau pourra ensuite réutiliser ce groupe et fournir une couleur personnalisée en entrée. Toute mise à jour du détail du grain ne devra être effectuée qu’une seule fois, à l’intérieur du groupe de nœuds.
Les groupes de nœuds peuvent être imbriqués; c’est-à-dire qu’un groupe peut contenir d’autres groupes.
Note
Les groupes de nœuds récursifs sont interdits pour éviter une récursivité infinie. Un groupe ne peut pas se contenir lui-même, directement ou indirectement.
Astuce
Comme tous les blocs de données, les groupes de nœuds avec des noms qui commencent par . sont normalement cachés des listes et menus et ne peuvent être accessibles que via la recherche. Cela peut être utile pour que les auteurs d’assets de nœud puissent masquer leurs sous-groupes internes de l’utilisateur final.
Les nœuds Group Input et Group Output sont utilisés pour représenter les données entrant et sortant du groupe.
Le nœud Group Input permet d’accéder aux sockets d’entrée du groupe à partir du groupe de nœuds. Ces sockets agissent comme des paramètres qui contrôlent le comportement du groupe de l’extérieur. Vous pouvez les connecter à des nœuds internes pour piloter des valeurs telles que des facteurs, des couleurs ou des entrées géométriques.
Note
Les valeurs en entrée qui n’affectent pas la sortie seront grisées.
Le nœud Group Output définit les données qui sont transmises à partir du groupe de nœuds. Seules les sockets connectés à ce nœud seront disponibles en sortie sur le groupe lui-même.
Important
Évitez d’utiliser des nœuds de sortie de nœuds tels que Material Output ou Composite à l’intérieur des groupes de nœuds. Ceux-ci doivent être utilisés dans l’arborescence des nœuds de niveau supérieur pour améliorer la réutilisation des groupes de nœuds.
Utilisez un Group Output pour transmettre les données d’un groupe de nœuds.
Utilisation¶
Gestion des entrées / sorties¶
Vous pouvez ajouter, supprimer et réorganiser les prises d’entrée et de sortie dans le panneau Group de la barre latérale. De nouveaux sockets peuvent également être créés directement en faisant glisser un lien vers ou à partir d’une prise vide sur le Group Input ou le Group Output vers une autre prise dans l’éditeur de nœud.
Réutilisation des groupes de nœuds¶
Référence
- Menu:
- Raccourci:
Maj-A
Les groupes de nœuds existants peuvent être replacés après leur définition initiale, que ce soit dans la même arborescence de nœuds ou dans une autre. Il est également possible d’importer des groupes de nœuds à partir d’un autre fichier blend en utilisant .
Astuce
Lorsque vous ajoutez des groupes de nœuds d’un fichier blend à un autre, Blender ne fait pas de distinction entre les groupes de nœuds de matériaux ou les groupes de nœuds composites. Pour éviter toute confusion, il est recommandé d’adopter une convention de dénomination, comme utiliser des préfixes (Mat_, Comp_, Geo_, etc.), pour indiquer le contexte du groupe.
Propriétés¶
Group¶
Référence
- Panneau:
Le panneau Group.¶
Ce panneau contient des propriétés liées au nœud de groupe, telles que son nom et son apparence.
- Name
Le nom du nœud tel qu’affiché dans Titre.
- Description
Le message affiché au survol de Titre ou dans les menus d’ajout.
- Color Tag
Étiquette de couleur du groupe de nœuds qui influence la couleur de l’en-tête.
- Node Width
La largeur des groupes de nœuds nouvellement créés.
- (Set Default Node Width)
Définir la largeur en fonction du groupe de nœuds parent dans le contexte actuel
- Show Manage Panel Geometry Nodes
Active l’affichage du panneau Manage dans les modificateurs Nœuds de géométrie lors de la création d’un modificateur à partir d’un asset de groupe de nœuds.
Usage Geometry Nodes¶
Ce panneau n’est visible que dans l'éditeur de nœuds de géométrie.
- Modifier
Le groupe de nœuds est est destiné à être utilisé avec le Modificateur Geometry Nodes.
- Outil
Le groupe de nœuds est destiné à être utilisé comme un outil.
Le menu bloc de données dans l’en-tête de l’éditeur de nœuds géométriques répertorie uniquement les groupes de nœuds dont l’utilisation correspond à Node Tree Sub-Type.
Astuce
Si vous désactivez accidentellement les deux utilisations, le groupe de nœuds ne sera plus accessible via le menu du bloc de données. Pour le rendre à nouveau accessible, vous pouvez l’ajouter en tant que nœud à un autre groupe de nœuds (), sélectionner ce nœud et appuyer sur Tab pour y accéder. À partir de là, vous pouvez réactiver l’une des utilisations.
Group Sockets¶
Référence
- Panneau:
Le panneau Group Sockets.¶
Ce panneau est utilisé pour ajouter, supprimer, réorganiser et modifier les éléments d’interface utilisateur d’un groupe de nœuds. Il définit comment les prises apparaissent sur le nœud de groupe et les organise pour plus de clarté et de convivialité.
Les types d’items disponibles comprennent :
Inputs: Définit les prises d’entrée pour le groupe de nœuds.
Outputs: Définit les sockets de sortie pour le groupe de nœuds.
- Panels:
Regroupe et organise les sockets associés. Utile pour structurer des configurations de nœuds complexes. Les panneaux apparaissent toujours en bas de l’interface du nœud. Ils peuvent être imbriqués en faisant glisser un panneau au-dessus d’un autre dans la liste des éléments de l’interface.
- Panel Toggle:
Ajoute une case à cocher booléenne à l’en-tête d’un panneau, ce qui permet de contrôler son contenu. Cette option n’est disponible que lorsqu’un panneau est sélectionné dans la liste des éléments de l’interface.
Les bascules de panneau ont leurs propres options sous le sous-panneau Panel Toggle. Notez que les sockets à bascule ne sont pas répertoriés directement dans la liste de l’interface : les panneaux avec des bascules affichent à la place une icône booléenne en regard de leur nom. Pour que la prise à bascule soit à nouveau visible, elle doit être dissociée (unlinked)du panneau.
Note
Une bascule de panneau ne désactive pas ou ne grise pas automatiquement ses sockets. Pour désactiver visuellement et fonctionnellement les sockets, utiliser un Switch Node ou une logique similaire et déconnecter le socket manuellement.
- Interface Item List
Une vue en liste d’interface utilisateur affichant toutes les prises et panneaux d’entrée / sortie. Chaque élément peut être renommé et configuré individuellement. Le nom apparaît dans l’interface utilisateur du nœud.
Astuce
La sélection d’une étiquette de socket sur le nœud lui-même sélectionnera également ce socket dans la Liste des éléments de l’interface (Interface Item List).
Specials
- Duplicate Item
Duplique la prise ou le panneau sélectionné.
- Make Panel Toggle
Convertit l’entrée booléenne sélectionnée en une bascule pour son panneau parent. Disponible uniquement lorsqu’un panneau est sélectionné et que l’élément actif est un socket booléen.
- Unlink Panel Toggle
Supprime la relation de bascule entre une prise booléenne et un panneau, ce qui en fait une entrée autonome régulière à nouveau.
Sockets
Les propriétés disponibles pour les sockets dépendent de plusieurs facteurs, notamment s’il s’agit d’un socket d’entrée ou de sortie, du type de données et du type d’arborescence de nœuds.
- Type
Type de Socket généré par cet élément d’interface.
- Description
Le texte de l’infobulle affiché lors du survol du socket.
- Attribute Domain Geometry Nodes – Output – Integer Color Vector Boolean Float
Type d’élément géométrique auquel l’attribut correspond. Voir Domaines d’attribut pour une liste complète des domaines d’attributs.
- Default Attribute Geometry Nodes – Integer Color Vector Boolean Float
Nom d’attribut utilisé par défaut lorsque le groupe de nœuds est utilisé comme modificateur de nœuds de géométrie.
- Subtype Integer Float Vector String
Spécifie la façon dont les données sont interprétées et affichées dans l’interface utilisateur. L’unité ou le comportement dépend souvent des unités de scène.
- Integers
- None:
Valeurs entières standard.
- Percentage:
Affiché en pourcentage. En règle générale, les valeurs Min et Max sont définies sur 0 et 100.
- Factor:
Pourcentage ou facteur compris entre une limite inférieure et une limite supérieure.
- Floats
- None:
Valeurs standard à virgule flottante.
- Percentage:
Affiché en pourcentage. En règle générale, les valeurs Min et Max sont définies sur 0 et 100.
- Factor:
Pourcentage ou facteur compris entre une limite inférieure et une limite supérieure.
- Angle:
Mesure en degrés ou en radians, selon les unités de la scène.
- Time (Scene Relative):
Temps en images, converti en secondes en fonction de la fréquence d’images de la scène.
- Time (Absolute):
Temps spécifié en secondes.
- Distance:
Une mesure de distance spatiale.
- Wavelength:
Distance entre les cycles d’onde, mesurée en millimètres (mm), micromètres (μm), nanomètres (nm) ou picomètres (pm).
- Color Temperature:
Une valeur de température (Kelvin) correspondant à la couleur perçue d’une source lumineuse.
- Frequency:
Taux de répétition par seconde (hertz).
- Vectors
- None:
Valeurs vectorielles standard.
- Percentage:
Affiché en pourcentage.
- Factor:
Facteur compris entre une borne inférieure et une borne supérieure.
- Translation:
Un vecteur de déplacement.
- Direction:
Un vecteur de direction géométrique.
- Velocity:
Vecteur représentant la vitesse et la direction du mouvement.
- Acceleration:
Vecteur représentant la variation de la vitesse.
- Euler Angles:
Angles de Rotation d’Euleur.
- XYZ:
Coordonnées cartésiennes. Un quatrième élément (W) peut également être pris en charge.
- Strings:
- None:
Chaîne de texte standard.
- File Path:
La chaîne est interprétée comme un chemin d’accès à un fichier.
- Dimensions Vector
Définit le nombre de composants du socket vectorielle : 2, 3 ou 4. La modification de la dimension affecte la façon dont le socket est dessiné et dont les données y sont transmises.
2D: Composants X et Y uniquement.
3D: Composants X, Y et Z.
4D: X, Y, Z et W.
- Default
La valeur utilisée lorsque rien n’est connecté au socket.
- Min, Max
Valeurs minimale et maximale du contrôle de l’interface utilisateur dans l’interface du nœud.
Important
Cela ne bloque pas les données réelles qui circulent dans le support. Si une valeur supérieure est transmise au socket, elle sera toujours traitée inchangée.
- Default Input Geometry Nodes – Input – Integer Vector Matrix
Valeur utilisée lorsque la prise n’est pas connectée. Nécessite l’activation de l’option Hide Value (Masquer la valeur).
- Optional Label Input
Indique que l’étiquette de cette prise n’est pas nécessaire pour comprendre sa signification. Dans certains cas, l’étiquette peut être ignorée.
- Hide Value
Masque le contrôle de valeur par défaut du socket, même lorsqu’il n’est pas connecté.
- Layer Selection Geometry Nodes – Input – Boolean
Prend un calque Grease Pencil ou un Layer Group comme champ de sélection.
- Hide in Modifier Geometry Nodes – Input
Masque la valeur d’entrée dans l’interface du modificateur des Nœuds de géométrie. Cela permet au socket d’être utilisé à l’intérieur du groupe de nœuds, mais sans être exposé au modificateur.
Disponible uniquement pour les sockets d’entrée des Geometry Nodes.
- Shape Geometry Nodes – Input
Spécifie le type de données de haut niveau que le socket accepte. Voir Socket Shape pour plus d’informations.
- Auto:
Détecte automatiquement la forme la plus appropriée en fonction de l’utilisation de la prise. Il s’agit de l’option par défaut qui fonctionne dans la plupart des cas.
- Dynamic:
La prise peut s’adapter à plusieurs formes, ce qui la rend flexible lorsqu’elle est utilisée avec différentes connexions. Utile pour les groupes de nœuds génériques destinés à gérer différents types de données.
- Single:
N’autorise que des valeurs uniques (constantes) plutôt que des données structurées. Les champs ou les réseaux ne peuvent pas être connectés.
- Field:
La prise attend un champ, ce qui signifie que la valeur peut varier en fonction de l’élément de géométrie ou du contexte.
- Grid:
Le socket attend une grille comme structure de données, qui stocke les valeurs échantillonnées sur un volume ou un espace 2D.
Panneaux
- Description
Le texte de l’info-bulle s’affiche lors du survol de l’en-tête du panneau.
- Closed by Default
Si activé, le panneau est réduit par défaut sur les nouveaux nœuds.
Animation¶
Contrôle les données d’animation pour les propriétés du groupe de nœuds, y compris les Actions actives et leur Slot attribué.
Voir Attribution manuelle d’Actions et de Slots pour plus d’informations.
Make Group¶
Référence
- Menu:
- Raccourci:
Ctrl-G
Crée un nouveau groupe de nœuds qui contient tous les nœuds sélectionnés.
Les nœuds Group Input et Group Output seront créés pour représenter les connexions aux nœuds non sélectionnés à l’extérieur du groupe. Les entrées seront acheminées vers Group Input et les sorties acheminées vers Group Output.
Lors du regroupement d’un single node, le groupe de nœuds résultant :
Préservera l’interface du nœud d’origine, y compris les panneaux et les valeurs par défaut.
Héritera du nom du nœud d’origine
Lors d’un regroupement multiple nodes, le groupe est créé avec des sockets d’entrée et de sortie générées à partir des connexions. Dans ce cas, un nom générique tel que “NodeGroup”, “NodeGroup.001”, etc. est utilisé.
Insérer dans un groupe¶
Référence
- Menu:
Déplace les nœuds sélectionnés vers le groupe de nœuds actif. Pour l’utiliser, sélectionnez un ensemble de nœuds, en terminant par le nœud du groupe de destination, alors l’exécution de l’opération déplacera ces nœuds dans ce groupe. Les nœuds déplacés sont regroupés dans un groupe qui leur est propre pour préserver leur contexte de connexion, ayant leurs propres nœuds d’entrée et de sortie de groupe. Les nœuds d’entrée et de sortie existants du groupe sont mis à jour avec de nouveaux sockets, le cas échéant, à partir des nouveaux nœuds. Le groupe de nœuds doit être modifié pour contenir un seul nœud Group Input et un seul nœud Group Output.
Éditer le groupe¶
Référence
- Menu:
- Header (Entête):
- Raccourci:
Tab, Ctrl-Tab
Avec un groupe de nœuds sélectionné, appuyez sur Tab pour vous y déplacer et voir son contenu. Appuyez à nouveau sur Tab (ou Ctrl-Tab) pour quitter le groupe et revenir à son parent, qui peut être l’arborescence de nœuds de niveau supérieur ou un autre groupe de nœuds. Vous pouvez vous référer au fil d’Ariane dans le coin supérieur gauche de l’éditeur de nœuds pour voir où vous vous situez dans la hiérarchie.
Exemple de groupe de nœuds développé.¶
Ungroup¶
Référence
- Menu:
- Raccourci:
Ctrl-Alt-G
Supprime le groupe et place les nœuds individuels dans votre espace de travail d’éditeur. Aucune connexion interne n’est perdue et vous pouvez désormais lier des nœuds internes à d’autres nœuds de votre espace de travail.
Separate¶
Référence
- Raccourci:
P
L’opérateur Separate supprime les nœuds sélectionnés d’un groupe de nœuds et les place dans l’arborescence des nœuds parent. C’est utile lorsque les nœuds doivent être modifiés en dehors d’un groupe pour plus de clarté ou de réutilisation.
- Copy
Duplique les nœuds sélectionnés dans l’arborescence des nœuds parents, tout en conservant les originaux à l’intérieur du groupe. C’est utile lorsque vous souhaitez réutiliser des nœuds en dehors du groupe tout en conservant la définition du groupe.
- Move
Déplace les nœuds sélectionnés vers l’arborescence des nœuds parents, en les supprimant du groupe d’origine. C’est utile lors de la simplification d’un groupe ou de l’exposition directe de son contenu.
Join Group Inputs¶
Référence
- Menu:
- Raccourci:
Ctrl-J
Fusionne plusieurs nœuds Group Input sélectionnés en un seul nœud Group Input consolidé lorsque cela est possible. Les liens existants sont conservés et les entrées en double sont unifiées pour réduire l’encombrement et simplifier l’arborescence des nœuds.
Cette opération est utile pour nettoyer les groupes de nœuds qui sont devenus désorganisés ou qui contiennent des nœuds d’entrée redondants.