Premier script avec Rhino Python : créer une ligne et automatiser avec ScriptEditor

Ce que vous allez apprendre dans ce guide

Ce guide explique comment préparer un petit script Python exécuté dans Rhino. Nous allons d’abord créer un nouveau fichier dans ScriptEditor, puis écrire un exemple qui ajoute une ligne entre deux points sélectionnés. Nous verrons ensuite comment exécuter le script, le déboguer, choisir l’environnement Python et gérer les dépendances.

L’exemple s’appuie sur les fonctions rhinoscriptsyntax de Rhino. L’objectif n’est pas de développer un outil complet, mais de comprendre les bases d’un script qui reçoit une saisie utilisateur et crée de la géométrie dans Rhino. Ce point de départ peut ensuite servir à automatiser des opérations de modélisation répétitives.

Prérequis et choix de version

Le flux de travail s’effectue dans Rhino et son ScriptEditor intégré. Saisissez ScriptEditor dans la ligne de commande pour ouvrir l’éditeur. Lors de la création d’un script, vous pouvez choisir Python 3 dans le menu File > New. Les sources ne mentionnent aucun autre prérequis, comme un compte, des frais ou du matériel spécifique.

Les options Python de Rhino sont proposées comme des implémentations distinctes, et non comme différentes versions d’un même moteur. Le guide décrit Python 3 comme étant basé sur CPython et Python 2 comme étant basé sur IronPython. Python 3 prend en charge les packages PyPI. Python 2 peut être envisagé pour certains scripts axés sur les appels RhinoCommon ou nécessitant le multithreading .NET. La documentation développeur recommande Python 3 comme choix de départ pour la plupart des nouveaux scripts.

Tenez également compte de la date des sources lorsque vous consultez les numéros de version. Le guide général Rhino.Python, mis à jour en 2025, indique Python 3.9.11 pour Rhino 8 et IronPython 2.7.12 pour Rhino 7. La documentation ScriptEditor, mise à jour en 2026, décrit les environnements d’exécution sans préciser ces numéros. Le mieux est donc de commencer par vérifier les options proposées dans l’éditeur de votre version installée de Rhino.

Créer votre premier script

1. Exécutez la commande ScriptEditor dans la ligne de commande de Rhino. Lorsque l’éditeur s’ouvre, sélectionnez Python 3 via File > New. ScriptEditor indique le langage et l’environnement d’exécution utilisés par le fichier en cours de modification.

2. Ajoutez le code suivant au nouveau script :

import rhinoscriptsyntax as rs

first_point = rs.GetPoint("Çizginin başlangıç noktası")
if first_point:
    second_point = rs.GetPoint("Çizginin bitiş noktası")
    if second_point:
        rs.AddLine(first_point, second_point)

Le code vous demande de sélectionner un premier point, puis un second dans Rhino. Une ligne est créée entre les deux points une fois les deux sélections effectuées. Si l’une des sélections n’est pas faite, le script ne passe pas à l’étape de création de la ligne. Les fonctions de l’exemple utilisent l’interface rhinoscriptsyntax de Rhino.

1. Exécutez le script avec Run > Run, puis sélectionnez les points demandés dans la fenêtre de Rhino. Vous pouvez enregistrer le fichier avec l’extension .py. L’option File > New From Template de l’éditeur permet également de créer un fichier à partir d’un modèle.

2. Gardez l’exemple simple pour observer le résultat de chaque étape. Vous pourrez ensuite appliquer la même approche à des opérations répétitives de sélection et de création de géométrie. Rhino.Python prend en charge des usages tels que les scripts interactifs, les commandes personnalisées et la génération de géométrie par algorithmes. L’exemple présenté ici se limite toutefois à la sélection de points et à la création d’une ligne.

Exécution, débogage et moteur Python

