![[Pas encore réalisée.]](../image/icons/MacroEditor.png "[Pas encore réalisée.]"){kind=icon}
![[Pas encore réalisée.]](../Menu2.png "[Pas encore réalisée.]"){kind=small}
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.
É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 3.0, le script suivant fonctionne : Cercle 3Points 0,0,0 1,1,0 0,3,0 Mais dans la version espagnole de Rhino 3.0 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 et les filtres de sélection sont automatiquement encastrables et n'ont pas besoin d'être précédés d'une apostrophe. |
|
; |
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 |
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 dans un fichier de texte
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 |
Annule toute commande en cours et sélectionne tous les objets se trouvant dans le modèle. |
|
Points |
Crée un objet ponctuel pour chaque paire de coordonnées indiquée. |
|
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. |
Pour éviter l'utilisation d'une boîte de dialogue
! -Hélice pause -pause Tours=8.2 InverserDirection=Oui
L'invite vous demandera les extrémités de l'axe. Les autres options (nombre de tours et inverser rotation) seront définies par le script. Dans la commande Hélice, ces options sont définies dans une boîte de dialogue.
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. |
Remarques
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.
Remarques
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.
|
|
Lit et exécute un script de commande à partir d'un fichier de texte.
Étapes :
Dans la boîte de dialogue Lire un fichier de commandes, 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.
Remarques
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
Cliquez sur le bouton pour lire le fichier. Si vous n'indiquez pas de fichier, une boîte de dialogue s'ouvre. Vous pouvez alors sélectionner un fichier dans la liste.
Si le nom du fichier contient des espaces, écrivez-le entre guillemets. Par exemple :
-LireFichierCommandes "mon fichier.txt"
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….
|
|
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
|
|
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 l'axe des z :
'PlanC 3Points
Pause Pause Entrée
Remarques
La commande Entrée ne répète pas la commande précédente comme si vous appuyiez sur la touche Entrée.
|
|
|
|
|
|
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.
Remarques
Réactive l'option de redessiner l'écran après avoir utilisé 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.
Remarques
Réactivez la régénération de l'écran avec la commande DésactiverRégénération.
|
|
Annule la commande en cours et la sélection des objets.
|
|
Ferme la session de Rhino en cours.
|
|
Lance une autre application à partir de Rhino.
Étapes :
Tapez le nom et le chemin du fichier à lancer.
|
|
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À
Géométrie
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.
|
|
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.
|
|
![[Pas encore réalisée.]](../image/icons/ReadCommandFile.png "[Pas encore réalisée.]"){kind=icon}
![[Pas encore réalisée.]](../image/icons/_ABlankButton.png "[Pas encore réalisée.]"){kind=icon}
![[Pas encore réalisée.]](../image/icons/setredrawon.png "[Pas encore réalisée.]"){kind=icon}
![[Pas encore réalisée.]](../image/icons/SetRedrawOff.png "[Pas encore réalisée.]"){kind=icon}
![[Pas encore réalisée.]](../image/icons/Cancel.png "[Pas encore réalisée.]"){kind=icon}