How to install macros/fr

Description
Cette page vous montrera comment installer et utiliser FreeCAD macro.

Since v0.17 it is easy to add macros by using the Addon Manager. A regular user doesn't need to do more than use this tool. Keep reading for more information regarding installation of macros.

Les macros sont des séquences de commandes utilisées pour effectuer une opération de dessin complexe. Les macros sont des scripts en Python, ce qui signifie qu'il s'agit de fichiers texte pouvant être écrits et modifiés à l'aide d'un éditeur de texte.

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

Voir Introduction à Python pour en savoir plus sur le langage de programmation Python, puis sur Tutoriel sur les scripts Python et sur principes de base des scripts FreeCAD pour lancer la création de scripts dans FreeCAD.

Ici une video sur l'installation installing FreeCAD macros in Ubuntu.

Barre d'outils

 * [[Image:Macro-record.svg|32px|record]] Lance l'enregistrement de la macro
 * [[Image:Macro-stop.svg|32px|stop]] Arrête l'enregistrement
 * [[Image:Std_DlgMacroExecuteDirect.svg|32px|open editor]] Ouvre le menu des macros
 * [[Image:Macro-execute.svg|32px|execute]] Exécute la macro

Menu
Outre les outils de la barre d'outils, les fonctions suivantes sont également disponibles dans le menu.
 * [[Image:Debug-start.svg|32px|start]] Debug Start
 * [[Image:Debug-stop.svg|32px|stop]] Debug Stop
 * Step over
 * Step into
 * Toggle breakpoint

Répertoires des macros
Les macros sont créées dans un dossier spécifique du répertoire FreeCAD de l'utilisateur. Ce répertoire peut être configuré dans la boîte de dialogue des macros, ou dans Editeur de préférences, via le menu. .

Les macros téléchargées doivent également être placées dans ce répertoire.

Répertoire par défaut
Les macros peuvent être simplement copiées dans

où est un des premiers répertoire recherché par FreeCAD au démarrage.

Le pourrait être un répertoire système, auquel cas la macro est installée pour tous les utilisateurs.
 * Sous Linux, il s’agit généralement de.
 * Sous Windows, il s’agit généralement de.
 * Sous Mac OSX, il s’agit généralement de.

Le pourrait être le répertoire d'un utilisateur particulier.
 * Sous Linux, il s’agit généralement de.
 * Sous Windows, il s’agit généralement de.
 * Sous Mac OSX, il s’agit généralement de.

Configuration du répertoire utilisateur
1. Ouvrez le menu pour ouvrir la Lancer la macro.



2. Définissez l'emplacement approprié.
 * Linux: généralement.
 * Windows: généralement.
 * MacOS: généralement.



3. Accédez à ce répertoire sur votre ordinateur.
 * Linux: collez l'adresse dans votre gestionnaire de fichiers, "Nautilus" ou autre. Vous devrez peut-être appuyer sur + pour rendre le répertoire masqué visible.
 * Windows: collez l'adresse dans votre "Explorateur de fichiers" et confirmez.
 * MacOS: localisez le dossier dans le "Finder" ou collez l'adresse dans un "Explorateur de fichiers"; rappelez-vous du préfixe dans l'explorateur de fichiers pour un fichier sur le disque.



4. Ajoutez des fichiers de macro à ce répertoire.
 * Linux: laissez le gestionnaire de fichiers ouvert et marquez l’emplacement pour un accès plus rapide.
 * Windows: laissez ouvert l'explorateur de fichiers.
 * MacOS: laissez une fenêtre du "Finder" ouverte ou enregistrez l'emplacement dans votre "Explorateur de fichiers", ou configurez un "Alias" pour le désigner, ou faites glisser le dossier dans la "Barre latérale" du "Finder" afin il est là pour utiliser d'autres programmes tels que des éditeurs de texte.



Méthode automatique
À partir de FreeCAD 0.17, utilisez le Addon Manager dans pour installer une macro incluse dans le répertoire FreeCAD-macros.

