Macros recipes/it

Questa pagina contiene un elenco di macro con cui aggiungere delle funzionalità alla propria installazione di 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.
 * [[Image:Macro_FCConvertLines.png|16px]] Macro FCConvertLines: this macro convert the object line, wire in line Dash, DashDot, DashDotDot,ZigZag and Hand with the dimensions given.
 * 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:FCCreaLoft.png|16px]] Macro FCCreaLoft: Create a loft with a list of wire (specially created for Macro FCTexture see above)
 * [[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
 * FCCircularTextButtom.png Macro FCCircularText: This macro create a text around a cylinder
 * [[Image:GW_Dim.png|16px]] 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.
 * [[Image:GW_Dim.png|16px]] Macro Geneva Wheel GUI: A GUI front end that allows the user to create a Geneva wheel mechanism from scratch.
 * 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.
 * [[Image:Macro_ReproWire.png|16px]] Macro ReproWire: This macro reproduce all element selected subobject wire or face.
 * [[Image:Gearworkbech.png|16px]] Macro FCGear: Additional Workbench to create different types of gears, involute gear, involute rack, cycloide gear, bevel gear.

Trasformare oggetti

 * Macro ArrayCopy: Copia diverse volte l'oggetto selezionato, secondo una matrice.
 * Macro FlattenWire: Appiattisce una polilinea non planare sulla sua mediana delle coordinate Z.
 * Macro FlattenWire3Points: Appiattisce una polilinea non planare su un piano definito da 3 punti
 * Macro MeshToPart: Converte gli oggetti Mesh  selezionati in oggetti Parte.
 * [[Image:PartToVRML.png ‎|16px]] Macro PartToVRML: Converte le parti selezionate in mesh VRML per piccole dimensioni e caricamento veloce (compatibile con i modelli VRML di Kicad e Blender)
 * Macro JointWire: Consente di trovare tutti i bordi non collegati e di congiungerli al bordo non collegato più vicino tramite una linea.
 * Macro Remove parametric history: Elimina da un oggetto tutte le associazioni parametriche, lasciandolo come una forma "muta".
 * Macro SuperWire: Forza la creazione di una polilinea partendo da linee e archi non necessariamente contigui. Da utilizzare quando la normale operazione polilinea non riesce.
 * Macro HealArcs: Talvolta gli archi vengono trasformati in BSpline, per esempio quando ad essi sono applicate operazioni di scala. Questa macro ricrea gli archi dalle BSpline. Utile prima dell'esportazione in .dxf.
 * Macro FaceToSketch: Converte la faccia selezionata in uno Sketch senza vincoli.
 * Macro EdgesToArc: Sostituisce, se possibile, i segmenti selezionati con un arco di cerchio. Utile per ripristinare gli archi discretizzati.
 * [[Image:Macro_CloneConvert.png ‎|16px]] Macro CloneConvert: Crea un clone dell'oggetto, convertito nella posizione e nelle dimensioni scelte (inch, mm, m, µm...).
 * Crea facce da file DXF: Crea delle facce dai file DXF, i "Layer" sono riconosciuti singolarmente e inseriti in un gruppi distinti.
 * Macro Image Scaling: Macro per scalare disegni, grafici, schemi, modelli e immagini 2D simili nell'ambiente Immagine.
 * Macro MatrixTransform: applica una trasformazioni lineare dello spazio per modificare le forme. Ad esempio, la scalatura non uniforme, l'inclinazione di un testo (shader), la riflessione, l'inversione degli assi.
 * [[Image:Macro_Connect_And_Sweep.png ‎|24px]] Macro Connect And Sweep: Questa macro crea una connessione tra due oggetti, un oggetto e un punto o tra due punti. La connessione va da un centro all'altro centro degli oggetti, la sua forma è configurabile, e può essere circolare, poligonale o ellittica.

Operazioni di visualizzazione 3D

 * Macro Rotate View: Questa macro ruota la visualizzazione corrente di 90° verso sinistra. Funziona solo se si è in vista dall'alto.
 * Macro View Rotation: Fornisce una interfaccia grafica per consentire la rotazione della vista di quantità precise in tutte e tre le direzioni.
 * Macro Texture Objects: Permette di sovrapporre temporaneamente una immagine di texture sugli oggetti selezionati.
 * Macro Mouse Cross: Converte il puntatore del mouse in un puntatore di precisione a forma di croce.
 * Macro ViewToFace Questa macro allinea la vista corrente a una faccia selezionata
 * Macro Align Object to View This macro align the selected object to the current View and set the coordinates Placement of the camera.
 * Macro Align Face Object to View This macro align the face of the selected object to the current View (in case face hole the hole is placed to the view).
 * Macro Duplicate Selection Questa macro testa se una selezione è duplicabile. Selezionare gli oggetti nella vista 3D, se una selezione è duplicabile il mouse rimane bloccato su "ForbiddenCursor" fino a duplicazione avvenuta.

Assistenti

 * Macro SheetMetalUnfolder: Crea una parte dispiegata da un parte in lamiera.
 * Macro UnrollRuledSurface: permette di srotolare le superfici rigate e di disegnare lo sviluppo in una pagina.
 * Macro UnfoldBox: permette di creare e disegnare lo sviluppo di un solido con facce piane.
 * Macro Geneva Wheel GUI: Una interfaccia grafica che permette all'utente di impostare i valori per creare un meccanismo Croce di Malta da zero.
 * [[Image:Part_Prism_Apothem.svg|16px]] Macro Apothem Based Prism GUI Una GUI che permette di creare un prisma basato sull'apotema del suo poligono base, (inraggio).

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
 * [[Image:FCInfoToMouse.png|16px]] Macro FCInfoToMouse : Provide informations coordinates, length and angles in real time on the mouse in a bubble annotation displayed in the 3D screen
 * 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_Drawstyle.png Macro Toggle Drawstyle: This macro toggles the Drawstyle of the selected object
 * 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.
 * Macro HighlightCommon: Highlight common parts.
 * [[Image:HighlightDifference.png|16px]] Macro HighlightDifference: Compute the difference between two shapes.
 * [[Image:PropertyMemo.png|16px]] Macro PropertyMemo: This little macro create one Property additional (memo or other text) for you object (only Draft)
 * [[Image:Macro SelectVisible.png|16px]] Macro_ToggleSelectedObjectVisibility: 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]] Macro SelectVisible: All visible objects in the tree will be selected.
 * Macro Cross_section: displays an interactively slidable cross-section.
 * [[Image: MeasureCircle.png|16px]] Macro MeasureCircle: Compute the radius of a circle by 3 points or a circular edge.

