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 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.
 * Macro FCCircularText: This macro create a text around a cylinder
 * 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.
 * Macro WireXYZ: This macro creates a Wire with the coordinates extracted from a file. The coordinates X Y Z are separated by a space.
 * 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.

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...).
 * Crea facce da file DXF: Crea delle facce dai file DXF, i "Layer" sono riconosciuti singolarmente e inseriti in un gruppi distinti.

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

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

Utilità

 * Macro MessageBox: Mostra come fornire informazioni all'utente attraverso l'interfaccia utente grafica GUI.
 * [[Image:FCInfo.png|16px]] Macro FCInfo : 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.
 * [[Image:FCInfo.png|16px]] Macro FCInfo Alternate Linux : come la precedente, ma for Linux
 * Macro 3D Printer Slicer: Esporta il progetto corrente verso un software di analisi (slicer) per stampanti 3D o verso un software CAM.
 * Macro Delta xyz : Dà il valore Delta xyz è la distanza tra 2 punti.
 * Macro CenterFace : Questa macro marca con un punto rosso (modificabile) il centro della faccia (massa) e stampa le sue coordinate
 * Macro ObjectInfo: Un semplice modulo "Info" creato da un utente di FreeCAD
 * MacroMenu: Aggiunge le macro trovate nella cartella delle macro al menu delle macro di FreeCAD
 * [[Image:Force_Recompute.png|16px]] Macro ForceRecompute : Forza il ricalcolo manuale del modello
 * Macro Shake Sketch: Scrolla uno schizzo per scoprire le sue parti non vincolate
 * [[Image:Replace_Part.png|16px]] Macro Replace Part in Assembly: Sostituisce una Parte (semplice copia) in un "Assembly" con un'altra Parte Part (semplice copia).

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

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"
 * Sezione animazione: Raccolta di gif animate che riproducono l'oggetto nel suo 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.

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.


 * Incollare la macro, e utilizzare le etichette per il testo preformattato del wiki   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.
 * 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.
 * 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:

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