Dans les versions précédentes de FreeCAD, vous pouviez utiliser deux méthodes automatisées pour installer des macros et d’autres addons:
 * addons_installer.FCMacro: elle-même une macro, elle était le précurseur du gestionnaire d'addon et est hébergée dans le répertoire FreeCAD-addons. Vous n'avez pas besoin d'utiliser cet outil dans les nouvelles installations de FreeCAD.
 * freecad-pluginloader: également une macro, elle pourrait être utilisée pour installer de nouveaux composants dans FreeCAD. Ce n'est plus développé.

La méthode recommandée pour installer des addons, c'est-à-dire Ateliers externes et les macros, est le Addon Manager. Toutefois, vous pouvez toujours ajouter des macros à votre système avec les méthodes manuelles décrites dans les sections suivantes. Ceci est utile si vous développez et testez votre propre code.

Méthode manuelle 1. Copiez le code dans l'éditeur de macro
Pour les macros relativement petites, 300 lignes ou moins, le code peut être copié et collé directement dans l'éditeur de macros FreeCAD.

Nous utiliserons Macro Apothem Based Prism GUI par exemple.

1. Allez sur la page wiki macro qui devrait être présente dans la liste Macros.

S'il y a une icône personnalisée, téléchargez-la. Cliquez dessus avec le bouton droit de la souris et sélectionnez ; Placez l'icône dans le répertoire des macros. Cette icône peut être utilisée comme raccourci pour la macro dans une Barre d'outils personnalisée. L'icône par défaut est.



2. Dans la page macro, sélectionnez le code dans les sections ou  et copiez-le.

3. Dans FreeCAD, ouvrez le menu pour ouvrir la dialogue d'exécution de la macro.



4. Cliquer.



5. Entrez le nom de la macro, ici, puis appuyez sur.



6. La fenêtre d'édition de macros de FreeCAD est maintenant disponible et porte le nom de notre future macro.



7. Collez le code dans la fenêtre de l'éditeur puis cliquez sur la croix de l'onglet pour fermer la fenêtre.



8. Une fenêtre apparaît vous demandant de confirmer l'enregistrement du code. Cliquez sur. Vous pouvez également utiliser + pour enregistrer le fichier.

Redémarrez FreeCAD pour enregistrer correctement la nouvelle macro.



9. Ouvrez à nouveau le menu,, sélectionnez la nouvelle macro et appuyez sur.



10. La macro s'exécute. Remplissez les champs avec vos valeurs et cliquez sur le bouton.



11. Cette macro doit renvoyer une erreur si aucun document n'est actif. Les autres macros ouvrent un nouveau document s'il n'en existe pas.

Créez un nouveau document avec puis répétez les étapes précédentes pour exécuter la macro.



12. Lorsqu'un document actif est disponible, la macro s'exécute et crée un objet.



13. Vous pouvez ouvrir à nouveau la macro dans l'éditeur pour l'exécuter ou la modifier. Accédez à, sélectionnez la macro et appuyez sur.



14. La macro peut maintenant être exécutée avec, ou en cliquant sur le dans la barre d'outils.



Méthode manuelle 2. Ajouter un fichier de macro à partir d'un fichier .zip compressé
Certaines macros sont trop importantes pour être copier-coller dans l'éditeur de macros être hébergées sur le wiki. Dans ce cas, le code peut être hébergé ailleurs, dans un répertoir Github ou sur le Forum FreeCAD. Le code peut également être compressé dans un fichier, tarball ou dans un autre type d'archive s'il contient plusieurs fichiers. Si le code est distribué de cette manière, l'archive doit être extraite et les fichiers placés dans le répertoire macros.

Nous utiliserons Macro screw maker par exemple.

1. Téléchargez le code compressé à partir du forum,Screw Maker.

