DesignSeries00007.pngRéseaux de Marionnette

Un réseau est un ensemble de nœuds connectés pour créer un script fonctionnel, qui exécute les commandes définies par ces nœuds. Un réseau terminé est considéré comme un script Marionnette. Tous les scripts se lisent de gauche à droite et les données circulent dans une seule direction. Vous ne pouvez créer et éditer des réseaux que dans une vue Plan 2D.

Créer un réseau

Pour créer un réseau:

  1. Avec l’outil Sélection, cliquez sur le point de contrôle du port de sortie d’un nœud, puis déplacez le curseur et cliquez sur le port d’entrée d’un autre nœud.

  2. Assurez-vous que le mode Déplacer de l’outil Sélection est désactivé.

  3. Les deux ports sont connectés par un fil. La sortie d’un nœud peut être connectée à plusieurs entrées d’autres nœuds. Inversement, une seule entrée peut être connectée à plusieurs sorties.

Marionnette00008.png 

Pour améliorer la disposition d’un réseau complexe, utilisez les commandes Aligner/Distribuer pour arranger les nœuds. Cette action n’a pas d’influence sur les fils. (Voir Aligner/distribuer des objets.)

Nommer les nœuds

Pour créer et organiser un réseau, il est important de donner un nom aux nœuds. Cela a également une influence significative sur les nœuds wrapper; voir Noeuds wrapper de Marionnette. Donnez un nom aux nœuds d’entrée (input), ainsi qu’aux nœuds auxquels ceux-ci sont reliés, afin de vous souvenir facilement des différentes étapes de réseaux plus compliqués. Pour donner un nom à un nœud, sélectionnez le nœud et saisissez son Nom dans la palette Info Objet.

Les nœuds d’entrée qui ont un nom apparaissent comme paramètre dans la palette Info Objet des nœuds wrapper. Donnez-leur un nom distinctif pour en adapter facilement la valeur sans devoir éditer le nœud wrapper.

Les ports non utilisés de nœuds nommés apparaissent sur les nœuds wrapper afin qu’ils soient connectés facilement à d’autres réseaux. C’est une autre bonne raison de nommer les nœuds.

Marionnette00009.png 

Éditer un réseau

Pour éditer un réseau:

  1. Sélectionnez le nœud ou le fil à éditer.

  2. Dans le réseau représenté ci-dessus, sélectionnez le fil reliant le nœud Oval au nœud Column.

  3. Pour déconnecter le fil, sélectionnez le point de contrôle situé sur le port d’entrée.

  4. Dans le réseau représenté ci-dessus, sélectionnez le point de contrôle situé sur l’input « profile » du nœud Column.

  5. Connectez le fil à un autre port d’entrée ou supprimez le fil en cliquant dans une zone du dessin.

Si un nœud est supprimé, tous les fils associés seront également supprimés.

Exécuter un script Marionnette

Pour exécuter un script Marionnette, faites un clic droit sur un nœud dans le réseau et sélectionnez Exécuter script Marionnette dans le menu contextuel. Vous pouvez aussi sélectionner un nœud, puis cliquer sur Exécuter dans la palette Info Objet.

Si une erreur se produit lors de l’exécution du script, une boîte de dialogue « Execution Error » s’ouvre, reprenant les informations sur le type d’erreur et son emplacement dans le script.

En raison du langage de programmation utilisé, les objets créés suite à l’exécution du script  sont groupés une fois le script terminé. En exécutant le script plusieurs fois de suite, les objets créés suite à l'exécution précédente du script seront remplacés. Pour conserver les objets déjà créés, vous devez les renommer ou les dégrouper.

Déboguer un script Marionnette

Le mode de débogage de l’outil Marionnette permet de repérer les erreurs dans les réseaux, lorsque ceux-ci ne fonctionnent pas correctement. Lorsque vous sélectionnez le mode Debogage, un chiffre apparaît à côté de chaque port de sortie. Il s’agit du nombre de valeurs qui transitent de ce port de sortie aux ports d’entrée qui y sont liés. Cliquez sur un fil pour ouvrir la boîte de dialogue « Marionette Wire Value » et afficher les valeurs qui traversent le fil. Le script s’exécute à la fermeture de la boîte de dialogue.

Pour sauvegarder les valeurs du fil, cliquez sur Préférences dans la Barre des modes de Marionnette et cochez l’option Sauvegarder la dernière exécution en mode Débogage. Une fois ce mode activé, vous voyez apparaître les valeurs du fil sans devoir exécuter à nouveau le script.

Marionnette00012.png 

~~~~~~~~~~~~~~~~~~~~~~~~~

Types de noeuds

Insérer des nœuds

Noeuds wrapper de Marionnette

Créer des commandes de menu à partir de nœuds wrapper

Utiliser des nœuds Objet

Sauvegarder et exporter des réseaux