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 1.7 - the best so far!)
 * 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.
 * 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: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
 * [[Image:PartDesign_InvoluteGear.png|16px]] Involute Gear: allows you to create gear. See InvoluteGearFeature.py in FreeCAD_sf_master.
 * FCCircularTextButtom.png 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.
 * 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.

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

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 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 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.
 * 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_Views_Visibility.png Macro Toggle Views Visibility: 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.

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

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

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

Ex:

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