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: Enregistrement, Arrêt de l'enregistrement, Édition de la macro et Exécuter la macro.

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 Stop et toutes les actions que vous avez effectuées sont enregistrée. Pour exécuter la macro, cliquer sur le bouton d'édition et la boîte de dialogue Lancer la macro s'affiche.



Ici vous pouvez 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'Enregistrement, 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 "Stop" 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 "Exécuter la macro dans l'éditeur". 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



Comment créer une barre d'outils 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.

Creating macros without recording
Macro Install HowTo You can also directly copy/paste python code into a macro, without recording GUI action. Simply create a new macro, edit it, and paste your code. You can then save your macro the same way as you save a FreeCAD document. Next time you start FreeCAD, the macro will appear under the "Installed Macros" item of the Macro menu.

Référence sur les Macros
Visitez la page Recettes Macros pour charger des macros et les ajouter à votre installation FreeCad. L'emplacement des macros est visible en cliquant sur l'icône de l'éditeur de macros et, en bas de la boîte de dialogue Destination de la macro.