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 rectangular cuboid from 4 points
 * 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 2.0 - new version!)
 * Macro GeodesicDome: This macro creates a geodesic dome shell
 * [[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 Line Length: Create a line giving coordinate XYZ length and angle to plane X Y
 * Macro CutLine: Cut a line and create x points, giving the number of points, create line or not, create points or not, create bicolor or not on choice.
 * Macro Circle: Create a circle or arc giving radius, diameter, circumference, area, startangle, endangle, arc, anglecenter, cord, arrow, center (point) on choice.
 * Macro CutCircle: Cut a circle or arc and create x arcs, giving the number of cut.
 * Macro TriangleAH: This macro create one triangle creates a triangle by giving the head angle and the height of the triangle (the triangle of the head is positioned to the xyz coordinates 0.0)
 * [[Image:FCTexture.png|16px]] 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
 * [[Image:BoundBoxTracing.png|16px]] Macro BoundingBox Tracing : This macro red trace (editable) around the BoundingBox with 6 rectangles
 * [[Image:PartDesign_InvoluteGear.png|16px]] Involute Gear: allows you to create gear. See InvoluteGearFeature.py in FreeCAD_sf_master.
 * FCCircularTextButtom.png Macro FCCircularText: This macro create a text around a cylinder
 * Macro Geneva Wheel: Allows the user to create a Geneva wheel mechanism from scratch. Must edit values within the Macro to alter the size of the object.
 * Macro WireXYZ: This macro creates a Wire with the coordinates extracted from a file. The coordinates X Y Z are separated by a space.
 * FCSpring_Helix_Variable.png Macro FCSpring Helix Variable: This macro create one spring truncate, the troncature is adjustable on the all coil to choice.
 * Macro Arch Axis System Repartition: This macro help you to create an Arch Axis System along a line with a set of parameters.
 * Macro Cabinets32: creates side and top/bottom walls for a cabinet with drilled holes for connection parts of manufacturer Hettich.
 * Macro_Half_Hull_Model.png Macro Half-Hull Model: This macro generates both three dimensional half-hull and full-hull models from a series of 2D line drawings.
 * Macro Stairs: Create stair helix, create your stair nosing select and run the macro.

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.
 * [[Image:Macro_CloneConvert.png ‎|16px]] Macro CloneConvert: 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)
 * Macro Creating faces from a DXF file: This macro create face from a DXF file, the "Layer" are recognized separate and trained in groups.

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.
 * Macro Align Object to View Cette macro aligne l'objet sélectionné à la vue courante et prends les propriétés de celle-ci (Placement angle) de la caméra.
 * Macro Align Face Object to View Cette macro aligne la face sélectionnée face à l'écran (Si un forage ou une face intérieure est sélectionnée le forage est placé perpendiculairement à l'écran).

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 SheetMetalUnfolder: Créé une pièce dépliée à partir d'une pièce de métal en feuille.
 * 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.
 * Macro Geneva Wheel GUI: Une interface graphique pour créer un mécanisme de Croix de Malte.
 * [[Image:Part_Prism_Apothem.svg|16px]] Macro Apothem Based Prism GUI Une interface graphique pour créer un prisme basé sur l'Apothème, (rayon intérieur).

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
 * [[Image:Macro_FCInfoGlass.png|16px]] Macro FCInfoGlass : Gives a series of information about the selected shape and displayed in screen 3D
 * 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
 * CenterFace.png Macro CenterFace : This macro red trace (editable) the center face (mass) with 1 point and print the coordinates
 * Macro ObjectInfo: User-friendly "Info" module created by a FreeCAD user
 * MacroMenu: Add the macros found in the macros folder to the Macros menu of FreeCAD
 * [[Image:Force_Recompute.png|16px]] Macro ForceRecompute : Forces manual recompute of model
 * Macro Shake Sketch: Shake a sketch in order to discover its unconstrained parts.
 * [[Image:Replace_Part.png|16px]] Macro Replace Part in Assembly: Replaces a part (simple copy) in an "Assembly" with another Part (simple copy).
 * WF_wf.png Macro WorkFeatures: 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 Macro Dump Objects: This macro generates a listing of all objects in the current document - the list can be in a window or on the Report view.
 * Macro Manage Navigational Style: This pair of macros allow you to alter the Navigation Style while in the Sketcher.
 * Macro_Toggle_Views_Visibility.png Macro Toggle Views Visibility: This macro toggles the visibility of various supporting views in FreeCAD, allowing the main window to be viewed with all available screen space.
 * Macro_Python_Assistant_Window.png Macro Python Assistant Window: 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 Macro Build Utility: This macro provides a utility to assemble a project from sub-project files using the Merge Project facility.
 * FCCamera_00.png Macro_FCCamera: 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 Macro Global Variable Watcher: This macro facilitates the user selecting global variables and monitoring their values.

Fonctions mathématiques

 * Macro draw2DFunction: trace une fonction décrite par une équation z=F(x)
 * Macro drawParametric2Dfunction: cette macro est basée sur la macro ci-dessus, mais pour les équations paramétriques et éventuellement polaires.
 * Macro 3D Parametric Curve: Dessine le résultat de la courbe d'une fonction décrite par l'équation x(t), y(t) et z(t).

Animation

 * Macro Crank Simul : Rotation rod and piston
 * Macro Spring : simulation of one spring
 * Macro Hinge : Open and close hinge
 * Macro Assembly : Assembly animate
 * Macro Animated Constrain: Animate angle constrain in sketcher
 * Macro Assemblage Imprimante 3D: Simulation of movements of a 3D printer

Raytracing

 * Macro Export to Kerkythea : Export from FreeCAD to Kerkythea

FEM

 * GMSHMacro : Create FEM Meshes by GMSH Mesh Generator

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 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 :

It is also advisable to create a macro in your header, this header can be used by the Plugin Loader program to install the macro and check versions

Ex:


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