Macros recipes/fr

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

Création d'objets
Macro Half-Hull Model: Cette macro génère une coque en trois dimensions half-hull à partir d'une série de dessins 2D.
 * [[Image:Macro_makeCube.png|16px]] Macro Make Cube : créé un pavé droit (Parallélépipède rectangle) à partir de 4 points
 * 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.
 * Macro Rectellipse: crée un rectellipse paramétrique.
 * [[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)(screw_maker1_6.py.zip avec support Pyside) ((Screw Maker 2.0 - new version!)).
 * Macro Geodesic Dome: Cette macro crée la coquille d'un dôme géodésique.
 * [[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 ellipse en sélectionnant 3 points (dans cet ordre): centre, grand rayon et petit rayon.
 * Macro Airfoil Import & Scale : Importe et met à l'échelle sur la longueur choisie un fichier airfoil .dat.
 * Macro Line Length: Crée une ligne en donnant comme paramètres au choix les coordonnées de départ XYZ une longueur et un angle dans le plan X Y.
 * Macro Cut Line: Cette macro crée x points ou coupe votre ligne originale en x lignes, donner le nombre de points, vous pouvez : créer des points ou non, créer les lignes (raccorder les points) ou non, créer vos ligne alternativement en deux couleurs (rouge et blanc) ou non au choix. La ligne originale n'est pas modifiée (valable sur ligne, cercle, forme . . .)
 * Macro Circle: Crée un cercle ou un arc en donnant différents paramètres au choix comme rayon, diamètre, circonférence, surface, début angle, fin d'angle, arc, anglecentral, corde, flèche, centre (point), placement.
 * Macro Cut Circle: Coupe un cercle ou un arc en x arcs, sélectionnez l'objet(s) donner le nombre de coupures et lancez la macro (Le cercle ou arc original n'est pas modifié).
 * [[Image:Macro_FCConvertLines.png|16px]] Macro FC Convert Lines: cette macro convertit une ligne, bord (crée une nouvelle ligne) en ligne tiret, tiret point (axe), tiret point point, zigzag et "manuel" paramétrable.
 * Macro Triangle AH: Cette macro crée un triangle en donnant l'angle de tête et la hauteur du triangle (La tête du triangle est positionnée aux coordonnées 0.0.0)
 * [[Image:FCTexture.png|16px]] Macro FCTexture: Crée un projet à partir d'une image BMP en vue de créer une texture en 3D très facilement ou n'importe quelle autre utilisation possible vous êtes jute limité par votre imagination.
 * [[Image:FCCreaLoft.png|16px]] Macro FCCreaLoft: Cette macro crée un loft de plusieurs lignes sélectionnées (Cette macro est spécialement conçue pour la macro FCTexture ci dessus)
 * [[Image:FreeCAD Doc.png|16px]] Macro PartsLibrary: Démarre le navigateur de la bibliothèque de pièces.
 * [[Image:BoundBoxTracing.png|16px]] Macro BoundingBox Tracing : Cette macro trace 6 rectangles en rouge (1 rectangle par face avec couleur modifiable dans la macro) représentant le BoundingBox (dimensions externes maximum) de l'objet sélectionné.
 * [[Image:PartDesign_InvoluteGear.png|16px]] Macro Involute Gear: Cette macro vous permet de créer des engrenages. Voir InvoluteGearFeature.py dans FreeCAD_sf_master.
 * FCCircularTextButtom.png Macro FCCircularText: Cette macro crée un texte autour d'un cylindre
 * [[Image:GW_Dim.png|16px]] Macro Geneva Wheel: Permet de créer un mécanisme Croix de Malte à partir de rien. Les paramètres sont à régler dans la macro.
 * [[Image:GW_Dim.png|16px]] Macro Geneva Wheel GUI: Permet de créer un mécanisme Croix de Malte à partir de rien. Facilité de régler les paramètre dans l'interface graphique.
 * Macro WireXYZ: Cette macro créer un filaire avec les coordonnées extraite depuis un fichier. Les coordonnées X, Y et Z sont séparés par un espace.
 * FCSpring_Helix_Variable.png Macro FCSpring Helix Variable: Cette macro créer un ressort variable.
 * Macro Arch Axis System Repartition: Cette macro vous aide dans la création d'un système d'axes le long d'une ligne est selon divers paramètres.
 * Macro Cabinets32: crée les panneaux latéraux, supérieurs et fond pour une armoire avec les forages pour loger les pièces de raccordement de fabrication Hettich.
 * Wiring_And_Hoses.png Macro Wiring And Hoses: Ces macros créent des câbles et tubes.
 * Macro Stairs: Cette macro crée un escalier sur une hélice, créer la marche sélectionnez là et lancez la macro.
 * [[Image:Macro_ReproWire.png|16px]] Macro Repro Wire: Cette macro reproduit un ou les objets ou suBobjet sélectionnés ligne face ....
 * [[Image:Gearworkbech.png|16px]] Macro FCGear: Atelier supplémentaire pour créer des engrenages à taille droite, crémaillères, engrenages cycloïdes et coniques.

Object transformation

 * : copies the selected object several times, on an array grid
 * : flattens draft wires that are not planar to their median Z coordinate
 * : flattens draft wires that are not planar to a plane defined by 3 points
 * : converts selected meshes to parts
 * [[Image:PartToVRML.png ‎|16px]] : Converts selected parts to VRML meshes for small size and faster loading (VRML models Kicad and Blender compatible)
 * : allows to find and joint all non connected edge to the closest non connected one using a line
 * : removes all parametric associativity from an object, leaving it as a "dumb" shape
 * : Forces the creation of a Wire from lines and arcs that don't necessarily touch each other. Use this if normal wire operation fails
 * : 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
 * : Converts the selected Face to a single Sketch without constraints.
 * : Converts the selected Edges to a circular Arc if possible. Useful for restoring discretized arcs.
 * [[Image:Macro_CloneConvert.png ‎|16px]] : Creates a clone of the object and the converted in the chosen position and size (inch, mm, m, µm...). The base object is recognized in mm (FreeCAd base)
 * : This macro create face from a DXF file, the "Layer" are recognized separate and trained in groups.
 * : Macro for easy scaling drawings, graphics, diagram, blueprint and similar 2D images in Image workbench.
 * : apply linear space transformations to distort shapes. E.g., non-uniform scaling, shearing, mirroring, axes swapping.
 * [[Image:Macro_Connect_And_Sweep.png ‎|24px]] : This macro easily creates a connection between two objects, an object and a point or between two points (the center of the objects are the starting and ending points of the sweep) can be selected form a configurable ellipse polygon circle

3D View operations

 * This macro rotates the current view by 90° to the left. Only works if you are in Top view.
 * Provides a GUI to permit rotation of view by precise amounts in all three directions.
 * This macro allows you to temporarily put a texture image on the selected objects.
 * This small macro turns the arrow of the mouse in a precision cross.
 * This macro aligns the current view to a selected face.
 * This macro align the selected object to the current View and set the coordinates Placement of the camera.
 * This macro align the face of the selected object to the current View (in case face hole the hole is placed to the view).
 * This macro testing if one selection are duplicate, select the object IN THE 3D VIEW the "ForbiddenCursor" stay if the or one selection is duplicate, the macro stay resident.

Wizards

 * : Creates an unfolded part from a sheet-metal-part.
 * : allows to unroll ruled surfaces and to draw them on a page.
 * : allows to unfold the surfaces of a box of any shape and to draw them on a page.
 * : A GUI front end that allows the user to create a Geneva wheel mechanism from scratch.
 * [[Image:Part_Prism_Apothem.svg|16px]] A GUI dialog that creates an Apothem, (inradius) Based Prism from user input.

Utility

 * : shows how to give information to the user through the GUI.
 * [[Image:FCInfo.png|16px]] : 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]] : same as above, but for Linux
 * [[Image:Macro_FCInfoGlass.png|16px]] : Gives a series of information about the selected shape and displayed in screen 3D
 * [[Image:FCInfoToMouse.png|16px]] : Provide informations coordinates, length and angles in real time on the mouse in a bubble annotation displayed in the 3D screen
 * : Exports current design to slicer software or CAM software.
 * : Gives the Delta values and the distance between 2 points
 * CenterFace.png : This macro red trace (editable) the center face (mass) with 1 point and print the coordinates
 * : User-friendly "Info" module created by a FreeCAD user
 * : Add the macros found in the macros folder to the Macros menu of FreeCAD
 * [[Image:Force_Recompute.png|16px]] : Forces manual recompute of model
 * : Shake a sketch in order to discover its unconstrained parts.
 * [[Image:Replace_Part.png|16px]] : Replaces a part (simple copy) in an "Assembly" with another Part (simple copy).
 * WF_wf.png : Tool utility to create plans of the axes, planes from 3 points, axes on a form, information on the coordinates of the shape and many other useful features to facilitate the creation of your project. This utility is up next in the combo view.
 * Macro_Dump_Objects.png : This macro generates a listing of all objects in the current document - the list can be in a window or on the Report view.
 * : This pair of macros allow you to alter the Navigation Style while in the Sketcher.
 * Macro_Toggle_Drawstyle.png : This macro toggles the Drawstyle of the selected object
 * Macro_Toggle_Views_Visibility.png : This macro toggles the visibility of various supporting panels in FreeCAD, allowing the main window to be viewed with all available screen space.
 * Macro_Python_Assistant_Window.png : This macro provides a cut/copy/paste workspace for Python code, it is segmented so different sections can be selected and it is persistent between FreeCAD sessions.
 * Macro_Build_Utility.png : This macro provides a utility to assemble a project from sub-project files using the Merge Project facility.
 * FCCamera_00.png : This macro can rotate the screen in a defined angle and the defined axis and creates a plan to face the screen to create a form in the specified plan positions the selected face facing the screen, to detect the position of the camera ...
 * Macro_Global_Variable_Watcher.png : This macro facilitates the user selecting global variables and monitoring their values.
 * : Highlight common parts.
 * [[Image:HighlightDifference.png|16px]] : Compute the difference between two shapes.
 * [[Image:PropertyMemo.png|16px]] : This little macro create one Property additional (memo or other text) for you object (only Draft)
 * [[Image:Macro SelectVisible.png|16px]] : Set of three macro, macro 1: hidden the objects not selected, macro 2: displayed alls objects, macro 3: hidden alls objects.
 * [[Image: SelectVisible.png|16px]] : All visible objects in the tree will be selected.
 * : displays an interactively slidable cross-section.
 * [[Image: MeasureCircle.png|16px]] : Compute the radius of a circle by 3 points or a circular edge.

