Macros recipes/fr

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

Object creation

 * [[Image:Macro_makeCube.png|24px]] : creates a rectangular cuboid from 4 points
 * [[Image:Text-x-python.png|24px]] : 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.
 * [[Image:Text-x-python.png|24px]] : creates a parametric rectellipse
 * [[Image:Macro_Draft_Circle_3_Points.png|24px]] : 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|24px]] : creates a circle from 3 selected points 2D orthogonal
 * [[Image:Macro_Draft_Circle_3_Points.png|24px]] : creates a circle from 3 selected points in the space 3D
 * [[Image:Macro Make Arc 3 Points.png|24px]] : creates a arc from 3 selected points
 * [[Image:Text-x-python.png|24px]] : 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!)
 * [[Image:Text-x-python.png|24px]] : This macro creates a geodesic dome shell
 * [[Image:Macro_BOLTS.png|24px]] : The aim of BOLTS is to build a free and open-source standard parts library for CAD applications.
 * [[Image:Text-x-python.png|24px]] Makes an ellipse by selecting three points (in this order): centre, major radius and minor radius
 * [[Image:Text-x-python.png|24px]] : Imports and scales a .dat airfoil to desired chord length.
 * [[Image:Text-x-python.png|24px]] : Create a line giving coordinate XYZ length and angle to plane X Y
 * [[Image:Text-x-python.png|24px]] : 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.
 * [[Image:Text-x-python.png|24px]] : Create a circle or arc giving radius, diameter, circumference, area, startangle, endangle, arc, anglecenter, cord, arrow, center (point) on choice.
 * [[Image:Text-x-python.png|24px]] : Cut a circle or arc and create x arcs, giving the number of cut.
 * [[Image:Macro_FCConvertLines.png|24px]] : this macro convert the object line, wire in line Dash, DashDot, DashDotDot,ZigZag and Hand with the dimensions given.
 * [[Image:Text-x-python.png|24px]] : 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|24px]] : Create a project from a bmp image to create a texture easily
 * [[Image:FCCreaLoft.png|24px]] : Create a loft with a list of wire (specially created for Macro Texture see above)
 * [[Image:FreeCAD Doc.png|24px]] : Starts the Parts library browser
 * [[Image:BoundBoxTracing.png|24px]] : This macro red trace (editable) around the BoundingBox with 6 rectangles
 * FCCircularTextButtom.png : This macro create a text around a cylinder
 * [[Image:GW_Dim.png|24px]] : Allows the user to create a Geneva wheel mechanism from scratch. Must edit values within the Macro to alter the size of the object.
 * [[Image:GW_Dim.png|24px]] : A GUI front end that allows the user to create a Geneva wheel mechanism from scratch.
 * [[Image:Text-x-python.png|24px]] : 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 : This macro create one spring truncate, the troncature is adjustable on the all coil to choice.
 * [[Image:Text-x-python.png|24px]] : This macro help you to create an Arch Axis System along a line with a set of parameters.
 * [[Image:Cabinets32.png|24px]] : creates side and top/bottom walls for a cabinet with drilled holes for connection parts of manufacturer Hettich.
 * [[Image:Text-x-python.png|24px]] : Creates a half turn (left/right) stair from a Data-file.
 * Macro_Half_Hull_Model.png : This macro generates both three dimensional half-hull and full-hull models from a series of 2D line drawings.
 * [[Image:Text-x-python.png|24px]] : Create stair helix, create your stair nosing select and run the macro.
 * [[Image:Macro_ReproWire.png|24px]] : This macro reproduce all element selected subobject wire or face.
 * [[Image:Gearworkbech.png|24px]] : Additional Workbench to create different types of gears, involute gear, involute rack, cycloide gear, bevel gear.

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 FlattenWire3Points: Cette macro aplatit les fils (Wire) du projet qui ne sont plan et défini par 3 points
 * Macro MeshToPart: Cette macro convertit certaines mailles en pièces.
 * [[Image:PartToVRML.png ‎|16px]] Macro PartToVRML: Cette macro converti un objet Part en objet VRML mesh pour les petites tailles utilisez (VRML models Kicad et Blender)
 * 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.
 * [[Image:Macro_CloneConvert.png ‎|16px]] 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...).
 * Macro Creating faces from a DXF file: Cette macro crée une face d'un objet créé à partir d'un fichier DXF.
 * [[Image:Macro_DXF_to_Face_and_Sketch.png ‎|16px]] Macro DXF to Face and Sketch: Cette macro converti un élément sélectionné ou importé d'un fichier DXF en face ou sketch.
 * Macro Image Scaling: Cette macro met facilement à l'échelle une image, photo, diagramme et image 2D pour pouvoir calquer cette image dans l'environnement 3D de FreeCAD.
 * Macro MatrixTransform: Applique des transformations spatiales linéaires pour déformer les formes. Par exemple, mise à l'échelle non-uniforme, cisaillement, mise en miroir, inversion d'axes.
 * [[Image:Macro_Connect_And_Sweep.png ‎|24px]] Macro Connect And Sweep: Cette macro crée facilement une connection entre deux objets, un objet et un point ou entre deux points (le centre des objets sont les points de départ et d'arrivée du sweep) une forme peut être choisie cercle polygone ellipse paramétrable
 * [[Image:Part_Section.png ‎|24px]] Macro Section (parametric): Alternative d'implantation de Part Section tool, plus appropriée pour la fabrication de chemin lissage (sweep).
 * [[Image:Macro_Overlap.png ‎|24px]] Macro Overlap (outil parametrique): Opération Boolean. Similaire à Part Common, mais paramétrique et avec plus d'options de chevauchement.
 * [[Image:Macro FCWire To Volume.png ‎|24px]] Macro FCWire To Volume: Cette macro crée facilement une opération booléenne en utilisant des objets Draft wires. Juste sélectionner vos formes donnez la longueur à extruder et cliquez sur le bouton "Create"

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).
 * Macro Duplicate Selection Sélectionnez vos objets dans la vue 3D, si une sélection est dupliquée le curseur de la souris change en "ForbiddenCursor" et reste dans cet état tan que la sélection est dupliquée.

