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 cube from 4 points
 * Macro draw2DFunction: draws a function described by an equation z=F(x)
 * Macro drawParametric2Dfunction: Based on the above macro, but for parametric and optionally polar equations.
 * 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 1.7 - the best so far!)
 * [[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 3D Parametric Curve: Draw a function described by parametric equations x(t), y(t) and z(t).
 * Macro Line Length: Create a line giving coordinate XYZ length and angle to plane X Y
 * 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
 * Macro BoundingBox Tracing : This macro red trace (editable) around the BoundingBox with 6 rectangles
 * Involute gear: allows you to create gear. See InvoluteGearFeature.py in FreeCAD_sf_master.

Trasformare oggetti

 * Macro ArrayCopy: Copia diverse volte l'oggetto selezionato, secondo una matrice.
 * Macro FlattenWire: Appiattisce una polilinea non piana sulla sua mediana delle coordinate Z.
 * Macro MeshToPart: Converte gli oggetti Mesh  selezionati in oggetti Parte.
 * 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.
 * Macro CloneConvert: Crea un clone dell'oggetto, convertito nella posizione e nelle dimensioni scelte (inch, mm, m, µm...).

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 Align View to Face Questa macro allinea la vista corrente a una faccia selezionata

Assistenti

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

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
 * 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
 * Macro CenterFace : This macro red trace (editable) the center face (mass) with 1 point and print the coordinates

Come utilizzare le macro
Le macro di cui sopra possono essere facilmente inserite in qualsiasi installazione di FreeCAD:
 * Copiare il codice python della macro dalla pagina della macro corrispondente
 * In FreeCAD selezionare Macro-> Macro-> Crea nuova e assegnare un nome
 * Incollare il codice python copiato
 * Premere il pulsante Salva e riavviare FreeCAD
 * Aprire il gestore delle Macro, selezionare la nuova macro e fare clic su "Esegui"

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

Aggiungere nuove macro a questo repository

 * 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: "Macro My Excellent Macro: My excellent macro" . L'operazione crea una nuova pagina (link rosso).
 * 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.


 * Paste your macro, and use the   preformated text wiki tags 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)
 * 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:


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