Macros/fr: Difference between revisions

From FreeCAD Documentation
No edit summary
No edit summary
 
(52 intermediate revisions by 4 users not shown)
Line 1: Line 1:
<languages/>
<languages/>

{{Docnav/fr
{{Docnav/fr
|[[Standard Menu/fr|Menu Standard]]
|[[Scripting_and_macros/fr|Scripts et macros]]
|[[Scripts/fr|Scripts]]
|[[Introduction to Python/fr|Introduction à Python]]
}}
}}

{{TOCright}}
{{TOCright}}


Line 10: Line 12:
Les '''Macros''' sont un moyen pratique de reproduire des actions complexes dans FreeCAD. Vous enregistrez simplement les actions au fur et à mesure que vous les effectuez, puis vous les enregistrez sous un nom et les relancez quand vous le souhaitez. Étant donné que les macros sont en réalité une liste de commandes [[Python/fr|Python]], vous pouvez également les modifier et créer des scripts très complexes.
Les '''Macros''' sont un moyen pratique de reproduire des actions complexes dans FreeCAD. Vous enregistrez simplement les actions au fur et à mesure que vous les effectuez, puis vous les enregistrez sous un nom et les relancez quand vous le souhaitez. Étant donné que les macros sont en réalité une liste de commandes [[Python/fr|Python]], vous pouvez également les modifier et créer des scripts très complexes.


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


Voyez le [[Power_users_hub|Power users hub]] pour en savoir plus sur le langage de programmation [[Python/fr|Python]] et sur l'écriture de macros. En particulier, vous devriez commencer par ces pages :
Voyez la [[Power_users_hub/fr|Documentation pour utilisateurs expérimentés]] pour en savoir plus sur le langage de programmation [[Python/fr|Python]] et sur l'écriture de macros. En particulier, vous devriez commencer par ces pages :
* [[Introduction_to_Python/fr|Introduction à Python]]
* [[Introduction_to_Python/fr|Introduction à Python]]
* [[Python_scripting_tutorial/fr|Tutoriel de script Python]]
* [[Python_scripting_tutorial/fr|Tutoriel de script Python]]
* [[FreeCAD_Scripting_Basics/fr|FreeCAD : Débuter avec les scripts]]
* [[FreeCAD_Scripting_Basics/fr|FreeCAD : Débuter avec les scripts]]


<span id="How_it_works"></span>
===Fonctionnement===
==Fonctionnement==


Activez la sortie de la console dans le menu {{MenuCommand|EditPreferencesGeneral → Macro → Montrer les commandes du script dans la console python}}. Vous verrez que dans FreeCAD, chaque action que vous effectuez, comme appuyer sur un bouton, génère une commande Python. Ces commandes sont ce qui peut être enregistré dans une macro. L'outil principal pour créer des macros est la barre d'outils des macros : [[Image:Macros_toolbar.jpg]]. Vous y avez 4 boutons : Enregistrer, arrêter l'enregistrement, éditer et lire la macro actuelle.
Activez la sortie de la console dans le menu {{MenuCommand|EditionPréférencesPython → Macro → Montrer les commandes du script dans la console Python}}. Vous verrez que dans FreeCAD, chaque action que vous effectuez, comme appuyer sur un bouton, génère une commande Python. Ces commandes sont ce qui peut être enregistré dans une macro. L'outil principal pour créer des macros est la barre d'outils des macros : [[Image:Macros_toolbar.jpg]]. Vous y avez 4 boutons : Enregistrer, Arrêter l'enregistrement, Editer et Lire la macro en cours.


C'est très simple à utiliser : appuyez sur le bouton d'enregistrement, il vous sera demandé de donner un nom à votre macro, puis effectuez quelques actions. Lorsque vous avez terminé, cliquez sur le bouton Arrêter l'enregistrement et vos actions seront enregistrées. Vous pouvez maintenant accéder à la boîte de dialogue de macro avec le bouton d'édition.
C'est très simple à utiliser : appuyez sur le bouton d'enregistrement, il vous sera demandé de donner un nom à votre macro, puis effectuez quelques actions. Lorsque vous avez terminé, cliquez sur le bouton Arrêter l'enregistrement et vos actions seront enregistrées. Vous pouvez maintenant accéder à la boîte de dialogue de macro avec le bouton d'édition.
Line 26: Line 29:
{{Caption|Interface listant les macros disponibles dans le système}}
{{Caption|Interface listant les macros disponibles dans le système}}


