Macros recipes/it

Questa pagina contiene un elenco di macro con cui aggiungere delle funzionalità alla propria installazione di FreeCAD.

[[File:Part_CheckGeometry.svg]] Operazioni di visualizzazione 3D

 * : Ruota la visualizzazione corrente di 90° verso sinistra. Funziona solo se si è in vista dall'alto.
 * : Fornisce una interfaccia grafica per consentire la rotazione della vista di quantità precise in tutte e tre le direzioni.
 * : Permette di sovrapporre temporaneamente una immagine di texture sugli oggetti selezionati.
 * : Converte il puntatore del mouse in un puntatore di precisione a forma di croce.
 * : Allinea la vista corrente a una faccia selezionata
 * : Allinea l'oggetto selezionato alla vista corrente e imposta le coordinate di posizionamento della telecamera.
 * : Allinea la faccia dell'oggetto selezionato alla Vista corrente (nel caso di un foro la faccia del foro viene rivolta verso la Vista).
 * : Commuta la visibilità dai vari punti di vista supportati in FreeCAD, permettendo di visualizzare la finestra principale in tutto lo spazio disponibile sullo schermo.
 * : Questa macro può ruotare lo schermo di un determinato angolo, lungo un dato asse e crea un piano frontale allo schermo per creare una forma in un piano rivolto verso lo schermo nella posizione specificata, rilevando la posizione della fotocamera.
 * : Gruppo di tre macro, la macro 1: nasconde gli oggetti non selezionati, la macro 2: visualizza tutti gli oggetti, la macro 3: nasconde tutti gli oggetti.
 * : Seleziona tutti gli oggetti visibili nella struttura.
 * : Coppia di macro che consentono di modificare lo stile di navigazione mentre si lavora nello Sketcher.
 * : 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.
 * : Copia negli appunti il contenuto della vista 3D ridimensionata a 640, 480 px.

[[File:Draft_FlipDimension.svg]] Animazioni

 * : Simula la rotazione di una biella e un pistone
 * : Simula il movimento di una molla
 * : Simula l'apertura e la chiusura di una cerniera
 * : Animazione di assemblaggio
 * : Animazione dei vincoli di angolo in Sketcher
 * : Simula il movimento di una stampante 3D

[[File:Applications-python.svg]] Codice è Script

 * : Mostra come fornire informazioni all'utente attraverso l'interfaccia utente grafica GUI.
 * : Permette di tagliare/copiare/incollare del codice Python, è segmentata così possono essere selezionate delle sezioni diverse ed è persistente tra sessioni di FreeCAD.
 * : Fornisce utility per assemblare un progetto da file di sub-progetto utilizzando la funzione Merge Project.
 * : Facilita la selezione delle variabili globali e il monitoraggio dei loro valori.

[[File:Arch_MeshToShape.svg]] Conversione

 * : Estrae dei bordi wire dai mesh selezionati
 * : Converte gli oggetti Mesh selezionati in oggetti Parte.
 * : Converte le parti selezionate in mesh VRML per avere un file di piccole dimensioni caricabile velocemente (compatibile con i modelli VRML di Kicad e Blender)
 * : Converte la faccia selezionata in uno schizzo senza vincoli.
 * : Crea operazioni booleane con gli oggetti selezionati. Basta selezionare i contorni, assegnare lo spessore e cliccare su "Create"

