Macros/fr: Difference between revisions

From FreeCAD Documentation
No edit summary
(Updating to match new version of source page)
Line 5: Line 5:
}}
}}
{{TOCright}}
{{TOCright}}

== Introduction ==
== Introduction ==


<div class="mw-translate-fuzzy">
Une '''macro''' est un moyen pratique et facile d'automatiser une série de commandes dans FreeCad.
Une '''macro''' est un moyen pratique et facile d'automatiser une série de commandes dans FreeCad.


Line 12: Line 14:


Ces macros sont en réalité une liste de commandes écrites en langage [[Python/fr|Python]] que vous pouvez également modifier pour créer des scripts très complexes.
Ces macros sont en réalité une liste de commandes écrites en langage [[Python/fr|Python]] que vous pouvez également modifier pour créer des scripts très complexes.
</div>


Alors que les scripts Python ont normalement pour extension {{incode|.py}}, les macros FreeCAD doivent avoir comme extension {{incode|.FCMacro}}. Une collection de macros écrites par des utilisateurs expérimentés se trouve dans la page [[macros recipes/fr|Macros]].
Alors que les scripts Python ont normalement pour extension {{incode|.py}}, les macros FreeCAD doivent avoir comme extension {{incode|.FCMacro}}. Une collection de macros écrites par des utilisateurs expérimentés se trouve dans la page [[macros recipes/fr|Macros]].


<div class="mw-translate-fuzzy">
Voir [[Introduction to Python/fr|Introduction au langage Python]] pour en savoir plus sur le langage de programmation Python, puis sur [[Python scripting tutorial/fr|Tutoriel sur les scripts Python]] et sur [[FreeCAD Scripting Basics/fr|Débuter avec les scripts]] pour en savoir plus sur l'écriture de macros.
Voir [[Introduction to Python/fr|Introduction au langage Python]] pour en savoir plus sur le langage de programmation Python, puis sur [[Python scripting tutorial/fr|Tutoriel sur les scripts Python]] et sur [[FreeCAD Scripting Basics/fr|Débuter avec les scripts]] pour en savoir plus sur l'écriture de macros.
</div>


