Macros recipes/it

=Esempi di macro=

Questa pagina contiene delle 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.

Transformare oggetti

 * Macro ArrayCopy: Copia diverse volte l'oggetto selezionato, in 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 tutte le associazioni parametriche da un oggetto, lasciandolo come una forma "muta"
 * Macro SuperWire: Forza la creazione di una polilinea partendo da linee e archi non necessariamente contigui. Da utilizzare quando l'operazione polilinea normale 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 da 90° a sinistra. Funziona solo se si è in vista dall'alto.
 * Macro View Rotation: Fornisce un'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 un immagine di texture agli 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, 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, 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 macro selezionandole nella categoria "Macro".

Aggiungere nuove macro a questo repository

 * Creare una nuova pagina, iniziare il suo nome 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, caricare una icona di file .Png con lo stesso nome della pagina macro (es. Macro_My_Excellent_Macro.png)
 * Opzionalmente è possibile aggiungere ancora delle informazioni su come utilizzare la macro, consigli, limitazioni e trucchi.
 * Aggiungerla alle categorie di cui sopra, oppure creare una nuova categoria, se necessario.