Macros recipes/fr

=Recettes Macro=

Cette page répertorie des macros qui ajoutent des fonctionnalités à votre installation de FreeCAD.

Création d'objets

 * [[Image:Macro_makeCube.png|16px]] Macro_makeCube : créé un cube à partir de 4 points
 * Macro draw2DFunction: trace une fonction décrite par une équation z=F(x)
 * Macro Balayage solide: créé un solide en balayant un profil le long d'une trajectoire. Les éléments 2D peuvent être créés à l'aide des outils de l'interface graphique de FreeCAD.
 * [[Image:Macro_Draft_Circle_3_Points.png|16px]] Macro_Make_Circle_3_Points: crée un cercle sur 3 points sélectionnés, les points peuvent être des objets (cet exemple réunit les deux exemples ci dessous, tous les paramètres se règlent simplement dans une fenêtre graphique).
 * [[Image:Macro_Draft_Circle_3_Points.png|16px]] Macro_Draft_Circle_3_Points: crée un cercle orthogonal sur 3 points sélectionnés, les points peuvent être des objets.
 * [[Image:Macro_Draft_Circle_3_Points.png|16px]] Macro_Draft_Circle_3_Points_3D: crée un cercle sur 3 points sélectionnés dans l’espace 3D, les points peuvent être des objets.

Transformation d'objets

 * Macro ArrayCopy: copie l'objet sélectionné plusieurs fois selon une matrice.
 * Macro FlattenWire: Cette macro aplatit les fils (Wire) du projet qui ne sont pas plan à la médiane de leurs coordonnées z.
 * Macro MeshToPart: Cette macro convertit certaines mailles en pièces.
 * Macro JointWire: Cette macro permet de trouver et de mettre en collaboration, à l'aide d'une ligne tous les bords non connectés, avec le plus proche non connecté.
 * Macro Remove parametric history: Cela supprimera toutes les associativités paramétriques d'un objet, le transformant en une "simple" forme.
 * Macro SuperWire: Cette macro crée un fil d'objets sélectionnés (lignes et arcs) même lorsque les méthodes de création du fil normal (par exemple avec l'outil de mise à niveau) échouent.
 * Macro HealArcs: Parfois les arcs sont transformés en BSplines, par exemple, lorsqu'une opération d'échelle leurs ont été appliquées. Cette macro recrée des arcs valides. Utile avant l'exportation vers un fichier .dxf.

Opération de vues 3D

 * Macro Rotate View : Cette macro fait pivoter l'affichage actuel de 90 ° vers la gauche. Ne fonctionne que si vous êtes en vue de dessus.
 * Macro View Rotation : Cette macro fournit une interface graphique, afin de permettre une rotation précise des objets dans la vue.
 * Macro Texture Objects : Cette macro permet de mettre temporairement une image qui servira de texture sur les objets sélectionnés.

Assistants

 * Macro mise en plan automatique : permet de générer une mise en plan avec 4 vues (face, dessus, iso et droite). Il requiert des modifications pour être parfaitement fonctionnel.
 * Macro Corner shapes wizard : Cette macro est une application complète, il ouvre une boîte de dialogue demandant les dimensions angulaires de votre pièce, puis crée l'objet dans le document, et, crée une page avec les vues, de dessus, de face et latérale de la pièce.

Utilitaires

 * Macro MessageBox : Montre comment donner des informations à l'utilisateur dans les macros

Utilisation
Les macros citées ci-dessus peuvent être facilement ajoutées à FreeCAD :
 * Copiez le code de macro Python de la page de macro correspondante
 * Collez-le dans un document texte vide (par exemple à l'aide de Notepad sous Windows, ou Gedit sous Ubuntu)
 * Sauvegardez le fichier avec une extension .FCMacro
 * Déplacez le fichier .FCMacro dans le répertoire utilisateur de FreeCAD (/home/votrepseudo/.FreeCAD sous les variantes Linux/UNIX, C:\Users\votrenom\Application Data\FreeCAD sous Windows)
 * Redémarrez FreeCAD
 * Ouvrez le Gestionnaire de macros, sélectionnez votre nouvelle macro et cliquez sur « Lancer ».

De plus, vous pouvez ajouter votre nouvelle macro à une barre d'outils personnalisée :
 * Dans FreeCAD, ouvrez Outils → Personnaliser...
 * Dans l'onglet Macros, ajoutez une nouvelle macro, et définissez si vous le désirez un icône et un raccourci-clavier
 * Dans l'onglet Barres d'outils, créez une nouvelle barre d'outils, puis ajoutez votre macro, en la copiant de la catégorie « Macros ».

Ajouter de nouvelles macros à ce répertoire
(Exemple avec l'icône par défaut) (Exemple avec un icône personnalisé)
 * Obtenez les droits en écriture sur le wiki
 * Créez une nouvelle page dont le nom commence par « Macro », par exemple « Macro_Ma_macro_excellente »
 * Dans cette page, collez le texte suivant :


 * Collez votre macro, en utilisant les balises de texte préformaté votre code ...  pour éviter d'ajouter des espaces à votre script. Ceci affichera la macro dans une police monospace, dans un encadré gris pâle, comme l'exemple ci-dessus.


 * Vous pouvez aussi téléverser un icône personnalisé de format .png ATTENTION, le nom de l'icône doit impérativement porter le même nom que le nom de la macro.
 * exemple : " Ma_macro_excellente " sans mettre d'extension (l'extension est donnée par le système), et, remplacez " Icon=Text-x-python " par " Icon=Ma_macro_excellente ")
 * Text-x-python [[Image:Text-x-python.png|32px]] est l'icône par défaut de la page dédiée à la Macro.


 * En option, vous pouvez ajouter davantage d'infos sur l'utilisation de votre macro, ses limitations, et, les solutions de contournement.
 * Ajoutez-la aux catégories ci-dessus, ou créez une nouvelle catégorie au besoin.