Scripts/fr

Introduction
Par script, nous entendons la création d'objets topologiques à l'aide de l'interpréteur Python de FreeCAD. FreeCAD pourrait être utilisé comme un "très bon" remplaçant d'OpenSCAD, principalement parce qu'il possède un véritable interpréteur Python, ce qui signifie qu'il dispose d'un véritable langage de programmation, presque tout ce que vous pouvez faire avec l'interface graphique est réalisable avec un script Python.

Malheureusement, les informations sur les scripts dans la documentation, et même dans ce wiki sont éparpillées et manquent d'uniformité "d'écriture" et la plupart d'entre elles sont expliquées d'une manière trop technique.



Commencer
Le premier obstacle d'une manière simple à la création de scripts est qu'il n'y a pas de moyen direct d'accéder à l'éditeur Python interne de FreeCAD via un élément de menu ou une icône dans la zone de la barre d'outils, mais sachant que FreeCAD ouvre un fichier avec un dans l'éditeur Python interne, l'astuce la plus simple est de créer dans votre éditeur de texte préféré, puis de l'ouvrir avec la commande habituelle.

Pour faire les choses d'une manière polie, le fichier doit être écrit avec un certain ordre, l'éditeur Python FreeCAD a une bonne "Syntaxe Highlighting" qui manque dans de nombreux éditeurs simples comme le Notepad de Windows ou certains éditeurs Linux de base, il suffit donc d'écrire ces quelques lignes :

Enregistrez-les avec un nom significatif avec l'extension et chargez le fichier résultant dans FreeCAD, avec la commande.

Un exemple simple de ce qu'il est nécessaire d'avoir dans un script est présenté dans cette partie du code que vous pourriez utiliser comme modèle pour presque tous les futurs scripts:

Certaines astuces sont incorporées dans le code ci-dessus:


 * Cette ligne importe FreeCAD dans l'interpréteur FreeCAD Python, cela peut sembler redondant, mais ce n'est pas le cas.
 * Placement Rotation et Vector sont largement utilisés dans l'écriture de scripts FreeCAD, les importer de cette manière vous évitera de les appeler avec ou  au lieu de  ou, cela économisera de nombreuses frappes et rendra les lignes de code beaucoup plus petites.

Commençons par un petit script qui fait un très petit travail, mais qui montre la puissance de cette approche.

Ecrivez les lignes de code ci-dessus après et appuyez sur la flèche verte dans la Barre d'outils des macros

Vous verrez des choses magiques, un nouveau document est ouvert nommé "Wiki_example" et vous verrez dans la vue 3D un Cube comme ci-dessous.





Quelque chose en plus
Pas si surprenant ? Oui, mais il faut commencer quelque part, on peut faire la même chose avec un Cylindre, ajouter ces lignes de code après la méthode et avant la ligne :.

Même ici, rien de trop excitant. Mais veuillez noter quelques particularités:


 * L'absence de la référence habituelle à l ', présente dans de nombreux extraits de code de documentation est délibérée. Ce code pourrait être utilisé même en invoquant FreeCAD comme module dans un interpréteur Python externe, la chose n'est pas facilement faisable avec une AppImage, mais avec un certain soin, cela pourrait être fait. De plus, dans la devise standard de Python, "mieux explicite qu'implicite", explique de manière très "mal" d'où viennent les choses.
 * Notez l'utilisation du nom "constant" attribué au document actif dans . activeDocument n'est pas une "constante" au sens strict, mais d'une manière "sémantique" c'est notre "Document actif", qui pour notre utilisation sera une "constante" appropriée. La convention Python d'utiliser le nom "ALL CAPS" pour "constantes", sans oublier que est beaucoup plus court que.
 * Chaque méthode retourne une géométrie, cela sera clair dans la suite de la page.
 * Géométrie n'avait pas la propriété, lors de l'utilisation de géométries simples pour créer une géométrie plus complexe, gérer est une chose délicate.

