Scriptage dans Rhino
Toutes les commandes de Rhino peuvent être utilisées dans des scripts de commandes. Les scripts de commande peuvent être lancés à partir de la ligne de commandes, de boutons, de raccourcis
, d’alias de commandes
, de la commande LireFichierCommande
ou avec la commande Coller
utilisée dans l’invite de commandes de Rhino.
Écrire des scripts de commande
Écrivez les scripts de commande tout comme vous écririez la séquence de commandes dans la ligne de commandes. Un espace entre les caractères ou une nouvelle ligne agit comme si vous appuyiez sur Entrée
dans la ligne de commandes.
Caractères spéciaux
Caractère |
Signification dans le script |
! |
Annule la commande précédente. Un point d’exclamation (!) suivi d’un espace au début d’un script annule toute commande en cours. En toute autre position, il annule le script. Si nécessaire, le point d’exclamation peut aussi être utilisé à la fin d’un script. |
_ |
Exécute une commande avec son nom en anglais. Rhino est traduit en plusieurs langues. Les commandes, les invites, les options, les boîtes de dialogue, les menus, etc., des versions traduites sont affichés dans leur langue respective. Les commandes en anglais ne fonctionneront pas dans ces versions. Pour que les scripts fonctionnent sur tous les ordinateurs (quelle que soit la langue de travail), Rhino doit interpréter toutes les commandes comme s’il s’agissait de commandes écrites en anglais. Par exemple : dans la version française de Rhino, le script suivant fonctionne : Cercle 3Points 0,0,0 1,1,0 0,3,0 Mais dans la version espagnole de Rhino il ne fonctionnera pas. Vous devrez alors utiliser un de ces scripts : Círculo 3Puntos 0,0,0 1,1,0 0,3,0 Afin de vous assurer que tous les scripts fonctionnent dans le monde entier, écrivez-les en anglais et utilisez le symbole _ devant toutes les commandes et leurs options. |
- |
Toutes les commandes peuvent être scriptées dans la ligne de commandes (même les commandes qui présentent une boîte de dialogue). Pour éviter la boîte de dialogue et utiliser les options dans la ligne de commandes, précédez le nom de la commande d’un tiret (-). |
‘ |
La commande suivante est une commande encastrable. La manipulation du plan de construction et de la vue et les accrochages aux objets sont des commandes encastrables. Les commandes de création de géométrie ne sont pas encastrables. Les accrochages aux objets temporaires |
\ |
Si le premier caractère d’un script de barre d’outils n’est pas “!” et si le dernier caractère est ” \”, le script est lancé dans la ligne de commande sans la fonction Entrée, d’autres informations peuvent alors être ajoutées. Cette fonction est utile pour créer une chaîne de commande composée de chiffres, de virgules, d’angles (comme par exemple “<45″) représentés sur les boutons pour créer ainsi un “clavier numérique”. |
; (point-virgule) |
Les lignes commençant par un point-virgule (; ) ne sont pas une partie proprement dite du script, elles vous permettent d’écrire des commentaires dans le script ou d’essayer des données différentes. Par exemple : ; Cette macro est un test |
Exemples
Dessiner un cercle
Ce script crée un cercle dont le centre se trouve au point 5,5 et dont le rayon est de 10 :
! -Cercle 5,5 10
Les espaces entre les entrées correspondent aux moments où vous appuieriez sur la touche Entrée
si vous tapiez la commande à la main
Annuler la sélection en cours et lancer la commande Déplacer
Ce script lance la commande Déplacer
mais vérifie qu’aucun objet n’est sélectionné avant de vous demander de sélectionner les objets à déplacer :
! RienSélectionner Déplacer
Créer une courbe passant par des points
Ce script crée un groupe de points à partir d’un fichier de texte, il sélectionne ensuite tous les points et dessine une polyligne passant par ces derniers :
! ToutSélectionner Points Pause Pause Entrée InverserSél CourbeParPt Entrée
Comment fonctionne ce script :
! ToutSélectionner |
Annule toute commande en cours et sélectionne tous les objets se trouvant dans le modèle. |
Points |
Lance la commande Points. |
Pause x 3 |
Permet de choisir trois points. |
Entrée |
Simule le fait d’appuyer sur la touche Entrée qui arrête la création de points. |
InverserSél |
Inverse la sélection. Tous les objets visibles dans la scène ont été sélectionnés au début du script, donc, après avoir utilisé la commande InverserSél, seuls les nouveaux points créés sont sélectionnés. |
CourbeParPt |
Crée une polyligne passant par les objets ponctuels sélectionnés. |
Entrée |
Termine la commande |
Pour éviter l’utilisation d’une boîte de dialogue
! -Reconstruire Pause Points=10 Degré=3 Entrée
Sélectionner une courbe et lancer ce script. Toutes les options seront définies par ce script.
Pour essayer ces scripts :
-
Sélectionnez le script de ce chapitre de l’aide :
-
Appuyez sur Ctrl
+C
pour copier le texte dans le presse-papiers. -
Cliquez dans l’invite de commandes de Rhino et appuyez sur Ctrl +V pour coller le script
Commandes spéciales de scriptage
Pause |
Pause dans un script pour que l’utilisateur puisse introduire une donnée. Exemple : ! Cercle Pause 50 Ce script demande un point et dessine ensuite un cercle centré en ce point et de rayon 50 unités. |
Entrée |
Simule le fait d’appuyer sur la touche Entrée dans un script. Cette commande ne répète pas la commande précédente comme si vous appuyiez sur la touche Entrée . |
DésactiverRégénération |
Évite la régénération de l’écran et les changements de plan de construction ou de caméra pendant l’exécution de scripts. |
ActiverRégénération |
Réactive l’option de redessiner l’écran après avoir utilisé la commande DésactiverRégénération |
CopierInvitesDésactivé |
Désactive la copie des commandes de script dans la fenêtre de l’historique. |
CopierInvitesActivé |
Active la copie des commandes de script dans la fenêtre de l’historique. |
Notes
-
Si vous ne savez pas comment écrire un script, lancez la version de la commande avec un tiret. Sélectionnez et copiez la séquence de commande et collez-la dans votre texte de script.
Ouvre une fenêtre d’édition pour la création et le test de scripts.
Étapes :
-
Tapez des commandes dans la fenêtre de l’éditeur de macros.
-
Pour effectuer un test, cliquez sur Lancer.
-
Pour supprimer la macro, cliquez sur Supprimer.
Notes
-
Si vous sélectionnez une portion de texte et cliquez sur Lancer, seule cette partie de la macro sera exécutée.
-
Un menu contextuel accessible avec le bouton de droite de la souris permet de tout sélectionner, de copier, de coller, de supprimer, de lancer la macro, etc.
Utilitaires > Ouvrir l’éditeur de macro
Outils > Commandes > Éditeur de macro Voir aussi… |
Lit et exécute un script de commande à partir d’un fichier de texte.
Étapes :
-
Dans la boîte de dialogue Ouvrir un fichier de texte, sélectionnez le fichier à lire.
-
Le texte se trouvant dans le fichier est copié dans la ligne de commande et les lignes du fichier de commandes sont interprétées comme si elles avaient été tapées dans l’invite.
Notes
-
Quand vous créez des fichiers de commande, utilisez la commande Entrée
qui équivaut à l’utilisation de la touche Entréepour exécuter les commandes
-
Si vous lisez un fichier assez souvent, vous pouvez assigner à un bouton la commande LireFichierCommandes avec le nom du fichier. Par exemple :
-
-LireFichierCommandes monfichier.txt
Si le nom du fichier contient des espaces, écrivez-le entre guillemets. Par exemple :
-LireFichierCommandes “mon fichier.txt”
Exemple
Créez un fichier de texte comme dans l’exemple suivant qui contient des commandes pour créer toutes vos courbes. Dessinez ensuite les courbes en une seule fois avec LireFichierCommandes.
23,5,0
23.2,5,0
23.7,5.2,1
Entrée
CourbeInterp
26.1,4.9,1.1
26.8,4.9,1.0
27.1,4.8,0.9
Entrée
etc.
Outils > Lire un fichier de commandes
Outils > Commandes > Lire dans un fichier Voir aussi… |
Arrête un script pour que l’utilisateur puisse réaliser une action.
Exemple :
Ce script demande un point et dessine ensuite un cercle centré en ce point et d’un rayon de 50 unités.
! Cercle Pause 50
Aucun
Aucun Voir aussi… |
Fonctionne comme si on appuyait sur la touche Entrée, elle est utilisée dans les scripts ou la programmation de boutons de barres d’outils.
Exemple
Ce script définit un plan de construction à partir de trois points :
‘PlanC 3Points
Pause Pause Pause Entrée
Notes
-
La commande Entrée ne répète pas la commande précédente comme si vous appuyiez sur la touche Entrée
.
Aucun
Aucun Voir aussi… |
Active la copie des commandes de script dans la fenêtre de l’historique.
Aucun
Aucun Voir aussi… |
Désactive la copie des commandes de script dans la fenêtre de l’historique.
Aucun
Aucun Voir aussi… |
Active la régénération de l’écran et les changements de plan de construction ou de caméra pendant l’exécution de scripts.
Notes
-
Réactive l’option de redessiner l’écran après avoir utilisé la commande DésactiverRégénération .
Vue > Activer régénération (Bouton de droite)
Aucun Voir aussi… |
Désactive la régénération de l’écran et les changements de plan de construction ou de caméra pendant l’exécution de scripts.
Notes
-
Réactivez la régénération de l’écran avec la commande DésactiverRégénération .
Vue : Désactiver régénération
Aucun Voir aussi… |
Annule la commande en cours et la sélection des objets.
Principale1 > Annuler
Aucun
Touche de raccourci : Échap Voir aussi… |
Ferme la session de Rhino en cours.
Aucun
Aucun Voir aussi… |
Lance une autre application à partir de Rhino.
Étapes :
-
Tapez le nom et le chemin du fichier à lancer.
Aucun
Aucun Voir aussi… |
Joint des informations textuelles à un objet.
Les informations sont enregistrées dans une hiérarchie clé/valeur comme celle utilisée par le registre de Windows.
La commande ObtenirTexteUtilisateur
permet de récupérer les informations. Ces informations peuvent aussi être liées avec des modules .NET et des scripts VisualBasic.
Elles sont facilement accessibles à l’aide de scripts .NET et Visual Basic.
Exemple
Clé du texte = Poids
Texte = Kilogrammes
Étapes :
-
Sélectionnez des objets.
-
Tapez une clé de texte.
-
Tapez le texte.
Options
LierÀ
Objet
Les informations sont liées à la géométrie de l’objet.
Si les informations concernent plutôt la géométrie de l’objet, il vaut mieux les lier à la géométrie. Par exemple, le rayon d’un cercle doit être lié à la géométrie car les informations ne seront plus correctes si le cercle est modifié à l’aide des points de contrôle afin de créer une courbe NURBS.
Attributs
Les informations sont liées aux attributs de l’objet.
Si les informations sont plus générales, telles que la couleur, elles doivent être liées aux attributs de l’objet. Les informations d’attributs seront conservées lorsque l’objet est modifié, limité, copié ou transformé d’une autre façon.
Aucun
Aucun Voir aussi… |
Récupère les informations liées en utilisant la commande DéfinirTexteUtilisateur
. Ces informations peuvent aussi être récupérées avec des modules .NET et des scripts VisualBasic.
Étapes :
-
Sélectionnez des objets.
-
Tapez une clé de texte ou appuyez sur Entrée
pour voir toutes les clés.
Aucun
Aucun Voir aussi… |