L’interface utilisateur de Dynamo est organisée en cinq zones principales. Nous allons faire ici une présentation succincte et expliquer plus en détail l’espace de travail et la bibliothèque dans les sections suivantes.
Menus
Barre d'outils
Bibliothèque
Espace de travail
Barre d’exécution
Voici les menus des fonctionnalités de base de l’application Dynamo. Comme la plupart des logiciels Windows, les deux premiers menus concernent la gestion des fichiers, les opérations de sélection et la modification du contenu. Les autres menus sont plus spécifiques de Dynamo.
Des informations générales et des paramètres sont disponibles dans le menu déroulant Dynamo.
À propos de : découvrez la version de Dynamo installée sur votre ordinateur.
Accord sur la collecte des données d’utilisation : permet d’accepter ou de refuser le partage de vos données utilisateur pour améliorer Dynamo.
Préférences : inclut des paramètres tels que la précision décimale de l’application et la qualité du rendu de la géométrie.
Quitter Dynamo.
Si vous êtes bloqué, consultez le menu Aide. Vous pouvez accéder à l’un des sites Web de référence Dynamo via votre navigateur Internet.
Mise en route : brève introduction à l’utilisation de Dynamo.
Guides interactifs.
Échantillons : fichiers d'exemple de référence.
Dictionnaire Dynamo : ressource avec documentation sur tous les nœuds.
Site Web Dynamo : affichez le projet Dynamo sur GitHub.
Wiki du projet Dynamo : permet de consulter le wiki pour en savoir plus sur le développement à l’aide de l’API Dynamo, qui prend en charge les bibliothèques et les outils.
Afficher la page de démarrage : permet de revenir à la page de démarrage de Dynamo lorsque vous vous trouvez dans un document.
Signaler un bogue : permet d'ouvrir un problème sur GitHub.
La barre d'outils de Dynamo contient une série de boutons permettant d'accéder rapidement aux fichiers et aux commandes Annuler [Ctrl + Z] et Rétablir [Ctrl + Y]. À l’extrémité droite se trouve un autre bouton qui permet d’exporter un cliché de l’espace de travail, ce qui est extrêmement utile pour la documentation et le partage.
La bibliothèque Dynamo est un ensemble de bibliothèques fonctionnelles, chaque bibliothèque contenant des nœuds regroupés par catégorie. Elle se compose de bibliothèques de base qui sont ajoutées lors de l’installation par défaut de Dynamo. Au fur et à mesure de la présentation de son utilisation, vous allez découvrir comment étendre la fonctionnalité de base avec des nœuds personnalisés et d’autres packages. La section Bibliothèque fournit des instructions plus détaillées sur son utilisation.
L’espace de travail est l’endroit où vous composez vos programmes visuels, vous pouvez également modifier son paramètre d’aperçu pour afficher les géométries 3D à partir d’ici. Pour plus d’informations, reportez-vous à Espace de travail.
Exécutez votre script Dynamo à partir d’ici. Cliquez sur l’icône déroulante du bouton Exécution pour passer d’un mode à l’autre.
Automatique : exécute votre script automatiquement. Les modifications sont mises à jour en temps réel.
Manuel : le script s’exécute uniquement lorsque vous cliquez sur le bouton « Exécuter ». Utile pour modifier des scripts complexes.
Périodique : cette option est grisée par défaut. Disponible uniquement lorsque le nœud DateTime.Now est utilisé. Vous pouvez définir l’exécution automatique du graphique à un intervalle spécifié.
L’espace de travail de Dynamo se compose de quatre éléments principaux.
Tous les onglets actifs.
Mode aperçu
Commandes Zoom/Panoramique
Nœud dans l’espace de travail
Lorsque vous ouvrez un nouveau fichier, un nouvel espace de travail d’accueil s’ouvre par défaut.
Vous pouvez créer un nœud personnalisé et l’ouvrir dans un espace de travail de nœud personnalisé.
Vous ne pouvez ouvrir qu’un seul espace de travail d’accueil dans chaque fenêtre Dynamo, mais vous pouvez ouvrir plusieurs espaces de travail de nœud personnalisé dans les onglets.
Il existe 3 méthodes permettant de passer d’un aperçu à un autre :
a. Utilisation des icônes situées en haut à droite
b. Clic avec le bouton droit de la souris dans l’espace de travail
Passage de l’aperçu 3D à l’aperçu du graphique
Passage de l’aperçu du graphique à l’aperçu 3D
c. Utilisation du raccourci clavier (Ctrl+B)
Vous pouvez utiliser des icônes ou la souris pour naviguer dans l’un ou l’autre des espaces de travail.
a. En mode Aperçu du graphique
À l’aide d’icônes :
À l’aide de la souris :
Clic avec le bouton gauche de la souris – Sélection
Clic avec le bouton gauche de la souris et glissement – Zone de sélection permettant de sélectionner plusieurs nœuds
Défilement vers le haut/bas au milieu – Zoom avant/arrière
Clic avec le bouton du milieu de la souris et glissement – Panoramique
Clic avec le bouton droit de la souris n’importe où dans la zone de dessin – Ouvrir la recherche dans la zone de dessin
b. En mode Aperçu 3D
À l’aide d’icônes :
À l’aide de la souris :
Défilement vers le haut/bas au milieu – Zoom avant/arrière
Clic avec le bouton du milieu de la souris et glissement – Panoramique
Clic avec le bouton droit de la souris et glissement – Orbite
Cliquez avec le bouton droit de la souris pour sélectionner un nœud.
Pour sélectionner plusieurs nœuds, cliquez et effectuez un glisser-déposer afin de créer une zone de sélection.
La bibliothèque contient tous les nœuds chargés, y compris les nœuds de catégorie par défaut fournis avec l’installation, ainsi que tous les autres nœuds ou packages personnalisés chargés. Les nœuds de la bibliothèque sont organisés de manière hiérarchique dans les bibliothèques, les catégories et, le cas échéant, les sous-catégories.
Nœuds de base : fournis avec l’installation par défaut.
Nœuds personnalisés : stockez vos routines fréquemment utilisées ou votre graphique spécial en tant que nœuds personnalisés. Vous pouvez également partager vos nœuds personnalisés avec la communauté.
Nœuds du gestionnaire de package : collection de nœuds personnalisés publiés.
Nous allons parcourir la catégorie Hiérarchie des nœuds, apprendre comment effectuer rapidement une recherche dans la bibliothèque et découvrir certains des nœuds fréquemment utilisés.
Parcourir ces catégories est la manière la plus rapide de comprendre la hiérarchie des éléments que vous pouvez ajouter à votre espace de travail et la meilleure façon de découvrir les nouveaux nœuds que vous n'avez pas utilisés auparavant.
Parcourez la bibliothèque en cliquant sur les menus pour développer chaque catégorie et sa sous-catégorie.
Géométrie est un excellent menu à explorer en premier, car il contient la plus grande quantité de nœuds.
Bibliothèque
Catégorie
Sous-catégorie
Nœud
Ces menus permettent de classer les nœuds dans la même sous-catégorie selon que les nœuds créent des données, exécutent une action ou interrogent des données.
Placez le curseur de la souris sur un nœud pour afficher des informations plus détaillées que son nom et son icône. Ces informations permettent de comprendre ce que fait le nœud, ce qu’il requiert pour les entrées et ce qu’il va donner en sortie.
Description : description du nœud en langage simple
Icône : version plus grande de l'icône dans le menu de la bibliothèque
Entrée(s) : nom, type de données et structure de données
Sortie(s) : type de données et structure
Si vous avez une idée du nœud que vous souhaitez ajouter à votre espace de travail, faites une recherche dans le champ Rechercher pour rechercher tous les nœuds correspondants.
Cliquez sur le nœud que vous souhaitez ajouter ou appuyez sur la touche Entrée pour ajouter les nœuds mis en surbrillance au centre de l’espace de travail.
Outre l’utilisation de mots-clés pour rechercher des nœuds, vous pouvez saisir la hiérarchie en la séparant par un point dans le champ de recherche ou par des nœuds Code Block (qui utilisent le langage textuel Dynamo).
La hiérarchie de chaque bibliothèque est reflétée dans le nom des nœuds ajoutés à l’espace de travail.
La saisie de différentes parties de la position du nœud dans la hiérarchie de la bibliothèque au format library.category.nodeName
renvoie différents résultats :
library.category.nodeName
category.nodeName
nodeName
ou keyword
En règle générale, le nom du nœud dans l’espace de travail est rendu au format category.nodeName
, à quelques exceptions près, notamment dans les catégories Input et View.
Attention aux nœuds ayant un nom similaire et notez la différence de catégorie :
Les nœuds de la plupart des bibliothèques incluent le format de catégorie.
Les nœuds Point.ByCoordinates
et UV.ByCoordinates
portent le même nom, mais proviennent de différentes catégories.
Les exceptions notables incluent les fonctions intégrées : Core.Input, Core.View et Operators.
Compte tenu du fait que l’installation de base de Dynamo comprend des centaines de nœuds, quels nœuds sont essentiels au développement de programmes visuels ? Concentrez-vous sur ceux qui permettent de définir les paramètres de votre programme (Input), d’afficher les résultats de l’action d’un nœud (Watch) et de définir les entrées ou les fonctionnalités par le biais d’un raccourci (Code Block).
Les nœuds Input sont les principaux moyens pour que l'utilisateur de votre programme visuel, que ce soit vous-même ou quelqu'un d'autre, interagisse avec les paramètres clés. En voici quelques-uns disponibles dans la bibliothèque principale :
Les nœuds Watch sont essentiels pour la gestion des données qui circulent dans votre programme visuel. Vous pouvez afficher le résultat d’un nœud dans l’aperçu des données de nœud en plaçant le curseur de la souris sur le nœud.
Il sera utile de l’afficher dans un nœud Watch
Vous pouvez également afficher les résultats de la géométrie à l’aide d’un nœud Watch3D.
Ces deux nœuds sont disponibles dans la catégorie View de la bibliothèque Core.
Conseil : il peut arriver que l’aperçu 3D soit gênant lorsque votre programme visuel contient un grand nombre de nœuds. Pensez à désactiver l’option Afficher l’aperçu en arrière-plan dans le menu Paramètres et à utiliser un nœud Watch3D pour afficher un aperçu de la géométrie.
Les nœuds Code Block servent à définir un bloc de code avec des lignes séparées par des points-virgules. Cela peut être aussi simple que X/Y
.
Vous pouvez également utiliser les nœuds Code Block comme raccourci pour définir un nœud Number Input ou appeler la fonctionnalité d’un autre nœud. La syntaxe permettant de procéder à cette opération suit la convention d’attribution de noms du langage textuel Dynamo, DesignScript.
Voici une démonstration simple (avec des instructions) de l’utilisation du nœud Code Block dans votre script.
Double-cliquez pour créer un nœud Code Block.
Circle.ByCenterPointRadius(x,y);
Type
Cliquez sur l’espace de travail pour effacer la sélection et ajouter automatiquement les entrées x
et y
.
Créez les nœuds Point.ByCoordinates et Number Slider, puis connectez-les aux entrées du nœud Code Block.
Le résultat de l’exécution du programme visuel est affiché sous forme de cercle dans l’aperçu 3D.
Nouveau : permet de créer un fichier .dyn
Ouvrir : permet d’ouvrir un fichier .dyn (espace de travail) ou .dyf (nœud personnalisé).
Enregistrer/Enregistrer sous : permet d’enregistrer votre fichier .dyn ou .dyf actif
Annuler : permet d’annuler la dernière action
Rétablir : permet de rétablir la prochaine action
Exporter l’espace de travail en tant qu’image : permet d’exporter l’espace de travail visible en tant que fichier PNG.
Aperçu du graphique
Aperçu 3D
Zoom fenêtre
Appliquer un zoom avant
Appliquer un zoom arrière
Panoramique
Zoom fenêtre
Appliquer un zoom avant
Appliquer un zoom arrière
Panoramique
Orbite
Créer : créez ou construisez une géométrie à partir de zéro, par exemple, un cercle.
Action : effectuez une action sur un objet, par exemple, mettre un cercle à l’échelle.
Requête : permet d’obtenir une propriété d’un objet qui existe déjà, par exemple, obtenir le rayon d’un cercle.
Noeud | Nœud | ||
---|---|---|---|
Boolean
Number
String
Number Slider
Directory Path
Integer Slider
File Path