Difference between revisions of "Macros/fr"

From FreeCAD Documentation
Jump to navigation Jump to search
m
(Updating to match new version of source page)
 
(44 intermediate revisions by 5 users not shown)
Line 1: Line 1:
 
<languages/>
 
<languages/>
{{docnav/fr
+
 
|[[Standard Menu/fr|Menu Standard]]
+
{{Docnav/fr
 +
|
 
|[[Introduction to Python/fr|Introduction à Python]]
 
|[[Introduction to Python/fr|Introduction à Python]]
 
}}
 
}}
 +
 +
{{TOCright}}
  
 
== Introduction ==
 
== Introduction ==
  
<div class="mw-translate-fuzzy">
+
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.
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/fr|Python]] que vous pouvez également modifier pour 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]].
</div>
 
  
<div class="mw-translate-fuzzy">
+
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 :
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]].
+
* [[Introduction_to_Python/fr|Introduction à Python]]
</div>
+
* [[Python_scripting_tutorial/fr|Tutoriel de script Python]]
 
+
* [[FreeCAD_Scripting_Basics/fr|FreeCAD : Débuter avec les scripts]]
<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.
 
</div>
 
  
 
===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.
 
  
Toutes ces commandes peuvent être enregistrées dans une macro.
+
Activez la sortie de la console dans le menu {{MenuCommand|Edit → Preferences → General → 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.
  
Ces commandes, qui servent à faire les macros, se trouvent sur la barre d'outils des macros : [[Image:Macros_toolbar.jpg]].<br />
+
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.
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.
 
  
 
[[Image:Macros.png]]
 
[[Image:Macros.png]]
 
{{Caption|Interface listant les macros disponibles dans le système}}
 
{{Caption|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 {{button|Addons ...}} qui renvoie au [[AddonManager/fr| Gestionnaire d'extensions]].
+
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]].
  
<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.
+
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.
</div>
 
  
 
===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 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}}.
  
 
[[Image:Macros config.jpg]]
 
[[Image:Macros config.jpg]]
  
<div class="mw-translate-fuzzy">
+
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]].
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>
+
Allez sur [[Customize_Toolbars/fr|Personnaliser la barre d'outils]] pour une description plus complète.
  
<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'''.
 
</div>
 
  
<div class="mw-translate-fuzzy">
+
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 [[How to install macros/fr|Comment installer des Macros]] pour une description plus détaillée.
 +
 
 
===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.
 
</div>
 
  
===Liens===
+
Visitez la page [[Macros recipes/fr|Recettes de macros]] pour choisir des macros utiles à ajouter à votre installation FreeCAD.
[[Installing_more_workbenches/fr|Installer des ateliers supplémentaires]]
+
 
 +
== Informations supplémentaires ==
 +
 
 +
* [[Macro_at_Startup/fr|Exécuter une macro au démarrage]]
 +
* [[Installing_more_workbenches/fr|Installer des ateliers supplémentaires]]
  
[[Macro_at_Startup|Automatically run macro at startup]].
+
== Tutoriels ==
  
===Tutoriels===
+
Vous pouvez installer manuellement des extensions, cependant, il est beaucoup plus facile d'utiliser simplement l'[[Std_AddonMgr/fr|Addon Manager]].
[[How_to_install_additional_workbenches/fr|Comment installer plus d'ateliers]]
+
* [[How to install macros/fr|Comment installer des Macros]]
 +
* [[How_to_install_additional_workbenches/fr|Comment installer des ateliers supplémentaires]]
  
{{docnav/fr
+
{{Docnav/fr
|[[Standard Menu/fr|Menu Standard]]
+
|
 
|[[Introduction to Python/fr|Introduction à Python]]
 
|[[Introduction to Python/fr|Introduction à Python]]
 
}}
 
}}
  
{{Userdocnavi}}
+
{{Powerdocnavi{{#translation:}}}}
 
+
[[Category:Developer Documentation{{#translation:}}]]
[[Category:Poweruser Documentation/fr]]
+
[[Category:Python Code{{#translation:}}]]
 
+
[[Category:Macros{{#translation:}}]]
 
{{clear}}
 
{{clear}}

Latest revision as of 20:44, 22 August 2020

Other languages:
Bahasa Indonesia • ‎Deutsch • ‎English • ‎Türkçe • ‎español • ‎français • ‎italiano • ‎polski • ‎português • ‎português do Brasil • ‎română • ‎svenska • ‎čeština • ‎български • ‎русский • ‎中文(中国大陆)‎ • ‎日本語
FreeCAD.png
Page suivante : Introduction à Python Arrow-right.svg

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 le Power users hub 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 Edit → Preferences → General → 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 : Macros toolbar.jpg. Vous y avez 4 boutons : Enregistrer, arrêter l'enregistrement, éditer et lire la macro actuelle.

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.

Macros.png

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 Addons..., qui relie au Gestionnaire d'Addon.

Exemple

Appuyez sur le bouton d'enregistrement, donnez un nom, disons "cylindre 10x10", puis dans 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.

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.

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 si vous souhaitez en savoir plus sur les scripts Python.

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 de Macros

Visitez la page Recettes de macros pour choisir des macros utiles à ajouter à votre installation FreeCAD.

Informations supplémentaires

Tutoriels

Vous pouvez installer manuellement des extensions, cependant, il est beaucoup plus facile d'utiliser simplement l'Addon Manager.

FreeCAD.png
Page suivante : Introduction à Python Arrow-right.svg