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 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 0,15,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 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.

_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éeFin

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

  1. Sélectionnez la macro de ce chapitre de l'aide.
  2. Appuyez sur Ctrl + C pour la copier dans le presse-papiers.
  3. 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 :

! _Circle _Pause 50

Cette macro demande un point et dessine ensuite un cercle centré en ce point et de rayon 50 unités.

MultiPause

Arrête un script  le temps de plusieurs sélections, comme pour les commandes Joindre, Polyligne ou CongéBord.

Entrée

Simule le fait d'appuyer sur Entrée dans une macro.

Cette commande ne répète pas la commande précédente comme si vous appuyiez sur 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.

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.

 

LireFichierCommandes

Barre d'outils Menu

Outils

Outils

Commandes >

Lire dans un fichier

La commande LireFichierCommandes lit et exécute une macro de commande à partir d'un fichier de texte.

Étapes

Notes

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.

! CourbeInterp
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.

 

CopierInvitesActivé

BarreOutils Menu

Pas dans les barres d'outils.

Pas dans les menus

La commande CopierInvitesActivé active la copie des commandes de macro dans la fenêtre de l'historique.

Pour désactiver la copie des invites, utilisez la commande CopierInvitesDésactivé.

 

CopierInvitesDésactivé

Barre d'outils Menu

Pas dans les barres d'outils.

Pas dans les menus

La commande CopierInvitesDésactivé désactive la copie des commandes de macro dans la fenêtre de l'historique.

CopierInvitesDésactivé ou _NoEcho doit être le tout premier mot de la macro pour qu'elle fonctionne correctement. Tout le reste, y compris le point d'exclamation, doit se trouver après, séparé par un espace simple.

 

Entrée

BarreOutils Menu

Pas dans les barres d'outils.

Pas dans les menus

La commande Entrée fonctionne comme si on appuyait sur Entrée ; elle est tilisé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

La commande Entrée ne répète pas la commande précédente comme si vous appuyiez sur Entrée.

 

EntréeFin

BarreOutils Menu

Pas dans les barres d'outils.

Pas dans les menus

La commande EntréeFin fonctionne comme si on appuyait sur la touche Entrée pour terminer une chaîne de commandes, elle est utilisée dans les macros ou la programmation de boutons de barres d'outils.

EntréeFin est utile lorsqu'une commande possède un grand nombre de niveaux d'options comme PropriétésDocument ou Options et que vous voulez quitter la commande sans avoir à taper autant de fois Entrée que de niveaux utilisés. Par exemple :

! _-DocumentProperties _Mesh _Custom _MaxEdgeSrf .01

nécessiterait au moins deux ou trois Entrée pour terminer la commande. Avec EntréeFin, la commande se termine quand vous voulez.

Exemple 

! _-DocumentProperties _Mesh _Custom _MaxEdgeSrf .01 _EnterEnd

 

Quitter

BarreOutils Menu

Pas dans les barres d'outils.

Fichier

Quitter

La commande Quitter ferme la session de Rhino en cours.

 

Pause

Barre d'outils Menu

Pas dans les barres d'outils.

Pas dans les menus

La commande Pause arrête une macro pour que l'utilisateur puisse réaliser une action.

Exemple 

Cette macro demande un point et dessine ensuite un cercle centré en ce point et de rayon 50 unités.

! _Circle _Pause 50

 

MultiPause

Barre d'outils Menu

Pas dans les barres d'outils.

Pas dans les menus

La commande MultiPause arrête une macro pour que l'utilisateur puisse réaliser une action.

Exemple 

Cette macro demande les objets à joindre.

! _Join _MultiPause

 

Lancer

La commande Lancer exécute une autre application à partir de Rhino.

Étapes

  • Tapez le nom et le chemin du fichier à lancer.

 

DésactiverRégénération

BarreOutils Menu

Vue

Pas dans les menus

La commande DésactiverRégénération 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.

Pour réactiver la régénération de l'écran

 

ActiverRégénération

BarreOutils Menu

Vue

Pas dans les menus

La commande ActiverRégénération 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.

Pour désactiver la régénération de l'écran

Pour de plus amples informations sur l'écriture de scripts dans Rhino, voir : http://wiki.mcneel.com/rhino/basicmacros.

 

LancerScriptPython

Barre d'outils Menu

Pas dans les barres d'outils.

Outils

Script de Python >

Lancer

La commande LancerScriptPython lance un script de Python.

Des références sont également disponibles en ligne pour les programmateurs sur Rhino.Python : http://www.rhino3d.com/5/ironpython/index.html.

-LancerScriptPython

Options

RedémarrerMoteur

Force le moteur Python à redémarrer. Cette option n'est utile que lorsque des scripts agissant sur plusieurs fichiers sont écrits et testés.

 

ModifierScriptPython

La commande ModifierScriptPython permet de modifier un script Python.

Pour de plus amples informations sur l'écriture de scripts dans Rhino, voir : http://wiki.mcneel.com/developer/python.

 

DéfinirTexteUtilisateur

BarreOutils Menu

Pas dans les barres d'outils.

Pas dans les menus

La commande DéfinirTexteUtilisateur joint des informations textuelles à un objet.

Les informations sont enregistrées au format clé/valeur.

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

  1. Sélectionnez des objets.
  2. Tapez une clé de texte.
  3. Tapez le texte.

Pour supprimer une clé

  1. Sélectionnez des objets.
  2. Tapez une clé de texte.
  3. Tapez "" (guillemets).

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.

 

ObtenirTexteUtilisateur

Barre d'outils Menu

Pas dans les barres d'outils.

Pas dans les menus

La commande ObtenirTexteUtilisateur récupère les informations textuelles qui ont été liées au fichier avec la commande DéfinirTexteUtilisateur. Ces informations peuvent aussi être récupérées avec des modules .NET et des scripts VisualBasic.

Étapes

  1. Sélectionnez un objet.
  2. Tapez une clé de texte ou appuyez sur Entrée pour toutes les clés.

 

DéfinirTexteUtilisateurDocument

BarreOutils Menu

Pas dans les barres d'outils.

Pas dans les menus

La commande DéfinirTexteUtilisateurDocument lie des informations textuelles à un fichier .3dm de Rhino.

Les informations sont enregistrées au format clé/valeur.

La commande ObtenirTexteUtilisateurDocument 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.

Étapes

  1. Tapez une clé de texte.
  2. Tapez le texte.

 

ObtenirTexteUtilisateurDocument

Barre d'outils Menu

Pas dans les barres d'outils.

Pas dans les menus

La commande ObtenirTexteUtilisateurDocument récupère les informations liées en utilisant la commande DéfinirTexteUtilisateurDocument. Ces informations peuvent aussi être récupérées avec des modules .NET et des scripts VisualBasic.

Étapes

  • Tapez une clé de texte ou appuyez sur Entrée pour toutes les clés.

 

 

Rhino for Mac © 2010-2016 Robert McNeel & Associates. 01-déc.-2016