[[File:Drawing-orthoviews.svg]] Foglio da disegno

 * : 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.
 * : Questa macro con GUI serve per compilare in 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.
 * : (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.
 * : (Full field edition for this Modelli misti) Per compilare tramite GUI tutti i campi del cartiglio del modello 2 di FreeCAD.
 * : Fornisce il vettore normale a una faccia prescelta per consentire di creare una vista di disegno perpendicolare a tale faccia.

[[File:Draft_BSpline.svg]] Dxf 2D Draft

 * : Crea un contorno a forma di rectellipse, ellisse rettangolare o rettangolo arrotondato, parametrico.
 * : Crea un cerchio su 3 punti selezionati, i punti possono anche essere oggetti (questa macro unisce le due macro riportate in seguito), tutti i parametri si impostano in modo semplice tramite una finestra grafica.
 * : Crea un cerchio passante per 3 punti selezionati in un piano 2D, i punti possono anche essere degli oggetti.
 * : Crea un cerchio passante per 3 punti selezionati nello spazio 3D.
 * : Crea un arco da 3 punti selezionati.
 * : Costruisce un ellisse selezionando tre punti nell'ordine: centro, raggio maggiore e raggio minore
 * : Converte la linea dell'oggetto, da continua a tratteggiata, a tratto e punto, o tratto punto punto, assegnandole le dimensioni indicate.
 * : Sostituisce, se possibile, i segmenti selezionati con un arco di cerchio. Utile per ripristinare gli archi discretizzati.
 * : Crea delle facce dai file DXF, i "Layer" sono riconosciuti singolarmente e inseriti in un gruppi distinti.
 * : Converte gli elementi selezionati in un DXF importato in facce e schizzi.
 * : Utility che riunisce numerosi comandi di Draft per lavorare con gli oggetti 2D. Ad esempio, lavorare con gli oggetti dei file DXF.
 * : Utilità per unire diverse polilinee in una sola, si possono usare MakeWire, Bspline, BsplineCurve, BsplineCurve + Arc, Polygon e curve di Bezier

[[File:Fem_ResultDisplacement.svg]] Fem

 * : Crea Mesh FEM con il generatore di Mesh GMSH

[[File:Part_Measure_Clear_All.svg]] Informazioni è misura

 * : Fornisce una serie di informazioni sulla forma selezionata e può convertire lunghezza, angoli (gradi, radianti, gradi centesimali), superficie, volume, peso e densità della forma selezionata sia nelle unità del Sistema Internazionale che in quelle del Sistema Anglosassone.
 * : come la precedente, ma per Linux
 * : Fornisce una serie di informazioni sulla forma selezionata e le visualizza nella schermata 3D
 * : Fornisce in tempo reale informazioni sulle coordinate, lunghezza e angoli del mouse in una bolla di annotazione visualizzata nella schermata 3D
 * : Dà il valore Delta xyz e la distanza tra 2 punti.
 * : Un semplice modulo "Info" creato da un utente di FreeCAD
 * : Genera un elenco di tutti gli oggetti del documento corrente. L'elenco può essere mostrato nella finestra Report o in una finestra indipendente.
 * : Calcola il raggio di un cerchio da 3 punti o da uno spigolo circolare.

[[File:Draft_VisGroup.svg]] Libreria

 * : Questa macro crea viti e bulloni, con o senza la filettatura, secondo le norme ISO (screw_maker1_6.py.zip with Pyside support). (Screw Maker 2.0 - nuova versione!)
 * : L'obiettivo di BOLTS è quello di costruire una libreria gratuita e open-source di parti standard per le applicazioni CAD.
 * : Avvia il browser per esplorare la libreria delle Parti

[[File:Bound-expression.svg]] Funzioni matematiche

 * : Disegna una funzione descritta dalle equazioni parametriche x(t), y(t) e z(t).
 * : Disegna una funzione definita da un'equazione z=F(x)
 * : Basata sulla macro precedente, ma per le equazioni parametriche e eventualmente polari.

[[File:IFC.svg]] Multifunctional

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

[[File:Workbench_Image.svg]] Object creation

 * : creates a rectangular cuboid from 4 points
 * : 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.
 * : This macro creates a geodesic dome shell
 * : Create a line giving coordinate XYZ length and angle to plane X Y
 * : 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.
 * : Create a circle or arc giving radius, diameter, circumference, area, startangle, endangle, arc, anglecenter, cord, arrow, center (point) on choice.
 * : Cut a circle or arc and create x arcs, giving the number of cut.
 * : 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)
 * : Create a project from a bmp image to create a texture easily
 * : Create a loft with a list of wire (specially created for Macro Texture see above)
 * : This macro create a text around a cylinder
 * : This macro creates a Wire with the coordinates extracted from a file. The coordinates X Y Z are separated by a space.
 * : This macro reproduce all element selected subobject wire or face.
 * : A GUI dialog that creates an Apothem, (inradius) Based Prism from user input.
 * : This macro create one spring truncate, the troncature is adjustable on the all coil to choice.

[[File:Workbench_PartDesign.svg]] 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
 * : 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
 * : 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 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.
 * : 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
 * : (parametric): alternative implementation of Part Section tool, more suitable for making sweep paths.
 * : (parametric): Boolean operation. Similar to Part Common, but with custom overlap count threshold.

[[File:View.svg]] Printer 3D

 * : Exports current design to slicer software or CAM software.

[[File:Preferences-raytracing.svg]] Raytracing

 * : Export from FreeCAD to Kerkythea

[[File:Spreadsheet.svg]] Spreadsheet Workbench

 * : helps managing aliases inside FreeCAD Spreadsheet workbench. It is able to create, delete, move aliases and create a 'part family' group of files.

