Macros/fr

Une macro est un moyen pratique et facile de créer une série de commandes dans FreeCad.

Il suffit d'enregistrer la série de commandes que vous faites, puis de sauver cet enregistrement sur disque en lui donnant un nom. Une fois cet enregistrement (macro) sauvé, vous pourrez l'exécuter autant de fois que vous le voulez.

Ces macros sont en réalité une liste de commandes écrites en langage python, vous pouvez également les modifier, et créer des scripts très complexes.

Fonctionnement
Si vous cochez dans menu Édition → Préférences → Général → Macro → Montrer les commandes du script dans la console Python, vous verrez dans la fenêtre " Console Python " que chaque action que vous exécutez s'affiche, par exemple en appuyant sur " Afficher la vue de face ", il s'affiche dans la console  Gui.activeDocument.activeView.viewFront  qui est le code python correspondant.

Toutes ces commandes peuvent être enregistrées dans une macro.

Les commandes, qui servent à faire les macros, se trouvent sur la barre d'outils des macros :.

Sur la barre d'outils, il y a 4 boutons:, , , et,.

Il est extrêmement facile d'utiliser ces commandes : dès que vous appuyez sur le bouton d'enregistrement, il vous est demandé de donner un nom à la macro, éventuellement, donnez l'emplacement où placer le fichier. Une fois que la macro est terminée, cliquez sur le bouton, et, toutes les actions que vous avez effectuées sont enregistrée. Pour exécuter la macro, cliquer sur le bouton d' et la boîte de dialogue Lancer la macro s'affiche.



Vous pouvez ici gérer les macros enregistrées, lancer, créer, supprimer ou éditer une macro. L'édition ou la création d'une macro ouvre une nouvelle fenêtre dans FreeCad et vous pouvez ainsi créer ou modifier le code de la macro éditée.

Exemple
Cliquez sur le bouton d', donnez un nom à la macro par exemple "cylinder 10x10" puis dans l'atelier Part, créez un cylindre de rayon = 10 et hauteur = 10. Puis cliquer sur le bouton pour arrêter la macro. Dans la fenêtre d'édition de la macro vous pouvez voir le code en langage python qui a été enregistré et si vous le désirez, en modifier le code. Exécutez votre macro simplement en cliquant sur le bouton. La macro éditée ou la nouvelle macro est toujours sauvegardée lors de l'exécution, de manière à ne pas perdre les modifications apportées, les macros créées sont toujours accessibles à chaque nouvelle ouverture de FreeCad.

Personnalisation
Bien sûr, il n'est pas pratique de charger une macro dans l'éditeur en vue de l'exécuter. FreeCad fournit d'autres moyens pour exécuter votre macro, vous pouvez assigner un raccourci clavier à chaque macro ou créer un bouton de lancement sur la barre de menus. Une fois votre macro créée, ces raccourcis peuvent être crées par Outils → personnaliser → Macros



De cette manière vous pouvez faire de vos macros de véritables outils tout comme les outils disponibles dans FreeCad. Cette possibilité permet d'ajouter facilement vos propres outils dans l'interface de FreeCad et d'augmenter ainsi la bibliothèque de scripts python déjà implantés dans FreeCad. Pour plus d'informations sur les scripts python rendez vous sur la page Scripting.

Création de macros sans enregistrement
Il est aussi possible d’insérer le code python d'une macro avec copier/coller sans enregistrement d'actions dans l'interface graphique. Créer simplement le code python de la macro, éditez-le, copiez-le et collez votre code directement dans l'éditeur de macros de FreeCad. Puis vous pouvez la réutiliser comme bon vous semble et la retrouver dans le répertoire réservé aux macros, en passant par Macro → Macros ou l'éditeur de macros sur la barre de menus.

Macros repository
Visit the Macros recipes page to pick some useful macros to add to your FreeCAD installation.