Macros recipes/fr

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.
 * Macro screw_maker1_2: Cette macro crée une vis, un boulon . . . dans les normes ISO. Sélectionnez le type de vis, le diamètre nominal et la longueur (d'autres options seront disponibles)
 * [[Image:Macro_BOLTS.png|16px]] Macro BOLTS: Bibliothèque libre et open-source pour la construction de boulons et visses au format standard pour les applications de CAD.
 * Macro_Ellipse-Center+2Points Crée un éllipse en sélectionnant 3 points (dans cet ordre): centre, grand rayon et petit rayon.

Object transformation

 * Macro ArrayCopy: copies the selected object several times, on an array grid
 * Macro FlattenWire: flattens draft wires that are not plane to their median Z coordinate
 * Macro MeshToPart: converts selected meshes to parts
 * Macro JointWire: allows to find and joint all non connected edge to the closest non connected one using a line
 * Macro Remove parametric history: removes all parametric associativity from an object, leaving it as a "dumb" shape
 * Macro SuperWire: Forces the creation of a Wire from lines and arcs that don't necessarily touch each other. Use this if normal wire operation fails
 * Macro HealArcs: Sometimes arcs are transformed into BSplines, for example when scale operations have been applied to them. This macro recreates valid arcs from them. Useful before exporting to dxf
 * Macro FaceToSketch: Converts the selected Face to a single Sketch without constraints.
 * Macro EdgesToArc: Converts the selected Edges to a circular Arc if possible. Useful for restoring discretized arcs.

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.
 * Macro Cartouche : Cette macro GUI permet de remplir simplement tous les champs du cartouche de la feuille mise en plan de FreeCAD, le format de la date et le symbole du mode de projection s'adaptent à la région EU ou US sélectionnée.
 * Macro unrollRuledSurface: permet de dérouler les surfaces et de les dessiner sur une page.
 * Macro unfoldBox: permet de se dérouler les faces d'un objet de n'importe quelle forme et de les dessiner sur une page.

Utilitaires

 * Macro MessageBox : Montre comment donner des informations à l'utilisateur dans les macros
 * [[Image:FCInfo.png|16px]] Macro_FCInfo : Donne une série de renseignements sur la forme sélectionnée et peut afficher une conversion de la longueur, de l'inclinaison de la forme (degrés, radian, grade), de la surface, du volume et du poids de la forme dans la densité sélectionnée dans différentes unités de grandeur internationales et anglo-saxonne.
 * Macro 3d Printer Slicer: Exporte votre conception vers un logiciel d'analyse par tranche (slicer) pour utilisation sur une imprimante 3D ou vers un logiciel CAM.
 * Macro Delta xyz : Donne la valeur Delta xyz et la distance entre 2 points

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 dans la catégorie "Macros".

Ajouter de nouvelles macros à ce répertoire

 * 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" "Macro My Excellent Macro: My excellent macro" . Cliquez sur le nouveau lien (s'affiche en rouge) et Une nouvelle page sera créée


 * Dans cette page, collez le texte suivant :

Ici pour les pages anglophones.

(Exemple avec l'icône par défaut) (Exemple avec un icône personnalisé) Ici pour les autres pays ("/fr" "/de" "/it" ...).

(Exemple avec l'icône par défaut) (Exemple avec un icône personnalisé)
 * 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.


 * Paste your macro, and use the preformated text wiki tags to avoid adding spaces into your script. This will display the macro in a monospace font inside a light grey box like the example above.
 * If you like, upload a .png icon with the exact same name as your macro page (ex. Macro_My_Excellent_Macro.png)
 * Optionally you can add some more info on how to use your macro, tips, limitations and workaround.
 * Add it to the above categories, create a new category if needed.