Macros/fr

= Macro =

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.

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'enregistrement, donnez un nom à la macro par exemple "cylinder 10x10" puis dans Part Workbench, 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 raccourci 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 (anglais)

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.

Référence sur les Macros
Visitez la page Macros recipes 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"