Macros et scripts de commandes

Où puis-je trouver ces commandes ?

Barres d'outils

Menus

Raccourci

Macros et scripts de commandes

Toutes les commandes de Rhino peuvent être utilisées dans des scripts de commandes. Les macros de commande peuvent être lancées à 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 au cours d'une commande de Rhino.

Écrire des macros de commandes

Écrivez les macros 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 la macro
* (astérisque)	Permet de répéter automatiquement la commande sans passer par la touche Entrée.
! (point d'exclamation)	Annule la commande précédente. Un point d'exclamation (!) suivi d'un espace au début d'une macro annule toute commande en cours. En toute autre position, il annule la macro. Si nécessaire, le point d'exclamation peut aussi être utilisé à la fin d'une macro.
_ (trait de soulignement)	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, la macro suivante fonctionne : Cercle 3Points 0,0,0 1,1,0 0,3,0 Mais dans la version espagnole de Rhino elle ne fonctionnera pas. Vous devrez alors utiliser une de ces macros : Círculo 3Puntos 0,0,0 1,1,0 0,3,0 _Circle _3Point 0,0,0 1,1,0 0,3,0 Afin de vous assurer que tous les macros fonctionnent dans le monde entier, écrivez-les en anglais et utilisez le symbole _ devant toutes les commandes et leurs options.
- (trait d'union)	Évite une boîte de dialogue. Toutes les commandes peuvent être transformées en macro dans la ligne de commande (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 (-).
' (apostrophe)	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 et les filtres de sélection sont automatiquement encastrables et n'ont pas besoin d'être précédés d'une apostrophe.
\ (barre oblique inverse)	Si le premier caractère d'une macro 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".
~ (tilde)	Supprime des options de commande pour obtenir des informations claires sur la commande. Les options fonctionnent toujours comme avant.
; (point-virgule)	Commentaire. Les lignes commençant par un point-virgule (; ) ne sont pas une partie proprement dite de la macro, elles permettent d'écrire des commentaires dans la macro ou d'essayer des données différentes. Par exemple : ; Cette macro est un test Cercle 0,0,0 15 Ligne 0,0,0 pause ;15,0,0 ; Ligne 0,0,0 0,15,0 Ligne 0,0,0 -15,0,0

Exemples

Dessiner un cercle

Cette macro 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

Cette macro 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

Cette macro crée un groupe de trois points à partir d'un fichier de texte, elle 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éeFin

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 _Pause _Pause	Permet de choisir trois points.
_Enter	Simule le fait d'appuyer sur la touche Entrée qui arrête la création de points.
_Invert	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 Inverser, seuls les nouveaux points créés sont sélectionnés.
_CurveThroughPt	Crée une polyligne passant par les objets ponctuels sélectionnés.
_EnterEnd	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 cette macro. Toutes les options seront définies par cette macro.

Pour essayer ces scripts

Sélectionnez la macro 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 la macro

Commandes spéciales de scriptage

Pause	Pause dans une macro pour que l'utilisateur puisse introduire une donnée. Exemple ! Cercle Pause 50 Cette macro 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 une macro. Cette commande ne répète pas la commande précédente comme si vous appuyiez sur la touche Entrée.
EntréeFin	Termine la commande
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 macros.
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 macro dans la fenêtre de l'historique.
CopierInvitesActivé	Active la copie des commandes de macro dans la fenêtre de l'historique.

Remarque : Si vous ne savez pas comment écrire une macro, 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 macro.

ÉditeurMacro