Mathematical functions

 * : Draw a function described by parametric equations x(t), y(t) and z(t).
 * : draws a function described by an equation z=F(x)
 * : Based on the above macro, but for parametric and optionally polar equations.

Animation

 * : Rotation rod and piston
 * : Simulation of one spring
 * : Open and close hinge
 * : Assembly animate
 * : Animate angle constrain in sketcher
 * : Simulation of movements of a 3D printer

Raytracing

 * : Export from FreeCAD to Kerkythea

FEM

 * : Create FEM Meshes by GMSH Mesh Generator

Drawing Workbench

 * : allows the user to get the view of his object in a drawing with 4 different position (front,top,iso,right). Needs some modification to be perfectly effective
 * : pops up a dialog asking for the dimensions of your corner piece, then creates the object in the document and creates a page view with top, front and lateral views of the piece
 * : This GUI macro to fill simply all fields of the cartridge of the plan implementation worksheet FreeCAD, the format of the date and the symbol of the projection mode adapt to the EU region or US selected.
 * This GUI macro to fill simply all fields of the cartridge model 1 of the plan implementation worksheet FreeCAD, the format of the date and the symbol of the projection mode adapt to the EU region or US selected.
 * This GUI macro to fill simply all fields of the cartridge model 2 of the plan implementation worksheet FreeCAD.
 * : Get the normal vector of a preselected face for creating a drawing view normal to that face

