How to install macros/it

Descrizione
Questo pagina è una breve guida su come installare le macro e utlizzarle in FreeCAD.

Since v0.17 it is easy to add macros by using the Addon Manager. A regular user doesn't need to do more than use this tool. Keep reading for more information regarding installation of macros.

Le macro sono sequenze di comandi che vengono utilizzati per eseguire un'operazione complessa. Le macro sono degli script Python, il che significa che sono file di testo che possono essere scritti e modificati con un editor di testo.

Sebbene gli script Python abbiano normalmente l'estensione, le macro di FreeCAD dovrebbero avere l'estensione. Una raccolta di macro scritte da utenti esperti si trova nella pagina Raccolta di macro.

Vedere la pagina Introduzione a Python per conoscere il linguaggio di programmazione Python e poi le pagine Guida agli script Python e Script di base per FreeCAD per imparare a scrivere delle macro.

Questo è un video su come installare le macro in FreeCAD in Ubuntu.

Barra degli strumenti

 * [[Image:Macro-record.svg|32px|record]] Registra
 * [[Image:Macro-stop.svg|32px|stop]] Stop
 * [[Image:Std_DlgMacroExecuteDirect.svg|32px|open editor]] Finestra di dialogo Esegui la macro
 * [[Image:Macro-execute.svg|32px|execute]] Esegui

Menu
Oltre agli strumenti nella barra degli strumenti, nel menu sono disponibili anche le seguenti funzioni.
 * [[Image:Debug-start.svg|32px|start]] Avvia il debug
 * [[Image:Debug-stop.svg|32px|stop]] Interrompi il debug
 * Passo succesivo
 * Un passo
 * Attiva/Disattiva punto di interruzione

Directory delle macro
Le macro vengono create in una cartella specifica nella directory di FreeCAD dell'utente. Questa directory può essere configurata nel dialogo Esegui macro, o nel Editor delle preferenze, attraverso il menu.

Anche le macro scaricate dovrebbero essere collocate in questa directory.

Directory di default
Le macro possono essere semplicemente copiate in

dove è una directory di primo livello ricercata da FreeCAD all'avvio.

La può essere una directory di sistema, nel qual caso la macro viene installata per tutti gli utenti.
 * Di solito in Linux è
 * Di solito in Windows è
 * Di solito in Mac OSX è

La può essere la directory di un utente particolare.
 * Su Linux di solito è
 * Su Windows di solito è
 * Su Mac OSX di solito è

Configurazione della directory utente
1. Aprire il menu per aprire la finestra di dialogo Esegui la macro.



2. Impostare l'appropriata.
 * Linux: generalmente
 * Windows: generalmente
 * MacOS: generalmente



3. Passare a quella directory sul proprio computer.
 * Linux: incollare l'indirizzo nel file manager, "Nautilus" o altro. Potrebbe essere necessario premere +  per rendere visibile la directory nascosta.
 * Windows: incollare l'indirizzo nel "File explorer" e confermare.
 * MacOS: individuare la cartella in "Finder" o incollare l'indirizzo in un "File explorer"; ricordare il prefisso nel "File explorer" per un file su disco.



4. Aggiungere il file macro a questa directory.
 * Linux: lasciare aperto il file manager e aggiungere il segnalibro alla posizione per un accesso più rapido.
 * Windows: lasciare aperto il file explorer.
 * MacOS: lasciare una finestra "Finder" aperta, o aggiungere un segnalibro alla posizione nel "File explorer", oppure impostare un "Alias" per puntare ad esso, o trascinare la cartella nella "SideBar" del "Finder" così è disponibile per altri programmi di editor di testo.



Metodo automatico
A partire da FreeCAD 0.17, utilizzare Addon Manager in per installare una macro che è stata inclusa nel repository FreeCAD-macros.

Nelle versioni precedenti di FreeCAD è possibile utilizzare due metodi automatici per installare macro e altri componenti aggiuntivi:
 * addons_installer.FCMacro: è essa stessa una macro, è il precursore del Gestore Addon ed è ospitato nel repository FreeCAD-addons. Non è necessario utilizzare questo strumento nelle recenti versioni di FreeCAD.
 * freecad-pluginloader: è anche una macro, potrebbe essere usata per installare nuovi componenti in FreeCAD. Non è più sviluppato.

Il metodo consigliato per installare i componenti aggiuntivi, ovvero gli ambienti esterni e le macro, è Addon Manager. Tuttavia, è ancora possibile aggiungere delle macro al prorpio sistema con i metodi manuali descritti nelle seguenti sezioni; questo è utile per sviluppare e testare il proprio codice.

Metodo manuale 1. Copiare il codice nell'editor delle macro
Per delle macro che sono relativamente piccole, 300 righe o meno, il codice può essere copiato e incollato direttamente nell'editor macro di FreeCAD.

Noi useremo come esempio la macro Prisma da apotema.

1. Andare alla pagina wiki della macro, che dovrebbe essere elencata in Raccolta di macro.

Se ci sono delle icone, per scaricarle, posizionare il mouse sopra l'icona, fare clic sul pulsante destro del mouse e cliccare su. Le icone devono essere inserite nella directory delle macro e una di esse può essere usata come icona scorciatoia nella barra degli strumenti personalizzata. L'icona di deafault è.



2. Nella pagina delle macro, selezionare il codice all'interno della sezione o, e copiarlo.

3. In FreeCAD, aprire il menu per aprire la finestra di dialogo Esegui la macro.



4. Cliccare.



5. Inserire il nome della macro, in questo caso, e premere.



6. L'editor delle macro si apre e mostra il percorso completo della nuova macro.