Funzioni matematiche

 * Macro 3D Parametric Curve: Draw a function described by parametric equations x(t), y(t) and z(t).
 * Macro Draw2DFunction: Disegna una funzione definita da un'equazione z=F(x)
 * Macro DrawParametric2Dfunction: Basata sulla macro precedente, ma per le equazioni parametriche e eventualmente polari.

Animazioni

 * Macro Crank Simul : Simula la rotazione di una biella e un pistone
 * Macro Spring : Simula il movimento di una molla
 * Macro Hinge : Simula l'apertura e la chiusura di una cerniera
 * Macro Assembly : Animazione di assemblaggio
 * Macro Animated Constrain: Animazione dei vincoli di angolo in Sketcher
 * Macro Assemblage Imprimante 3D: Simula il movimento di una stampante 3D

Raytracing

 * Macro Export to Kerkythea : Exporta da FreeCAD a Kerkythea

FEM

 * Macro GMSH : Crea Mesh FEM con il generatore di Mesh GMSH

Ambiente Drawing

 * Macro Automatic Drawing: Consente all'utente di ottenere la visualizzazione di un oggetto in un disegno in 4 diverse posizioni (frontale, superiore, da destra e iso). Necessita di qualche modifica per essere perfettamente efficace.
 * Macro Corner Shapes Wizard: Apre una finestra di dialogo per le dimensioni angolari del pezzo, quindi crea l'oggetto nel documento e crea una pagina (foglio) di disegno con la vista superiore, frontale e laterale del pezzo.
 * Macro CartoucheFC: Questa macro con GUI serve per compilare i modo semplice tutti i campi della tabella del foglio da disegno di FreeCAD, il formato della data e il simbolo del modo di proiezione si adattano sia al sistema UE che US.
 * Macro Vettore normale alla faccia: Fornisce il vettore normale a una faccia prescelta per consentire di creare una vista di disegno perpendicolare a tale faccia.
 * Macro CartoucheFC Full: (Full field edition for this Modelli misti) Per compilare tramite GUI tutti i campi del cartiglio del modello 1 di FreeCAD, il formato della data e il simbolo della modalità di proiezione si adattano alla regione selezionata, EU o US.
 * Macro CartoucheFC 2: (Full field edition for this Modelli misti) Per compilare tramite GUI tutti i campi del cartiglio del modello 2 di FreeCAD.