Utilisation
Les macros citées ci-dessus peuvent être facilement ajoutées à FreeCAD :
 * Copiez le code Python de la macro de la page de macro correspondante
 * Dans FreeCAD, allez dans le menu Macro → Macros... puis cliquez sur le bouton « Créer » et saisissez un nom
 * Collez le code Python que vous aviez copié
 * Cliquez sur le bouton Sauvegarder, puis redémarrez FreeCAD
 * Ouvrez le Gestionnaire de macros, sélectionnez votre nouvelle macro et cliquez sur « Lancer ».
 * Tutoriel Comment installer une macro et comment palier aux erreurs copier/coller et autres petits pièges indésirables.

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".
 * Tutoriel Comment créer sa barre d'outils.

Ajouter de nouvelles macros à cette page
"Macro My Excellent Macro: My excellent macro". Sur cette page, créez le lien et validez la page, le nouveau lien créé s'affiche en rouge cliquez sur le lien rouge et une nouvelle page sera créée
 * Demandez les droits en écriture sur le wiki
 * Créez une nouvelle page dont le nom commence par "Macro", par exemple "Macro_Ma_macro_excellente" éditer votre page et ajoutez un lien sur votre macro, faites ce qui suit:


 * 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 le template 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.
 * Si vous le voulez, importez une icône .png avec le nom exact de votre page macro (par ex. Macro_My_Excellent_Macro.png)
 * Ajouter une image : une image peut être utile pour montrer ce que fait la macro. En option, vous pouvez créer un gif animé qui présente l'effet de la macro. La taille de l'image gif ne devrait pas excéder 500 x 500 px car le wiki ne peut pas redimensionner les gif animés ; si le gif est plus grand, l'animation ne fonctionnera pas.
 * 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 > À propos de FreeCAD, cliquez sur « Copier dans le Presse-papiers » et coller ces informations dans votre macro.

Exemple :

Il est aussi intéressant de créer un entête dans votre macro, cet entête servira dans la macro Plugin Loader programme d'installation de macro et vérificateur de versions. Aussi disponible addons_installer.FCMacro

Exemple :


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