Vous devez utiliser un décompresseur pour obtenir les fichiers internes.
 * Pour Windows, vous pouvez utiliser une application telle que 7-zip ou L-Zarc ou [http: //www.quickzip.org/quickzip51.html quickzip].
 * Pour Linux, vous pouvez utiliser une commande du terminal

2. Téléchargez l'archive compressée avec le code de la macro dans un dossier local.



3. Décompressez votre fichier dans le dossier.



4. Le décompresseur crée un nouveau répertoire avec les fichiers décompressés.



5. Accédez au nouveau répertoire et copiez ou coupez le fichier macro.



6. Accédez au répertoire des macros et collez le fichier à cet endroit.



7. Dans FreeCAD, ouvrez le menu  pour ouvrir le dialogue d'exécution de la macro.



8. Sélectionnez la nouvelle macro et appuyez sur.



9. La macro s'exécute maintenant. Sélectionnez les options souhaitées et cliquez sur le bouton.





Exécuter une macro en ligne de commande
Ligne de commande pour exécuter une macro en (.FCMacro or .py)

sur Windows

sur Linux

Exemples de code erroné dû à des erreurs d'indentation
L'espace blanc au début des lignes (indentation) dans le langage de programmation Python est très important et fait partie intégrante du code. Un espace inapproprié peut empêcher le code de s'exécuter ou présenter des erreurs.

Cette section décrit certaines erreurs susceptibles d’être rencontrées lors des opérations de copier-coller et d’écriture de code macro.

Une erreur d’indentation typique ressemble à ceci:

Exemple 1
Si le code manque d'indentation, le code ne fonctionnera pas. Les définitions de classe et de fonction  ainsi que les structures de contrôle  doivent être suivies d'un bloc de code en retrait.

Cette erreur est possible si l'utilisateur ne copie pas le code correctement et si tous les espaces sont supprimés par inadvertance.



Problème d'indentation résolu.



Si le code est sélectionné, toutes les lignes doivent être mises en surbrillance jusqu'au bord gauche indiquant que les lignes sont alignées.



Exemple 2
Si un espace supplémentaire est introduit au début de toutes les lignes, l'interpréteur Python échouera et se plaindra de l'indentation inutile. Dans ce cas, toutes les lignes nécessitent la suppression de l'espace initial.



Exemple 3
Ici, le code a été copié depuis un fil de forum en utilisant le bouton. Apparemment, le choix est bon.



Cependant, lorsque la sélection est collée dans l'éditeur de macro, une indentation indésirable semble apparaître.



Dans ce cas, les espaces initiaux doivent être supprimés. Cela peut être fait avec un éditeur de texte spécialisé pour réduire rapidement l'indentation des lignes.

Sous Windows, ++ peut effectuer une sélection avec et le déplacement de la souris, puis utiliser.



Exemple 4
Ici, la sélection sélectionne également les numéros de ligne dans l'exemple de code. Si cette sélection est collée dans l'éditeur de macro, cela ne fonctionnera pas. Tous les numéros de ligne doivent être supprimés et les espaces ajustés de manière à ce que le code Python présente l'indentation appropriée.



Pour ceux qui ne voient aucune information s'afficher
Les macros peuvent générer des informations dans la vue du rapport afin de détailler l'action du code en cours d'exécution.

Si aucune information n'est affichée, assurez-vous que la vue du rapport et la console Python sont visibles et que la sortie est dirigée vers la vue du rapport.

Informations sur l'impression
Les macros FreeCAD ont deux méthodes pour imprimer des informations dans la vue du rapport.

Les fonctions FreeCAD

La simple fonction Python

Activer l'affichage du rapport
Pour voir les informations affichées dans la console, vous devez:

1. Accédez au menu.





2. Cochez et.



3. Les panneaux sont maintenant visibles et les commandes telles que affichent maintenant les informations qui apparaissent dans la.



Activer la commande print
FreeCAD devra peut-être être configuré pour que la fonction de Python redirige correctement sa sortie vers la vue du rapport.

1 : cliquez sur le menu Édition puis Préférences

1. Allez dans Editeur de Préférences avec le menu.



2. Accédez à la section, puis à.



3. Cochez les deux cases:


 * [[Image:Case_a_cocher_O.png|16px]] Rediriger es messages internes Python vers la vue rapport


 * [[Image:Case_a_cocher_O.png|16px]] Rediriger les erreurs internes de Python vers la vue rapport

et validez en cliquant sur le bouton.