Vous pouvez y gérer vos macros, les supprimer, les modifier, les dupliquer, les installer ou en créer de nouvelles à partir de zéro. Si vous modifiez une macro, elle sera ouverte dans une fenêtre d'éditeur où vous pourrez apporter des modifications à son code. De nouvelles macros peuvent être installées en utilisant le bouton {{button|Addons...}}, qui relie au [[AddonManager/fr|Gestionnaire d'Addon]].
Vous pouvez y gérer vos macros, les supprimer, les modifier, les dupliquer, les installer ou en créer de nouvelles à partir de zéro. Si vous modifiez une macro, elle sera ouverte dans une fenêtre d'éditeur où vous pourrez apporter des modifications à son code. De nouvelles macros peuvent être installées en utilisant le bouton {{button|Extensions...}}, qui relie le [[Std_AddonMgr/fr|Gestionnaire des extensions]].


<span id="Example"></span>
===Exemple===
== Exemple ==


Appuyez sur le bouton d'enregistrement, donnez un nom, disons "cylindre 10x10", puis dans [[Part Workbench/fr|Part Atelier (atelier pièces)]], créez un cylindre de rayon=10 et de hauteur=10. Ensuite, appuyez sur le bouton "arrêter l'enregistrement". Dans la boîte de dialogue d'édition des macros, vous pouvez voir le code python qui a été enregistré et si vous le souhaitez, y apporter des modifications. Pour exécuter votre macro, appuyez simplement sur le bouton Exécuter de la barre d'outils pendant que votre macro est dans l'éditeur. Votre macro est toujours enregistrée sur le disque, donc toute modification que vous apportez, ou toute nouvelle macro que vous créez, sera toujours disponible au prochain démarrage de FreeCAD.
Appuyez sur le bouton d'enregistrement, donnez un nom, disons "cylindre 10x10", puis dans l'[[Part_Workbench/fr|Atelier Part]], créez un cylindre de rayon=10 et de hauteur=10. Ensuite, appuyez sur le bouton "arrêter l'enregistrement". Dans la boîte de dialogue d'édition des macros, vous pouvez voir le code python qui a été enregistré et si vous le souhaitez, y apporter des modifications. Pour exécuter votre macro, appuyez simplement sur le bouton Exécuter de la barre d'outils pendant que votre macro est dans l'éditeur. Votre macro est toujours enregistrée sur le disque, donc toute modification que vous apportez, ou toute nouvelle macro que vous créez, sera toujours disponible au prochain démarrage de FreeCAD.


<span id="Customizing"></span>
===Personnalisation===
==Personnalisation==


Bien sûr il n'est pas pratique de charger une macro dans l'éditeur pour l'utiliser. FreeCAD fournit de bien meilleures façons d'utiliser votre macro, comme lui attribuer un raccourci clavier ou mettre une entrée dans le menu. Une fois votre macro créée, tout cela peut être fait via le menu {{MenuCommand|Outils → Personnaliser}}.
Bien sûr il n'est pas pratique de charger une macro dans l'éditeur pour l'utiliser. FreeCAD fournit de bien meilleures façons d'utiliser votre macro, comme lui attribuer un raccourci clavier ou mettre une entrée dans le menu. Une fois votre macro créée, tout cela peut être fait via le menu {{MenuCommand|Outils → Personnaliser}}.
Line 38: Line 43:
[[Image:Macros config.jpg]]
[[Image:Macros config.jpg]]


De cette façon vous pouvez faire de votre macro un véritable outil, comme n'importe quel outil FreeCAD standard. Ceci, combiné à la puissance des scripts python dans FreeCAD, permet d'ajouter facilement vos propres outils à l'interface. Lisez la page [[Scripting/fr|Scripting]] si vous souhaitez en savoir plus sur les scripts [[Python/fr|Python]].
De cette façon vous pouvez faire de votre macro un véritable outil, comme n'importe quel outil FreeCAD standard. Ceci, combiné à la puissance des scripts python dans FreeCAD, permet d'ajouter facilement vos propres outils à l'interface.

