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 makeCube : 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 1.7 - the best so far!)).
 * Macro GeodesicDome: 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 CutLine: 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 cutCircle: 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é).
 * Macro TriangleAH: 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: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
 * Macro Geneva Wheel: Permet de créer un mécanisme Croix de Malte à partir de rien. Les paramètre sont à régler dans la macro.
 * 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.

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).

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
 * 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 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: 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_Views_Visibility.png Macro Toggle Views 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.

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

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.