<div class="mw-translate-fuzzy">
===Fonctionnement===
===Fonctionnement===
Dans le menu {{MenuCommand|É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.
Dans le menu {{MenuCommand|É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.
Line 24: Line 30:
Ces commandes, qui servent à faire les macros, se trouvent sur la barre d'outils des macros : [[Image:Macros_toolbar.jpg]].<br />
Ces commandes, qui servent à faire les macros, se trouvent sur la barre d'outils des macros : [[Image:Macros_toolbar.jpg]].<br />
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.
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.
</div>

Enable the console output in the menu {{MenuCommand|Edit → Preferences → General → Macro → Show scripts commands in python console}}. You will see that in FreeCAD, every action you do, such as pressing a button, outputs a Python command. Those commands are what can be recorded in a macro. The main tool for making macros is the macros toolbar: [[Image:Macros_toolbar.jpg]]. On it you have 4 buttons: Record, stop recording, edit and play the current 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.
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.
Line 32: Line 41:
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. De nouvelles macros peuvent être installées à l’aide du bouton {{button|Addons ...}} qui renvoie au [[AddonManager/fr| Gestionnaire d'extensions]].
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. De nouvelles macros peuvent être installées à l’aide du bouton {{button|Addons ...}} qui renvoie au [[AddonManager/fr| Gestionnaire d'extensions]].


<div class="mw-translate-fuzzy">
===Exemple===
===Exemple===


Cliquez sur le bouton d'Enregistrement, donnez un nom à la macro par exemple "cylinder 10x10" puis dans [[Part_Module/fr|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.
Cliquez sur le bouton d'Enregistrement, donnez un nom à la macro par exemple "cylinder 10x10" puis dans [[Part_Module/fr|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.
</div>


Press the record button, give a name, let's say "cylinder 10x10", then, in the [[Part Workbench|Part Workbench]], create a cylinder with radius = 10 and height = 10. Then, press the "stop recording" button. In the edit macros dialog, you can see the python code that has been recorded, and, if you want, make alterations to it. To execute your macro, simply press the execute button on the toolbar while your macro is in the editor. You macro is always saved to disk, so any change you make, or any new macro you create, will always be available next time you start FreeCAD.

<div class="mw-translate-fuzzy">
===Personnalisation===
===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 {{MenuCommand|Outils → personnaliser → Macros}}
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 {{MenuCommand|Outils → personnaliser → Macros}}
</div>

Of course it is not practical to load a macro in the editor in order to use it. FreeCAD provides much better ways to use your macro, such as assigning a keyboard shortcut to it or putting an entry in the menu. Once your macro is created, all this can be done via the {{MenuCommand|Tools → Customize}} menu.


[[Image:Macros config.jpg]]
[[Image:Macros config.jpg]]


<div class="mw-translate-fuzzy">
L'outil [[Customize_Toolbars/fr|Comment créer une barre d'outils]]. 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 déjà implantés dans FreeCad. Pour plus d'informations sur les scripts [[Python/fr|Python]] rendez vous sur la page [[Power_users_hub/fr|Documentation pour utilisateurs avancés]].
L'outil [[Customize_Toolbars/fr|Comment créer une barre d'outils]]. 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 déjà implantés dans FreeCad. Pour plus d'informations sur les scripts [[Python/fr|Python]] rendez vous sur la page [[Power_users_hub/fr|Documentation pour utilisateurs avancés]].
</div>


See [[Customize_Toolbars|Customize Toolbars]] for a more detailed description.

<div class="mw-translate-fuzzy">
===Création de macros sans enregistrement===
===Création de macros sans enregistrement===
[[How_to_install_macros/fr|Comment installer une macro]] 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'''.
[[How_to_install_macros/fr|Comment installer une macro]] 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'''.
</div>

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.

See [[How to install macros|How to install macros]] for a more detailed description.


<div class="mw-translate-fuzzy">
===Les dépôts de Macros===
===Les dépôts de Macros===
Visitez la page [[Macros recipes/fr|Macros]] pour charger des macros et les ajouter à votre installation FreeCad.
Visitez la page [[Macros recipes/fr|Macros]] pour charger des macros et les ajouter à votre installation FreeCad.
</div>


Visit the [[Macros recipes|Macros recipes]] page to pick some useful macros to add to your FreeCAD installation.

<div class="mw-translate-fuzzy">
===Liens===
===Liens===
[[Installing_more_workbenches/fr|Installer des ateliers supplémentaires]]
[[Installing_more_workbenches/fr|Installer des ateliers supplémentaires]]
</div>


[[Macro_at_Startup/fr|Exécuter une macro automatiquement au démarrage]].
* [[Macro_at_Startup|Automatically run macro at startup]]
* [[Installing_more_workbenches|Installing more workbenches]]


<div class="mw-translate-fuzzy">
===Tutoriels===
===Tutoriels===
[[How_to_install_additional_workbenches/fr|Comment installer plus d'ateliers]]
[[How_to_install_additional_workbenches/fr|Comment installer plus d'ateliers]]
</div>

You can manually install extensions, however, it is much simpler to just use the [[Std_AddonMgr|Addon Manager]].
* [[How to install macros|How to install macros]]
* [[How_to_install_additional_workbenches|How to install additional workbenches]]


{{Docnav/fr
{{Docnav/fr
Line 62: Line 102:
}}
}}


{{Userdocnavi}}
{{Userdocnavi{{#translation:}}}}
{{Powerdocnavi{{#translation:}}}}
[[Category:Formats{{#translation:}}]]
[[Category:Formats{{#translation:}}]]
[[Category:Poweruser Documentation{{#translation:}}]]
{{clear}}
{{clear}}

Revision as of 11:30, 23 May 2020

Introduction

Une macro est un moyen pratique et facile d'automatiser une série de commandes dans FreeCad.

Il suffit d'enregistrer une série de commandes que vous faites, puis de les sauvagarder sous 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 que vous pouvez également modifier pour créer des scripts très complexes.

Alors que les scripts Python ont normalement pour extension .py, les macros FreeCAD doivent avoir comme extension .FCMacro. Une collection de macros écrites par des utilisateurs expérimentés se trouve dans la page Macros.

Voir Introduction au langage Python pour en savoir plus sur le langage de programmation Python, puis sur Tutoriel sur les scripts Python et sur Débuter avec les scripts pour en savoir plus sur l'écriture de macros.

Fonctionnement

Dans le 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.

Ces 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.

Enable the console output in the menu Edit → Preferences → General → Macro → Show scripts commands in python console. You will see that in FreeCAD, every action you do, such as pressing a button, outputs a Python command. Those commands are what can be recorded in a macro. The main tool for making macros is the macros toolbar: . On it you have 4 buttons: Record, stop recording, edit and play the current 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.

Interface listant les macros disponibles dans le système

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. De nouvelles macros peuvent être installées à l’aide du bouton Addons ... qui renvoie au Gestionnaire d'extensions.

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.

Press the record button, give a name, let's say "cylinder 10x10", then, in the Part Workbench, create a cylinder with radius = 10 and height = 10. Then, press the "stop recording" button. In the edit macros dialog, you can see the python code that has been recorded, and, if you want, make alterations to it. To execute your macro, simply press the execute button on the toolbar while your macro is in the editor. You macro is always saved to disk, so any change you make, or any new macro you create, will always be available next time you start 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

Of course it is not practical to load a macro in the editor in order to use it. FreeCAD provides much better ways to use your macro, such as assigning a keyboard shortcut to it or putting an entry in the menu. Once your macro is created, all this can be done via the Tools → Customize menu.

L'outil Comment créer une barre d'outils. 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 déjà implantés dans FreeCad. Pour plus d'informations sur les scripts Python rendez vous sur la page Documentation pour utilisateurs avancés.

See Customize Toolbars for a more detailed description.

Création de macros sans enregistrement

Comment installer une macro 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.

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.

See How to install macros for a more detailed description.

Les dépôts de Macros

Visitez la page Macros pour charger des macros et les ajouter à votre installation FreeCad.

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

You can manually install extensions, however, it is much simpler to just use the Addon Manager.