Allez sur [[Customize_Toolbars/fr|Personnaliser la barre d'outils]] pour une description plus complète.


<span id="Creating_macros_without_recording"></span>
See [[Customize_Toolbars|Customize Toolbars]] for a more detailed description.
==Création de macros sans enregistrement==


Vous pouvez également copier / coller directement du code python dans une macro, sans enregistrer d'action au niveau de l'interface utilisateur (GUI). Créez simplement une nouvelle macro, modifiez-la et collez votre code. Vous pouvez ensuite enregistrer votre macro de la même manière que vous enregistrez un document FreeCAD. La prochaine fois que vous lancerez FreeCAD, la macro apparaîtra avec l'intitulé "Macros installées" du menu Macro.
<div class="mw-translate-fuzzy">
===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'''.
</div>


Allez sur [[How_to_install_macros/fr|Comment installer des macros]] pour une description plus détaillée.
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.


<span id="Macro_repositories"></span>
See [[How to install macros|How to install macros]] for a more detailed description.
==Les dépôts des macros==


Il existe deux emplacements principaux pour les macros. Le premier est le dépôts des macros officielles évalués par des pairs sur [https://github.com/FreeCAD/FreeCAD-macros GitHub]. La deuxième est la page [[Macros_recipes/fr|Liste des macros]] à partir de laquelle vous pouvez choisir des macros utiles à ajouter à votre installation FreeCAD. Les macros des deux dépôts peuvent être installées via le [[Std_AddonMgr/fr|Gestionnaire des extensions]] directement depuis FreeCAD.
<div class="mw-translate-fuzzy">
===Les dépôts de Macros===
Visitez la page [[Macros recipes/fr|Macros]] pour charger des macros et les ajouter à votre installation FreeCad.
</div>


<span id="Additional_information"></span>
Visit the [[Macros recipes|Macros recipes]] page to pick some useful macros to add to your FreeCAD installation.
== Informations supplémentaires ==


* [[Macro_at_Startup/fr|Exécuter une macro au démarrage]]
<div class="mw-translate-fuzzy">
* [[Installing_more_workbenches/fr|Installer des ateliers supplémentaires]]
===Liens===
[[Installing_more_workbenches/fr|Installer des ateliers supplémentaires]]
</div>


<span id="Tutorials"></span>
* [[Macro_at_Startup|Automatically run macro at startup]]
== Tutoriels ==
* [[Installing_more_workbenches|Installing more workbenches]]


Vous pouvez installer manuellement des extensions, cependant, il est beaucoup plus facile d'utiliser simplement le [[Std_AddonMgr/fr|Gestionnaire des extensions]].
<div class="mw-translate-fuzzy">
* [[How_to_install_macros/fr|Comment installer des macros]]
===Tutoriels===
[[How_to_install_additional_workbenches/fr|Comment installer plus d'ateliers]]
* [[How_to_install_additional_workbenches/fr|Comment installer des ateliers supplémentaires]]
</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
|[[Standard Menu/fr|Menu Standard]]
|[[Scripting_and_macros/fr|Scripts et macros]]
|[[Scripts/fr|Scripts]]
|[[Introduction to Python/fr|Introduction à Python]]
}}
}}


{{Userdocnavi{{#translation:}}}}
{{Powerdocnavi{{#translation:}}}}
{{Powerdocnavi{{#translation:}}}}
[[Category:Formats{{#translation:}}]]
[[Category:Developer Documentation{{#translation:}}]]
[[Category:Python Code{{#translation:}}]]
{{clear}}
[[Category:Macros{{#translation:}}]]

Latest revision as of 11:59, 9 August 2023

Introduction

Les Macros sont un moyen pratique de reproduire des actions complexes dans FreeCAD. Vous enregistrez simplement les actions au fur et à mesure que vous les effectuez, puis vous les enregistrez sous un nom et les relancez quand vous le souhaitez. Étant donné que les macros sont en réalité une liste de commandes Python, vous pouvez également les modifier et créer des scripts très complexes.

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

Voyez la Documentation pour utilisateurs expérimentés pour en savoir plus sur le langage de programmation Python et sur l'écriture de macros. En particulier, vous devriez commencer par ces pages :

Fonctionnement

Activez la sortie de la console dans le menu Edition → Préférences → Python → Macro → Montrer les commandes du script dans la console Python. Vous verrez que dans FreeCAD, chaque action que vous effectuez, comme appuyer sur un bouton, génère une commande Python. Ces commandes sont ce qui peut être enregistré dans une macro. L'outil principal pour créer des macros est la barre d'outils des macros : . Vous y avez 4 boutons : Enregistrer, Arrêter l'enregistrement, Editer et Lire la macro en cours.

C'est très simple à utiliser : appuyez sur le bouton d'enregistrement, il vous sera demandé de donner un nom à votre macro, puis effectuez quelques actions. Lorsque vous avez terminé, cliquez sur le bouton Arrêter l'enregistrement et vos actions seront enregistrées. Vous pouvez maintenant accéder à la boîte de dialogue de macro avec le bouton d'édition.

Interface listant les macros disponibles dans le système

Vous pouvez y gérer vos macros, les supprimer, les modifier, les dupliquer, les installer ou en créer de nouvelles à partir de zéro. Si vous modifiez une macro, elle sera ouverte dans une fenêtre d'éditeur où vous pourrez apporter des modifications à son code. De nouvelles macros peuvent être installées en utilisant le bouton Extensions..., qui relie le Gestionnaire des extensions.

Exemple

Appuyez sur le bouton d'enregistrement, donnez un nom, disons "cylindre 10x10", puis dans l'Atelier Part, créez un cylindre de rayon=10 et de hauteur=10. Ensuite, appuyez sur le bouton "arrêter l'enregistrement". Dans la boîte de dialogue d'édition des macros, vous pouvez voir le code python qui a été enregistré et si vous le souhaitez, y apporter des modifications. Pour exécuter votre macro, appuyez simplement sur le bouton Exécuter de la barre d'outils pendant que votre macro est dans l'éditeur. Votre macro est toujours enregistrée sur le disque, donc toute modification que vous apportez, ou toute nouvelle macro que vous créez, sera toujours disponible au prochain démarrage de FreeCAD.

Personnalisation

Bien sûr il n'est pas pratique de charger une macro dans l'éditeur pour l'utiliser. FreeCAD fournit de bien meilleures façons d'utiliser votre macro, comme lui attribuer un raccourci clavier ou mettre une entrée dans le menu. Une fois votre macro créée, tout cela peut être fait via le menu Outils → Personnaliser.

De cette façon vous pouvez faire de votre macro un véritable outil, comme n'importe quel outil FreeCAD standard. Ceci, combiné à la puissance des scripts python dans FreeCAD, permet d'ajouter facilement vos propres outils à l'interface.

Allez sur Personnaliser la barre d'outils pour une description plus complète.

Création de macros sans enregistrement

Vous pouvez également copier / coller directement du code python dans une macro, sans enregistrer d'action au niveau de l'interface utilisateur (GUI). Créez simplement une nouvelle macro, modifiez-la et collez votre code. Vous pouvez ensuite enregistrer votre macro de la même manière que vous enregistrez un document FreeCAD. La prochaine fois que vous lancerez FreeCAD, la macro apparaîtra avec l'intitulé "Macros installées" du menu Macro.

Allez sur Comment installer des macros pour une description plus détaillée.

Les dépôts des macros

Il existe deux emplacements principaux pour les macros. Le premier est le dépôts des macros officielles évalués par des pairs sur GitHub. La deuxième est la page Liste des macros à partir de laquelle vous pouvez choisir des macros utiles à ajouter à votre installation FreeCAD. Les macros des deux dépôts peuvent être installées via le Gestionnaire des extensions directement depuis FreeCAD.

Informations supplémentaires

Tutoriels

Vous pouvez installer manuellement des extensions, cependant, il est beaucoup plus facile d'utiliser simplement le Gestionnaire des extensions.