Il n’est pas nécessaire de lancer un script depuis l’éditeur à chaque fois. Selon le guide développeur de Rhino, ScriptEditor peut exécuter les fichiers enregistrés depuis la ligne de commande de Rhino, une macro, un bouton de barre d’outils ou un alias. Le script peut ainsi être associé à différents points de lancement dans Rhino, selon l’usage prévu. Si vous saisissez directement du code dans une macro, pensez à ajouter un indicateur de langage pour que Rhino puisse sélectionner le bon moteur.

L’extension et l’indicateur présent dans le script déterminent l’environnement Python utilisé pour ouvrir le fichier. #! python 3 ou #! python 2 indique le moteur correspondant ; les extensions .py3 et .py2 désignent également un environnement précis. Pour les fichiers .py classiques, l’environnement demandé par le script est pris en compte. Vérifiez ce point si le fichier ne s’exécute pas comme prévu.

Pour interrompre un script sur une ligne et examiner les variables, cliquez dans la marge située à côté de cette ligne dans l’éditeur afin d’y placer un point d’arrêt. Lancez ensuite le débogage via Run > Debug. Lorsque le script est suspendu, vous pouvez avancer pas à pas et examiner les variables dans les panneaux correspondants. L’option Debug est indisponible si aucun point d’arrêt n’a été défini.

Packages et problèmes à vérifier

Pour ajouter des packages PyPI aux scripts Python 3, utilisez l’option Install Package dans le panneau ScriptEditor. Vous pouvez rechercher un package ou saisir son nom et sa version. Si vous devez inclure les informations sur les packages dans le script, vérifiez que l’option Add Package Reference to Script est cochée ; selon le guide développeur, elle permet d’indiquer les packages requis dans le texte du script.

Les dépendances peuvent aussi être indiquées sous la forme d’une liste de plusieurs noms. La ligne suivante, par exemple, répertorie les packages numpy et requests :

#requirements: numpy, requests

Après l’installation d’un package ou une modification des modules importés, il peut être nécessaire de recharger le moteur Python concerné. Les options Tools > Reload Python 3 (CPython) Engine et Tools > Reload Python 2 (IronPython) Engine de ScriptEditor servent à cette fin ; selon le guide, il n’est pas nécessaire de redémarrer Rhino.

Si un script ne s’exécute pas, vérifiez d’abord sa compatibilité avec le moteur Python sélectionné ainsi que l’extension ou l’indicateur de langage utilisé. Pour un fichier qui utilise des packages, assurez-vous que les dépendances sont indiquées dans le script. Les sources ne présentent pas ces éléments comme des problèmes particulièrement fréquents ; ce sont des pistes à examiner pour en rechercher la cause. Pour le débogage, commencez également par placer un point d’arrêt avant de sélectionner Debug.

Étapes suivantes

Vous pouvez déplacer le code utilisé dans plusieurs scripts vers un module distinct, puis l’importer dans d’autres fichiers. Pour que Rhino puisse trouver ce module, son dossier doit figurer dans les chemins de recherche ; ces dossiers sont répertoriés dans la section Module Search Paths des Options. Le guide développeur mentionne également la possibilité d’ajouter un chemin au moyen d’un fichier .pth.

Pour des usages plus avancés, les scripts peuvent accéder à RhinoCommon. Python 3 le fait via Python.NET, tandis que Python 2 s’exécute sur .NET. Il est également possible d’utiliser Python dans Grasshopper, mais un guide distinct consacré à Grasshopper Python présente les composants et le flux de travail de l’éditeur. Pour choisir la suite, déterminez donc si vous avez besoin d’un script autonome dans Rhino ou d’un composant personnalisé exécuté dans une définition Grasshopper.

Sources et licence

Cet article est une adaptation originale en turc, fondée sur les guides développeur de McNeel « Scripting: Python » (K1) et « What is Rhino.Python? » (K2). Les sources indiquent une classification de licence « libre » ; les pages comportent une mention de copyright et la formule « All Rights Reserved », sans préciser de licence ouverte.