[[File:Arch_Survey.svg]] Utility

 * : This macro red trace (editable) the center face (mass) with 1 point and print the coordinates
 * : This macro covers the following constraints: - Concentric constraint among non cylindrical parts; - Constraint on center Faces and/or Edges.
 * : This macro makes Cutouts for Enclosures in a very handy way
 * : Add the macros found in the macros folder to the Macros menu of FreeCAD
 * : Forces manual recompute of model
 * : Shake a sketch in order to discover its unconstrained parts.
 * : Replaces a part (simple copy) in an "Assembly" with another Part (simple copy).
 * : This macro toggles the Drawstyle of the selected object
 * : Highlight common parts.
 * : Compute the difference between two shapes.
 * : displays an interactively slidable cross-section.
 * : This macro red trace (editable) around the BoundingBox with 6 rectangles
 * : This macro help you to create an Arch Axis System along a line with a set of parameters.

[[File:Bulb.svg]] 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.
 * : Imports and scales a .dat airfoil to desired chord length.
 * : Allows the user to create a Geneva wheel mechanism from scratch. Must edit values within the Macro to alter the size of the object.
 * : A GUI front end that allows the user to create a Geneva wheel mechanism from scratch.
 * : creates side and top/bottom walls for a cabinet with drilled holes for connection parts of manufacturer Hettich.
 * : Creates a half turn (left/right) stair from a Data-file.
 * : This macro generates both three dimensional half-hull and full-hull models from a series of 2D line drawings.
 * : Create stair helix, create your stair nosing select and run the macro.
 * : Additional Workbench to create different types of gears, involute gear, involute rack, cycloide gear, bevel gear.
 * : 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 little macro create one Property additional (memo or other text) for you object (only Draft)

Std_FreeCADWebsite.png Other interesting macros create by FreeCAD users and deposit in extra wiki.

 * [[Image:2364.png|24px]] By microelly2 : freeCAD_macro, geodata, Animation, freecad-nurbs, PieMenu, ..... other
 * [[Image:Text-x-python.png|24px]] By hamish2014: FreeCAD_assembly2, FreeCAD_drawing_dimensioning, ...
 * [[Image:Text-x-python.png|24px]] By triplus: IconThemes, ShortCuts, NavigationIndicator, TabBar, Launcher, PersistentToolbars, PieMenu, ....
 * 681.jpg By rockn: FreeCAD-Timber, FreeCAD-addons, FreeCAD-library, FreeCAD-StructuresBois, .... other
 * [[Image:Text-x-python.png|24px]] By oddtopus: flamingo (workbench for metal structures)

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

Additionally, you can also add your new macro to a custom toolbar
 * In FreeCAD, go to Tools -> Customize
 * In the Macros tab, add a new macro, and, if you like, define an icon and a keyboard shortcut
 * In the Toolbars tab, create a new toolbar, and add your macro, taking it from the "Macros" category.
 * Tutorial Customize Toolbars

Adding new macros to this repository

 * Create a new page, beginning its name with "Macro", for example "Macro_My_Excellent_Macro", this can be done simply by editing this page, and adding a new link to your macro, like this:


 * example :


 * Text-x-python : icon by default (replace with your name icon with the exact same name as your macro page if there is. The format always .png only)
 * Macro My Excellent Macro : macro name
 * Macro My Excellent Macro title : macro name or title

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

(With the default icon)

(With the icon custom)

(Another language with the default icon (example "/fr" "/de" "/it"....))

(Another language with the icon custom (example "/fr" "/de" "/it"....))

Note that the name of the icon must have the same name as the name of the macro.
 * You can also Upload a custom format icon.png
 * example: " Macro_My_Excellent_Macro " without extension (the extension is given by the system), and, replace " Icon=Text-x-python " by " Icon=Macro_My_Excellent_Macro "
 * Text-x-python [[Image:Text-x-python.png|32px]] is the default icon of the page dedicated to the Macro.


 * Paste your macro, and use the Code template to avoid adding spaces into your script. This will display the macro in a monospace font inside a light grey box like the example above.
 * If you like, upload a .png icon with the exact same name as your macro page (ex. Macro_My_Excellent_Macro.png)
 * Add an image: an image is useful to show what the macro does. Optionally you can create an animated gif that represents the object in context. The gif image should have a maximum size of 500x500px as the wiki does not resize animated gifs; if the gif is any bigger the animation won't work.
 * Optionally you can add some more info on how to use your macro, tips, limitations and workaround.
 * It is also interesting to include version information in your macro. This macro allows you to locate in time compared to the evolution of FreeCAD, do "Menu > Help > About FreeCAD and click to Copy to clipboard" and paste it your macro

Ex:

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. Also available addons_installer.FCMacro

Ex:


 * Add it to the above categories, create a new category if needed.

Tutorials

 * How to install macros
 * Customize Toolbars
 * How to install additional workbenches