Macros recipes/it

=Esempi di macro=

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

__

Creare oggetti

 * [[Image:Macro_makeCube.png|16px]] Macro_makeCube : Crea un cubo utilizzando 4 punti
 * 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.
 * Macro_Solid Sweep: Crea un solido estrudendo un profilo 2D lungo una traiettoria selezionata precedentemente nella vista 3D. Gli elementi 2D si creano attraverso i normali strumenti GUI di FreeCAD.
 * Macro Rectellipse: crea un contorno a forma di rectellipse (ellisse rettangolare o rettangolo arrotondato) parametrico.
 * [[Image:Macro_Draft_Circle_3_Points.png|16px]] Macro_Draft_Circle_3_Points: crea un cerchio passante per 3 punti selezionati, i punti possono anche essere degli oggetti.

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

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: Questa macro permette di sovrapporre temporaneamente una immagine di texture sugli oggetti selezionati.

Assistenti

 * Macro Automatic drawing: Consente all'utente di ottenere la visualizzazione di un oggetto in un disegno in 4 diverse posizioni (frontale, superiore, iso e da destra). 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.

Utilità

 * Macro MessageBox: Mostra come fornire informazioni all'utente attraverso l'interfaccia utente grafica GUI.

Come utilizzarle
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: Mia macro eccellente" . L'operazione crea una nuova pagina (link rosso).
 * Nella pagina appena creata, incollare il seguente testo:
 * 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.
 * Volendo, è possibile caricare una icona in formato .Png con lo stesso nome della macro (es. Macro_My_Excellent_Macro.png)
 * Text-x-python [[Image:Text-x-python.png|32px]] è l'icona predefinita per la pagina dedicata alle Macro.
 * 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.