Assistants

 * Macro Sheet Metal Unfolder: Créé une pièce dépliée à partir d'une pièce de métal en feuille.
 * Macro Unroll Ruled Surface: permet de dérouler les surfaces et de les dessiner sur une page.
 * Macro Unfold Box: 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 pour créer un mécanisme de roue de Genève à partir de zéro.
 * [[Image:Part_Prism_Apothem.png|16px]] Macro Apothem Based Prism GUI Une interface graphique pour créer un prisme basé sur l'Apothème, (rayon intérieur).

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.
 * [[Image:FCInfo.png|16px]] Macro FCInfo Alternate Linux : même que ci-dessus, mais pour Linux
 * [[Image:Macro_FCInfoGlass.png|16px]] Macro FCInfoGlass : Donne une série d'informations sur l'objet sélectionné directement dans la vue 3D
 * [[Image:FCInfoToMouse.png|16px]] Macro FCInfoToMouse : Donne les informations des coordonnées, longueur et angles en temps réel sur la souris dans une bulle annotation affichée dans l'écran 3D
 * 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
 * CenterFace.png Macro CenterFace : Cette macro trace un point rouge (editable) au centre de la face (mass), affiche les coordonnées XYZ du point dans la vue rapport ainsi que la surface de la face et ses coordonnées.
 * Macro ObjectInfo: Ce module "Info" affiche certains renseignements de l'objet sélectionné dans la vue "Vue combinée"
 * MacroMenu: Ajoute les macros trouvées dans le répertoire de macros dans le menu des macros de FreeCAD.
 * [[Image:Force_Recompute.png|16px]] Macro ForceRecompute : Forces le recalcul de votre projet.
 * Macro Shake Sketch: Démonte un un croquis pour y découvrir les parties non contraintes (a utiliser sur une copie de votre projet !).
 * [[Image:Replace_Part.png|16px]] Macro Replace Part in Assembly: Remplace une pièce (simple copie) dans un "assemblage" par une autre pièce (simple copie).
 * WF_wf.png Macro WorkFeatures: Utilitaire pour créer des plans à partir d'axes, plans depuis 3 points, axes sur une forme, obtenir de l'information sur les coordonnées d'une forme ainsi que plusieurs autres fonctionnalités pour faciliter la création de votre projet. Cet utilitaire s'affiche dans la vue combinée.
 * Macro_Dump_Objects.png Macro Dump Objects: Cette macro génère une liste de tous les objets dans le document courant - la liste peut être affichée dans une fenêtre ou dans la vue rapport.
 * Macro Manage Navigational Style: Cette paire de macros vous permettent de changer le style de navigation de la souris, "CADNavigationStyle" et "InventorNavigationStyle".
 * Macro_Toggle_Drawstyle.png Macro Toggle Drawstyle: Cette macro permet de basculer l'DrawStyle de l'objet sélectionné.
 * Macro_Toggle_Views_Visibility.png Macro Toggle Panels Visibility: Cette macro permet de basculer la visibilité des différentes vues dans FreeCAD, permettant à la fenêtre principale de prendre tout l'espace disponible de l'écran.
 * Macro_Python_Assistant_Window.png Macro Python Assistant Window: Cette macro fournit un espace de travail et permet de couper/copier/coller le code Python, il est segmenté de manière différentes les sections peuvent être sélectionnées et la macro est persistante entre les sessions FreeCAD.
 * Macro_Build_Utility.png Macro Build Utility: Cette macro présente l'utilité de créer un projet à partir d'un ensemble de fichiers (sous-projets) en utilisant l'outil de fusion de projet.
 * FCCamera_00.png Macro_FCCamera: Cette macro peut faire pivoter l'écran dans un angle défini et dans l'axe défini, ce qui permet de créer un plan face à l'écran, positionne la face (par sa face ou par son axe) de l'objet sélectionné face à l'écran, permet de détecter la position de la caméra ...
 * Macro_Global_Variable_Watcher.png Macro Global Variable Watcher: Cette macro rend plus facilite la sélection des variables globales et le suivi de leurs valeurs.
 * Macro HighlightCommon: Calcule les parties communes de deux objets.
 * [[Image:HighlightDifference.png|16px]] Macro HighlightDifference: Calcule les différences entre des shapes.
 * [[Image:PropertyMemo.png|16px]] Macro PropertyMemo: Cette petite macro vous permet de créer une nouvelle propriété à votre objet (mémo ou autre texte) ne fonctionne qu'avec les objets Draft.
 * [[Image:Macro SelectVisible.png|16px]] Macro Toggle Visibility: Ensemble de trois macros, macro 1: cache les objets qui ne sont pas sélectionnés, macro 2: affiche tous les objets, macro 3: cache tous les objets.
 * [[Image: SelectVisible.png|16px]] Macro SelectVisible: Tous les objets dans la vue 3D sont sélectionnés.
 * Macro Cross_section: Affiche de manière interactive une section transversale avec l'aide d'une barre coulissante.
 * [[Image: MeasureCircle.png|16px]] MeasureCircle: Calcule le rayon du cercle sur trois points ou sur l'arc ou circonférence du cercle.
 * [[Image:Macro_Copy3DViewToClipboard.png|16px]] Macro Copy3DViewToClipboard: Copie le contenu de la vue 3D redimensionné à 640, 480 px dans la mémoire (clipboard).

