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

!
(point d’exclamation)

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.

_
(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, 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
_Circle _3Point 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.

-
(trait d’union)

Évite une boîte de dialogue.

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 (-).


(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’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)

Commentaire.

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

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 :

  1. Sélectionnez le script de ce chapitre de l’aide :

  2. Appuyez sur Ctrl

    +C pour copier le texte dans le presse-papiers.

  3. 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.

ÉditeurMacro

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.

Rhinoceros MacroEditor Scriptage

Utilitaires > Ouvrir l’éditeur de macro

Rhinoceros Menu2 Scriptage

Outils > Commandes > Éditeur de macro

Rhinoceros Gray Book Open Scriptage Voir aussi…

LireFichierCommandes

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ée

    pour 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.

Rhinoceros ReadCommandFile Scriptage

Outils > Lire un fichier de commandes

Rhinoceros Menu2 Scriptage

Outils > Commandes > Lire dans un fichier

Rhinoceros Gray Book Open Scriptage Voir aussi…

Pause

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

Rhinoceros  ABlankButton Scriptage

Aucun

Rhinoceros Menu2 Scriptage

Aucun

Rhinoceros Gray Book Open Scriptage Voir aussi…

Entrée

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

    .

Rhinoceros  ABlankButton Scriptage

Aucun

Rhinoceros Menu2 Scriptage

Aucun

Rhinoceros Gray Book Open Scriptage Voir aussi…

CopierInvitesActivé

Active la copie des commandes de script dans la fenêtre de l’historique.

Rhinoceros  ABlankButton Scriptage

Aucun

Rhinoceros Menu2 Scriptage

Aucun

Rhinoceros Gray Book Open Scriptage Voir aussi…

CopierInvitesDésactivé

Désactive la copie des commandes de script dans la fenêtre de l’historique.

Rhinoceros  ABlankButton Scriptage

Aucun

Rhinoceros Menu2 Scriptage

Aucun

Rhinoceros Gray Book Open Scriptage Voir aussi…

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.

Notes

  • Réactive l’option de redessiner l’écran après avoir utilisé la commande DésactiverRégénération

    .

Rhinoceros setredrawon Scriptage

Vue > Activer régénération (Bouton de droite)

Rhinoceros Menu2 Scriptage

Aucun

Rhinoceros Gray Book Open Scriptage Voir aussi…

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.

Notes

  • Réactivez la régénération de l’écran avec la commande DésactiverRégénération

    .

Rhinoceros SetRedrawOff Scriptage

Vue : Désactiver régénération

Rhinoceros Menu2 Scriptage

Aucun

Rhinoceros Gray Book Open Scriptage Voir aussi…

Interrompre

Annule la commande en cours et la sélection des objets.

Rhinoceros Cancel Scriptage

Principale1 > Annuler

Rhinoceros Menu2 Scriptage

Aucun

Rhinoceros key 008 Scriptage

Touche de raccourci : Échap

Rhinoceros Gray Book Open Scriptage Voir aussi…

Quitter

Ferme la session de Rhino en cours.

Rhinoceros  ABlankButton Scriptage

Aucun

Rhinoceros Menu2 Scriptage

Aucun

Rhinoceros Gray Book Open Scriptage Voir aussi…

Lancer

Lance une autre application à partir de Rhino.

Étapes :

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

Rhinoceros  ABlankButton Scriptage

Aucun

Rhinoceros Menu2 Scriptage

Aucun

Rhinoceros Gray Book Open Scriptage Voir aussi…

DéfinirTexteUtilisateur

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 :

  1. Sélectionnez

    des objets.

  2. Tapez une clé de texte.

  3. 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.

Rhinoceros  ABlankButton Scriptage

Aucun

Rhinoceros Menu2 Scriptage

Aucun

Rhinoceros Gray Book Open Scriptage Voir aussi…

ObtenirTexteUtilisateur

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 :

  1. Sélectionnez

    des objets.

  2. Tapez une clé de texte ou appuyez sur Entrée

    pour voir toutes les clés.

Rhinoceros  ABlankButton Scriptage

Aucun

Rhinoceros Menu2 Scriptage

Aucun

Rhinoceros Gray Book Open Scriptage Voir aussi…

 

Scriptage