Maintenant, que faire avec ces géométries?

Introduisons les opérations booléennes. Comme exemple pour démmarrer, placez ces lignes après, cela crée une méthode pour une Fusion également connue sous le nom d'opération Union :

Rien d'exceptionnel ici aussi, notez cependant l'uniformité dans le codage des méthodes; Cette approche est plus linéaire que celles vues autour d'autres tutoriels sur les scripts, cette "linéarité" aide grandement à la lisibilité et aussi avec les opérations couper-copier-coller.

Utilisons les géométries, supprimons les lignes sous la section de code commençant par et insérons les lignes suivantes:

Lancez le script avec la flèche verte et nous verrons dans la vue 3D quelque chose comme :



Placement
Le concept de placement est relativement complexe, voir tutoriel avion pour une explication plus approfondie.

Nous avons généralement besoin de placer des géométries respectueuses les unes des autres, lorsque la construction d'un objet complexe est une tâche récurrente, le moyen le plus courant est d'utiliser la propriété geometry.

FreeCAD offre un large choix de moyens pour définir cette propriété, l'un est plus adapté à l'autre en fonction des connaissances et du parcours de l'utilisateur, mais plus l'écriture est simple et expliquée dans le Tutoriel cité, plus il utilise une définition particulière de la partie de, assez facile à apprendre.

Mais par rapport à d'autres considérations, une chose est cruciale, la géométrie point de référence, c'est-à-dire le point à partir duquel l'objet est modélisé par FreeCAD, comme décrit dans ce tableau, copié de Placement :

Cette information doit être gardée à l'esprit, en particulier lorsque nous devons appliquer une rotation.

Quelques exemples peuvent aider, supprimez toute la ligne après la méthode et insérez la partie de code ci-dessous :

Expliquons quelque chose dans le code:


 * Nous avons utilisé une méthode pour définir une sphère, en utilisant la définition la plus simple, en utilisant uniquement le rayon.
 * Nous avons introduit une deuxième écriture pour Union ou Fusion, en utilisant plusieurs objets, pas trés éloignés de l'habituel Part::Fuse qu'il utilise Part:Multifuse et n'utilise qu'une seule propriété . Nous avons passé un tuple comme arguments mais il accepte aussi une liste.
 * Nous avons défini un objet complexe un avion mais nous l'avons fait de manière "paramétrique" en définissant certains paramètres et en dérivant d'autres paramètres, grâce à des calculs, basé sur les principaux paramètres.
 * Nous avons utilisé des propriétés de placement dans la méthode et avant de renvoyer les géométries finales, nous avons utilisé une propriété  avec l'écriture Yaw-Pitch-Roll. Notez le dernier  qui définit un centre de rotation de toute la géométrie.

On peut facilement remarquer que la géométrie de l'avion tourne autour de son "barycentre" ou "centre de gravité", que j'ai fixé au centre de l'aile, un endroit relativement "naturel", mais qui pourrait être placé n'importe où vous voulez.

Le premier est le vecteur de translation, non utilisé ici, mais si vous remplacez  par ces lignes :

Vous verrez dans la fenêtre Rapport ce texte:

Que s'est-il passé?

FreeCAD a traduit en d'autres termes notre définition  qui spécifie trois composants, Translation, Rotation et centre de rotation en valeurs "internes" de seulement deux composants, Translation et Rotation.

vous pouvez facilement visualiser la valeur de en utilisant une instruction print dans la méthode  et voir que c'est :

en d'autres termes, le centre de rotation de la géométrie est à, mais ce centre de rotation n'est pas affiché dans l'interface graphique, il pourrait être entré comme , il n'a pas pu être facilement récupéré.

C'est le sens du mot "maladroit" que j'ai utilisé pour définir la propriété.

Voici l'exemple de code complet avec un docstring de script décent selon la convention de docstrings de Google :