How to use?
The above macros can easily be plugged on any FreeCAD installation
 * Copy the macro python code from the corresponding macro page
 * In FreeCAD, Macro->Macros->Create new, and give it a name
 * Paste the python code you copied
 * Hit the Save button, and restart FreeCAD
 * Open the Macro manager, select your new macro and click "execute"
 * Tutorial How to install macros

Inoltre, è anche possibile aggiungere la nuova macro a una barra degli strumenti personalizzata
 * In FreeCAD, andare in Strumenti -> Personalizza
 * Nella scheda Macro, aggiungere una nuova macro, e, volendo, definire un'icona e una scorciatoia da tastiera
 * Nella scheda Barre degli strumenti, creare una nuova barra degli strumenti, e aggiungere le macro selezionandole nella categoria "Macro".
 * Tutorial Personalizzare la barra degli strumenti

Aggiungere nuove macro a questo repository
"Macro My Excellent Macro: My excellent macro". L'operazione crea una nuova pagina (link rosso).
 * Creare una nuova pagina il cui nome inizi con "Macro", per esempio "Macro_My_Excellent_Macro". Questo si può fare modificando semplicemente la presente pagina, e aggiungendo un nuovo collegamento alla macro, ad esempio:
 * Nella pagina appena creata, incollare il seguente testo:

Esempio con icona di default: Esempio con icona personalizzata: In altra lingua, con icona di default, ad esempio "/fr" "/de" "/it": In altra lingua, con icona personalizzata, ad esempio "/fr" "/de" "/it": Ricordare che l'icona deve avere lo stesso nome della macro.
 * Si può anche caricare una icona personalizzata in formato .png
 * esempio : " Macro_My_Excellent_Macro " senza estensione (l'estensione viene fornita dal sistema), e, sostituire " Icon=Text-x-python " con " Icon=Macro_My_Excellent_Macro "
 * Text-x-python [[Image:Text-x-python.png|32px]] è l'icona di default della pagina dedicata alle Macro.


 * Incollare la macro, e utilizzare Code template per evitare di aggiungere spazi nello script. La macro viene visualizzata in un font a spaziatura fissa all'interno di un riquadro di colore grigio chiaro come nell'esempio precedente.
 * Si può caricare un'icona .png con lo stesso nome della macro, per esempio Macro_My_Excellent_Macro.png
 * Aggiungere un'immagine: l'immagine è utile per mostrare cosa fa la macro. Opzionalmente è possibile creare una gif animata che rappresenta l'oggetto nel contesto. Creare le Gif Animate con dimensione massima di 500x500px, il sito non accetta il loro ridimensionamento. Le gif animate ridimensionate sono visualizzate come immagini fisse.
 * Opzionalmente è possibile aggiungere ancora delle informazioni su come utilizzare la macro, consigli, limitazioni e trucchi.
 * Aggiungerla a una delle categorie di cui sopra, oppure creare una nuova categoria, se è necessario.
 * È anche interessante includere nella macro le informazioni sulla versione di FreeCAD utilizzata per costruirla. La macro può così essere confrontata con l'evoluzione di FreeCAD. Fare "Menu → Aiuto → About FreeCAD" e poi cliccare su "Copia negli appunti" e incollare le informazioni nella macro

Es:

Si consiglia inoltre di creare una intestazione nella macro, questa intestazione può essere utilizzata dal programma Plugin Loader per installare le macro e controllare le versioni. È anche disponibile la addons_installer.FCMacro

Es:

Aggiungerla alle categorie di cui sopra, o creare una nuova categoria, se è necessario.