Macros recipes/fr

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

Object creation

 * [[Image:Macro_makeCube.png|16px]] Macro makeCube : creates a cube from 4 points
 * Macro draw2DFunction: draws a function described by an equation z=F(x)
 * Macro drawParametric2Dfunction: Based on the above macro, but for parametric and optionally polar equations.
 * Macro Solid Sweep: creates a solid by sweeping a 2D profile along a trajectory previously selected in the 3D view. The 2D elements can be created through the regular tools in FreeCAD's GUI.
 * Macro Rectellipse: creates a parametric rectellipse
 * [[Image:Macro_Draft_Circle_3_Points.png|16px]] Macro Make Circle 3 Points: creates a circle on 3 selected points, the points can be objects (this example brings together the two examples below, all parameters simply settle on a graphic window).
 * [[Image:Macro_Draft_Circle_3_Points.png|16px]] Macro Draft Circle 3 Points: creates a circle from 3 selected points 2D orthogonal
 * [[Image:Macro_Draft_Circle_3_Points.png|16px]] Macro Draft Circle 3 Points 3D: creates a circle from 3 selected points in the space 3D
 * Macro screw maker1_2: This macro creates a screw with or without thread, according to ISO standards (screw_maker1_6.py.zip with Pyside support). (Screw Maker 1.7 - the best so far!)
 * [[Image:Macro_BOLTS.png|16px]] Macro BOLTS: The aim of BOLTS is to build a free and open-source standard parts library for CAD applications.
 * Macro Ellipse-Center+2Points Makes an ellipse by selecting three points (in this order): centre, major radius and minor radius
 * Macro Airfoil Import & Scale : Imports and scales a .dat airfoil to desired chord length.
 * Macro 3D Parametric Curve: Draw a function described by parametric equations x(t), y(t) and z(t).
 * Macro Line Length: Create a line giving coordinate XYZ length and angle to plane X Y
 * Macro FCTexture: Create a project from a bmp image to create a texture easily
 * [[Image:FreeCAD Doc.png|16px]] Macro PartsLibrary: Starts the Parts library browser
 * Macro BoundingBox Tracing : This macro red trace (editable) around the BoundingBox with 6 rectangles
 * Involute gear: allows you to create gear. See InvoluteGearFeature.py in FreeCAD_sf_master.

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.
 * Macro FaceToSketch: Convertit la Face sélectionnée en un sketch sans contraintes.
 * Macro EdgesToArc: Converti la sélection Edges en Arc circulaire si l'opération est possible. Utile pour la restauration des arcs discretized.
 * Macro_CloneConvert: Crée un clone de ou des objets sélectionné(s) et le converti dans la grandeur et position sélectionnée (inch, mm, m, µm...).

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.
 * Macro Mouse Cross : Cette macro change la forme de la souris en une croix de précision.
 * Macro Align View to Face Cette macro aligne la vue courante sur la face sélectionnée.

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 CartoucheFC Full: Cette macro GUI permet de remplir simplement tous les champs du cartouche de la feuille modèle 1 de FreeCAD (texteditable), le format de la date et le symbole de la mode de projection s'adaptent à la région de l'UE ou US sélectionnée.
 * Macro CartoucheFC 2: Cette macro GUI permet de remplir simplement tous les champs du cartouche de la feuille modèle 2 (texteditable) de FreeCAD
 * 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.

Utility

 * Macro MessageBox: shows how to give information to the user through the GUI.
 * [[Image:FCInfo.png|16px]] Macro_FCInfo : Gives a series of information about the selected shape and can display a conversion of length, inclination (degrees, radian, grade) shape, surface, volume and the weight of the form in the density selected in various international and Anglo-Saxon units
 * [[Image:FCInfo.png|16px]] Macro FCInfo Alternate Linux : same as above, but for Linux
 * Macro 3d Printer Slicer: Exports current design to slicer software or CAM software.
 * Macro Delta xyz : Gives the Delta values and the distance between 2 points
 * Macro CenterFace : This macro red trace (editable) the center face (mass) with 1 point and print the coordinates

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.


 * Collez votre macro, en utilisant les balises de texte préformaté 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.


 * En option, vous pouvez ajouter davantage d'infos sur l'utilisation de votre macro, ses limitations, et, les solutions de contournement.


 * Il est également intéressant d'inclure les informations de version de FreeCAD dans votre macro. Ces informations vous permettent de localiser votre macro dans le temps par rapport à l'évolution de FreeCAD, faites :

"Menu > Aide > A propos de FreeCAD et cliquez sur Copier dans le Presse-papiers" et coller ces informations dans votre macro.

Exemple :


 * Ajoutez la a une catégorie existante, ou créez en une si la catégorie n'existe pas.