Fonctions mathématiques

 * 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).
 * Macro Draw 2D Function: trace une fonction décrite par une équation z=F(x)
 * Macro Draw Parametric 2D Function: cette macro est basée sur la macro ci-dessus, mais pour les équations paramétriques et éventuellement polaires.

Animation

 * Macro Simulation manivelle : Rotation d'une bielle et d'un piston.
 * Macro Ressort : Simulation de la compression d'un ressort.
 * Macro Hinge : Simulation de la rotation d'une charnière.
 * Macro Assembly : Animation d'un assemblage.
 * Macro Animated Constrain: Animate angle constrain in sketcher
 * Macro Assemblage Imprimante 3D: Simulation of movements of a 3D printer

Raytracing

 * Macro Export to Kerkythea : Exporte un fichier FreeCAD compatible avec Kerkythea

FEM

 * GMSH Macro : Crée un maillage FEM avec le générateur GMSH

Drawing Workbench

 * 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.png 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 Get Normal Vector of Face: Obtenir le vecteur normal d'une face sélectionnée pour créer une vue d'une normale à cette 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

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


 * Text-x-python : icon by default (replace with your name icon if there is)
 * Macro My Excellent Macro : macro name

A new page (red link) will be created.
 * In that page, paste the following text:

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 à une catégorie existante, ou créez en une si la catégorie n'existe pas.

Tutorials

 * Comment installer une macro
 * Créez votre propre barre d'outils
 * Comment installer un atelier supplémentaire