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]] : 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.
 * : creates a parametric rectellipse
 * [[Image:Macro_Draft_Circle_3_Points.png|16px]] : 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]] : creates a circle from 3 selected points 2D orthogonal
 * [[Image:Macro_Draft_Circle_3_Points.png|16px]] : creates a circle from 3 selected points in the space 3D
 * [[Image:Macro Make Arc 3 Points.png|16px]] : creates a arc from 3 selected points
 * : 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!)
 * : This macro creates a geodesic dome shell
 * [[Image:Macro_BOLTS.png|16px]] : The aim of BOLTS is to build a free and open-source standard parts library for CAD applications.
 * Makes an ellipse by selecting three points (in this order): centre, major radius and minor radius
 * : Imports and scales a .dat airfoil to desired chord length.
 * : 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.
 * [[Image:Macro_FCConvertLines.png|16px]] : this macro convert the object line, wire in line Dash, DashDot, DashDotDot,ZigZag and Hand with the dimensions given.
 * : 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]] : Create a project from a bmp image to create a texture easily
 * [[Image:FCCreaLoft.png|16px]] : Create a loft with a list of wire (specially created for Macro Texture see above)
 * [[Image:FreeCAD Doc.png|16px]] : Starts the Parts library browser
 * [[Image:BoundBoxTracing.png|16px]] : This macro red trace (editable) around the BoundingBox with 6 rectangles
 * FCCircularTextButtom.png : This macro create a text around a cylinder
 * [[Image:GW_Dim.png|16px]] : 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]] : A GUI front end that allows the user to create a Geneva wheel mechanism from scratch.
 * : 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 : This macro create one spring truncate, the troncature is adjustable on the all coil to choice.
 * : This macro help you to create an Arch Axis System along a line with a set of parameters.
 * : creates side and top/bottom walls for a cabinet with drilled holes for connection parts of manufacturer Hettich.
 * Macro_Half_Hull_Model.png : 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.
 * [[Image:Macro_ReproWire.png|16px]] : This macro reproduce all element selected subobject wire or face.
 * [[Image:Gearworkbech.png|16px]] : 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 Sviluppa Lamiera: Crea una parte dispiegata da un parte in lamiera.
 * Macro Sviluppa Superfici rigate: permette di srotolare le superfici rigate e di disegnare lo sviluppo in una pagina.
 * Macro Sviluppa Box: permette di creare e disegnare lo sviluppo di un solido con facce piane.
 * Macro Croce di Malta 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 Prisma basato su Apotema 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
 * [[Image:Macro_FCInfoGlass.png|16px]] Macro FCInfoGlass : Fornisce una serie di informazioni sulla forma selezionata e le visualizza nella schermata 3D
 * [[Image:FCInfoToMouse.png|16px]] Macro FCInfoToMouse : Fornisce in tempo reale informazioni sulle coordinate, lunghezza e angoli del mouse in una bolla di annotazione visualizzata nella schermata 3D
 * 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.
 * CenterFace.png 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).
 * WF_wf.png Macro WorkFeatures: Gruppo di strumenti per creare i piani degli assi, i piani da 3 punti, gli assi su una forma, per ottenere informazioni sulle coordinate della forma e molte altre funzioni che facilitano la creazione del progetto. Questi strumenti sono mostrati in una scheda della Vista combinata.
 * Macro_Dump_Objects.png Macro Dump Objects: Questa macro genera un elenco di tutti gli oggetti del documento corrente. L'elenco può essere mostrato nella finestra Report o in una finestra indipendente.
 * Macro Manage Navigational Style: Questa coppia di macro consente di modificare lo stile di navigazione mentre si lavora nello Sketcher.
 * Macro_Toggle_Drawstyle.png Macro Toggle Drawstyle: Questa macro commuta lo Stile di disegno - DrawStyle - dell'oggetto selezionato.
 * Macro_Toggle_Views_Visibility.png Macro Nascondi Pannelli: Questa macro commuta la visibilità dai vari punti di vista supportati in FreeCAD, permettendo di visualizzare la finestra principale in tutto lo spazio disponibile sullo schermo.
 * Macro_Python_Assistant_Window.png Macro Python Assistant Window: Questa macro permette di tagliare/copiare/incollare del codice Python, è segmentata così possono essere selezionate delle sezioni diverse ed è persistente tra sessioni di FreeCAD.
 * Macro_Build_Utility.png Macro Build Utility: Questa macro fornisce utility per assemblare un progetto da file di sub-progetto utilizzando la funzione Merge Project.
 * 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: Questa macro facilita la selezione delle variabili globali e il monitoraggio dei loro valori.
 * Macro HighlightCommon: Evidenzia le parti comuni tra forme.
 * [[Image:HighlightDifference.png|16px]] Macro HighlightDifference: Calcola le differze tra due forme.
 * [[Image:PropertyMemo.png|16px]] Macro PropertyMemo: Questa macro crea una Proprietà aggiuntiva (nominabile a piacere) per gli oggetti, funziona solo in Draft.
 * [[Image:Macro SelectVisible.png|16px]] Macro Mostra o Nascondi oggetti: Set di tre macro, macro 1: nasconde gli oggetti non selezionati, macro 2: visualizza tutti gli oggetti, macro 3: nasconde tutti gli oggetti.
 * [[Image: SelectVisible.png|16px]] Macro SelectVisible: Seleziona tutti gli oggetti visibili nella struttura.
 * Macro Cross_section: mostra una sezione trasversale interattiva scorrevole.
 * [[Image: MeasureCircle.png|16px]] Macro MeasureCircle: Calcola il raggio di un cerchio da 3 punti o da uno spigolo circolare.

Funzioni matematiche

 * Macro Curva Parametrica 3D: Draw a function described by parametric equations x(t), y(t) and z(t).
 * Macro Funzione 2D: Disegna una funzione definita da un'equazione z=F(x)
 * Macro Funzione 2D Parametrica: 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 Proiezioni automatiche: 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 Supporto per Pezzi Angolari: 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 Cartiglio: 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 Cartiglio Completo: (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 Cartiglio 2: (Full field edition for this Modelli misti) Per compilare tramite GUI tutti i campi del cartiglio del modello 2 di FreeCAD.
 * 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.

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"
 * Tutorial Come installare le Macro

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.