7. Incollare il codice nella finestra dell'editor delle macro e fare clic sulla croce per chiudere la finestra.



8. Viene visualizzata una finestra che richiede una conferma per salvare il codice; cliccare su. Si può anche usare + per salvare il file.

Riavviare FreeCAD per registrare correttamente la nuova macro.



9. Aprire di nuovo il menu,, selezionare la nuova macro e premere.



10. La macro si avvia, compilare i campi dei valori e fare clic sul pulsante



11. Questa macro dovrebbe restituire un errore se non è attivo nessun documento; altre macro aprono un nuovo documento se non ne esiste nessuno.

Creare un nuovo documento con, e quindi ripetere i passaggi precedenti per eseguire la macro.



12. Quando è disponibile un documento attivo, la macro viene eseguita e crea un oggetto.



13. È possibile aprire nuovamente la macro nell'editor per eseguirla o modificarla. Andare in, selezionar la macro e premi ere.



14. Ora è possibile eseguire la macro con, o facendo clic sul pulsante della barra degli strumenti.



Metodo manuale 2. Aggiungere una macro compressa in un file .zip
Alcune macro sono troppo grandi per cui è scomodo copiarle e incollarle nell'editor delle macro o non possono essere ospitate nel wiki. In questo caso, il codice può essere ospitato altrove, in un repository Github o nelforum di FreeCAD. Il codice può anche essere compresso in un file, tarball o altro tipo di archivio se contiene più file. Se il codice viene distribuito in questo modo, l'archivio deve essere estratto e i file inseriti nella directory delle macro.

Come esempio useremo la Macro screw maker.

1. Scaricare il codice compresso dal forum, Screw Maker.

È necessario utilizzare un decompressore per ottenere i file interni.
 * Per Windows si può usare un'applicazione come 7-zip o L-Zarc o quickzip.
 * Per Linux è possibile utilizzare un comando dal terminale

2. Scaricare l'archivio compresso con il codice della macro in una cartella locale.



3. Decomprimere il file all'interno della cartella.



4. Il decompressore ha finito il suo lavoro e ha creato una nuova cartella contenente il file scompattato



5. Entrare nella nuova directory e copiare o tagliare il file della macro.



6. Andare alla directory macro e incollare lì il file.



7. In FreeCAD, aprire il menu per aprire il dialogo Esegui macro.



8. Selezionare la nuova macro e premere.



9. La macro ora viene eseguita. Selezionare le opzioni desiderate e fare clic su.





Eseguire una macro nella riga di comando
Riga di comando per eseguire una macro (.FCMacro o .py)

in Windows

in Linux

Errori di indentazione
Lo spazio bianco all'inizio delle righe (indentazione) nel linguaggio di programmazione Python è molto importante e fa parte integrante del codice. Uno spazio inappropriato può causare la mancata esecuzione del codice o la presenza di errori.

Questa sezione descrive alcuni errori che possono verificarsi durante il copia e incolla o la scrittura di codice macro.

Un tipico errore di indentazione è simile al seguente:

Esempio 1
Se il codice non presenta alcuna indentazione, il codice non funzionerà. Class e definizioni delle funzioni, nonché le strutture di controllo  devono essere seguite da un blocco di codice rientrato.

Questo errore è possibile se l'utente non copia correttamente il codice e tutti gli spazi vengono rimossi accidentalmente.



Problema di indentazione risolto.



Se il codice è selezionato, tutte le linee dovrebbero essere evidenziate fino al bordo sinistro, indicando che le linee sono allineate.



Esempio 2
Se viene introdotto uno spazio aggiuntivo all'inizio di tutte le righe, l'interprete Python fallisce e si lamenta delle indentazioni non necessarie. In questo caso, lo spazio iniziale deve essere rimosso da tutte le righe.



Esempio 3
Qui il codice è stato copiato da un thread del forum utilizzando il pulsante. Apparentemente la selezione è buona.



Tuttavia, quando la selezione viene incollata nell'editor delle macro, sembra apparire una indentazione indesiderata.



In questo caso, è necessario rimuovere gli spazi iniziali. Questo può essere fatto con un editor di testo specializzato per ridurre rapidamente l'indentazione delle righe.

In Windows, con Notepad++ si può eseguire la selezione con + trascinamento del mouse, quindi utilizzare.



Esempio 4
In questa selezione sono inclusi anche i numeri di riga. Se questa selezione viene incollata nell'editor delle macro, non funziona. Tutti i numeri di riga devono essere rimossi e gli spazi devono essere regolati in modo che il codice Python abbia l'indentazione corretta.



Nessun output di testo dalle macro
Le macro possono generare informazioni nella vista report per descrivere cosa sta facendo il codice quando è in esecuzione.

Se non viene visualizzata alcuna informazione, assicurarsi che la vista report e la console Python siano visibili e che l'output sia diretto alla vista report.

Visualizzare le informazioni
Le macro di FreeCAD hanno due metodi per stampare le informazioni nella vista report.

Le funzioni di FreeCAD

La semplice funzione Python

Abilitare la vista report
Per vedere le informazioni visualizzate nella console è necessario:

1. Andare nel menu.





2. Abilitare la e la.



3. Ora i pannelli sono visibili e i comandi come ora stampano le informazioni che appaiono nella.



Abilitare il comando print
Potrebbe essere necessario configurare FreeCAD in modo che la funzione di Python reindirizzi correttamente il suo output alla vista Report.

1. Andare nell'editor delle preferenze con il menu.



2. Andare nella sezione, e poi.



3. Attivare entrambe le caselle:

Reindirizzare l'output interno di Python nella vista report

Reindirizzare gli errori interni di Python alla finestra di report

e poi cliccare sul pulsante