Macros/it: Difference between revisions
Renatorivo (talk | contribs) (Created page with "Eseguire automaticamente una macro all'avvio.") |
No edit summary |
||
(60 intermediate revisions by 5 users not shown) | |||
Line 1: | Line 1: | ||
<languages/> |
<languages/> |
||
{{docnav/it|[[Standard Menu/it|I menu standard]]|[[Introduction to Python/it|Introduzione a Python]]}} |
|||
{{Docnav |
|||
|[[Scripting_and_macros/it|Script e macro]] |
|||
|[[Scripts/it|Script]] |
|||
}} |
|||
{{TOCright}} |
|||
<span id="Introduction"></span> |
|||
==Introduzione== |
==Introduzione== |
||
Le macro sono un modo pratico per riprodurre delle azioni complesse |
Le macro sono un modo pratico per riprodurre delle azioni complesse in FreeCAd. È sufficiente registrare le azioni così come vengono eseguite, quindi salvare queste azioni con un nome, per poterle ripetere quando si vuole. Dato che le macro sono in realtà un elenco di comandi [[Python/it|Python]], è anche possibile modificarle e creare degli script molto complessi. |
||
Sebbene gli script Python abbiano normalmente l'estensione {{incode|.py}}, le macro di FreeCAD dovrebbero avere l'estensione {{incode|.FCMacro}}. Una raccolta di macro scritte da utenti esperti si trova nella pagina [[ |
Sebbene gli script Python abbiano normalmente l'estensione {{incode|.py}}, le macro di FreeCAD dovrebbero avere l'estensione {{incode|.FCMacro}}. Una raccolta di macro scritte da utenti esperti si trova nella pagina [[macros_recipes/it|raccolta di macro]]. |
||
Vedere |
Vedere l'[[Power_users_hub/it|Hub degli utenti esperti]] per saperne di più sul linguaggio di programmazione [[Python/it|Python]] e sulla scrittura di macro. In particolare, si dovrebbe iniziare con queste pagine: |
||
* [[Introduction_to_Python/it|Introduzione a Python]] |
|||
* [[Python_scripting_tutorial/it|Guida agli Script Python]] |
|||
* [[FreeCAD_Scripting_Basics/it|Script di base per FreeCAD]] |
|||
<span id="How_it_works"></span> |
|||
== Come funzionano == |
== Come funzionano == |
||
Abilitare l'output della console nel menu {{MenuCommand|Modifica → Preferenze → Python → Macro → Mostra lo script dei comandi nella console Python}}. Si noterà che in FreeCAD, ogni azione eseguita, come premere un pulsante, genera un comando Python. Questi comandi possono essere registrati in una macro. Lo strumento principale per creare macro è la barra degli strumenti delle macro: [[Image:Macros_toolbar.jpg]]. Su di esso ci sono 4 pulsanti: Registra una macro, interrompi la registrazione, modifica e riproduci la macro corrente. |
|||
È molto semplice da usare: premere il pulsante di registrazione, dare un nome alla macro, quindi eseguire alcune azioni. Al termine, fare clic sul pulsante Interrompi registrazione, e le azioni compiute vengono salvate. Ora è possibile accedere alla finestra di dialogo delle macro utilizzando il pulsante Modifica, |
È molto semplice da usare: premere il pulsante di registrazione, dare un nome alla macro, quindi eseguire alcune azioni. Al termine, fare clic sul pulsante Interrompi registrazione, e le azioni compiute vengono salvate. Ora è possibile accedere alla finestra di dialogo delle macro utilizzando il pulsante Modifica, |
||
[[Image: |
[[Image:Macros_it.png]] |
||
{{Caption|Finestra di dialogo Macro, che elenca le macro disponibili nel sistema}} |
{{Caption|Finestra di dialogo Macro, che elenca le macro disponibili nel sistema}} |
||
Quì è possibile gestire le macro, eliminarle, duplicarle, installarle, modificarle o crearne di nuove partendo da zero. Quando si modifica una macro, essa viene aperta in una finestra dell'editor in cui è possibile apportare le proprie modifiche al codice. È possibile installare delle nuove macro utilizzando il pulsante {{button|Addons ...}}, che collega al [[ |
Quì è possibile gestire le macro, eliminarle, duplicarle, installarle, modificarle o crearne di nuove partendo da zero. Quando si modifica una macro, essa viene aperta in una finestra dell'editor in cui è possibile apportare le proprie modifiche al codice. È possibile installare delle nuove macro utilizzando il pulsante {{button|Addons ...}}, che collega al [[Std_AddonMgr/it|Addon Manager]]. |
||
<span id="Example"></span> |
|||
== Esempio == |
== Esempio == |
||
⚫ | Premere il pulsante di registrazione, fornire un nome, ad esempio, "cilindro 10x10", poi, nell'[[ |
||
⚫ | Premere il pulsante di registrazione, fornire un nome, ad esempio, "cilindro 10x10", poi, nell'[[Part_Workbench/it|Ambiente Parte]], creare un cilindro con raggio = 10 e altezza = 10. Quindi, premere il pulsante "Interrompi registrazione". Nella finestra di dialogo Modifica macro, è possibile vedere il codice python che è stato registrato, e, volendo, apportarvi delle modifiche. Per eseguire la macro, è sufficiente premere sul pulsante Esegui della barra degli strumenti, mentre la macro è nell'editor. La macro viene sempre salvata su disco, in modo che tutte le modifiche apportate, o ogni nuova macro creata, sono sempre disponibili al successivo avvio di FreeCAD. |
||
<span id="Customizing"></span> |
|||
== Personalizzazione == |
== Personalizzazione == |
||
Naturalmente non è pratico dover caricare una macro nell'editor per poterla utilizzare. FreeCAD fornisce modi migliori per usarle, come ad esempio l'assegnazione ad essa di una scorciatoia da tastiera o l'inserimento di una voce nel menu. Dopo aver creato la macro, tutto questo può essere fatto tramite il menu {{MenuCommand|Strumenti → Personalizza}}. |
Naturalmente non è pratico dover caricare una macro nell'editor per poterla utilizzare. FreeCAD fornisce modi migliori per usarle, come ad esempio l'assegnazione ad essa di una scorciatoia da tastiera o l'inserimento di una voce nel menu. Dopo aver creato la macro, tutto questo può essere fatto tramite il menu {{MenuCommand|Strumenti → Personalizza}}. |
||
[[Image: |
[[Image:Macros_config_it.png]] |
||
In questo modo si può trasformare la macro in un vero strumento, proprio come qualsiasi strumento standard di FreeCAD. Questo, aggiunto alla potenza dello scripting Python all'interno di FreeCAD, rende possibile aggiungere facilmente i propri strumenti all'interfaccia. |
|||
Vedi [[Customize_Toolbars/it|Personalizza le barre degli strumenti]] per una descrizione più dettagliata. |
|||
<span id="Creating_macros_without_recording"></span> |
|||
== Creare delle macro senza registrarle == |
== Creare delle macro senza registrarle == |
||
⚫ | |||
⚫ | Puoi anche copiare/incollare direttamente il codice Python in una macro, senza registrare l'azione della GUI. Basta creare una nuova macro, modificarla e incollare il codice. È quindi possibile salvare la macro nello stesso modo in cui si salva un documento di FreeCAD. La prossima volta che avvierai FreeCAD, la macro apparirà sotto la voce "Macro..." del menu Macro. |
||
Vedere [[How_to_install_macros/it|Come installare le macro]] per una descrizione più dettagliata. |
|||
<span id="Macro_repositories"></span> |
|||
== Repositorio di macro == |
== Repositorio di macro == |
||
Visitare la pagina degli [[Macros recipes/it|esempi di macro]] per trovare alcune utili macro da aggiungere alla propria installazione di FreeCAD. |
|||
Ci sono due posti principali per le macro. Il primo è il repository di macro ufficiale sottoposto a revisione paritaria su [https://github.com/FreeCAD/FreeCAD-macros GitHub]. La seconda è la pagina [[Macros_recipes/it|Raccolta di macro]] da cui puoi scegliere alcune utili macro da aggiungere alla tua installazione di FreeCAD. Le macro di entrambi i repository possono essere installate tramite [[Std_AddonMgr/it|Addon Manager]] direttamente da FreeCAD. |
|||
==Link== |
|||
⚫ | |||
<span id="Additional_information"></span> |
|||
== Informazioni aggiuntive == |
|||
[[Macro_at_Startup/it|Eseguire automaticamente una macro all'avvio]] |
* [[Macro_at_Startup/it|Eseguire automaticamente una macro all'avvio]] |
||
⚫ | |||
<span id="Tutorials"></span> |
|||
==Tutorial== |
==Tutorial== |
||
⚫ | |||
È possibile installare manualmente le estensioni, tuttavia è molto più semplice utilizzare semplicemente l'[[Std_AddonMgr/it|Addon Manager]]. |
|||
{{docnav/it|[[Standard Menu/it|I menu standard]]|[[Introduction to Python/it|Introduzione a Python]]}} |
|||
* [[How_to_install_macros/it|Come installare le macro]] |
|||
⚫ | |||
{{Userdocnavi/it}} |
|||
{{Docnav |
|||
⚫ | |||
|[[Scripting_and_macros/it|Script e macro]] |
|||
|[[Scripts/it|Script]] |
|||
}} |
|||
{{Powerdocnavi{{#translation:}}}} |
|||
{{clear}} |
|||
⚫ | |||
[[Category:Python Code{{#translation:}}]] |
|||
[[Category:Macros{{#translation:}}]] |
Latest revision as of 06:43, 10 August 2023
Introduzione
Le macro sono un modo pratico per riprodurre delle azioni complesse in FreeCAd. È sufficiente registrare le azioni così come vengono eseguite, quindi salvare queste azioni con un nome, per poterle ripetere quando si vuole. Dato che le macro sono in realtà un elenco di comandi Python, è anche possibile modificarle e creare degli script molto complessi.
Sebbene gli script Python abbiano normalmente l'estensione .py
, le macro di FreeCAD dovrebbero avere l'estensione .FCMacro
. Una raccolta di macro scritte da utenti esperti si trova nella pagina raccolta di macro.
Vedere l'Hub degli utenti esperti per saperne di più sul linguaggio di programmazione Python e sulla scrittura di macro. In particolare, si dovrebbe iniziare con queste pagine:
Come funzionano
Abilitare l'output della console nel menu Modifica → Preferenze → Python → Macro → Mostra lo script dei comandi nella console Python. Si noterà che in FreeCAD, ogni azione eseguita, come premere un pulsante, genera un comando Python. Questi comandi possono essere registrati in una macro. Lo strumento principale per creare macro è la barra degli strumenti delle macro: . Su di esso ci sono 4 pulsanti: Registra una macro, interrompi la registrazione, modifica e riproduci la macro corrente.
È molto semplice da usare: premere il pulsante di registrazione, dare un nome alla macro, quindi eseguire alcune azioni. Al termine, fare clic sul pulsante Interrompi registrazione, e le azioni compiute vengono salvate. Ora è possibile accedere alla finestra di dialogo delle macro utilizzando il pulsante Modifica,
Finestra di dialogo Macro, che elenca le macro disponibili nel sistema
Quì è possibile gestire le macro, eliminarle, duplicarle, installarle, modificarle o crearne di nuove partendo da zero. Quando si modifica una macro, essa viene aperta in una finestra dell'editor in cui è possibile apportare le proprie modifiche al codice. È possibile installare delle nuove macro utilizzando il pulsante Addons ..., che collega al Addon Manager.
Esempio
Premere il pulsante di registrazione, fornire un nome, ad esempio, "cilindro 10x10", poi, nell'Ambiente Parte, creare un cilindro con raggio = 10 e altezza = 10. Quindi, premere il pulsante "Interrompi registrazione". Nella finestra di dialogo Modifica macro, è possibile vedere il codice python che è stato registrato, e, volendo, apportarvi delle modifiche. Per eseguire la macro, è sufficiente premere sul pulsante Esegui della barra degli strumenti, mentre la macro è nell'editor. La macro viene sempre salvata su disco, in modo che tutte le modifiche apportate, o ogni nuova macro creata, sono sempre disponibili al successivo avvio di FreeCAD.
Personalizzazione
Naturalmente non è pratico dover caricare una macro nell'editor per poterla utilizzare. FreeCAD fornisce modi migliori per usarle, come ad esempio l'assegnazione ad essa di una scorciatoia da tastiera o l'inserimento di una voce nel menu. Dopo aver creato la macro, tutto questo può essere fatto tramite il menu Strumenti → Personalizza.
In questo modo si può trasformare la macro in un vero strumento, proprio come qualsiasi strumento standard di FreeCAD. Questo, aggiunto alla potenza dello scripting Python all'interno di FreeCAD, rende possibile aggiungere facilmente i propri strumenti all'interfaccia.
Vedi Personalizza le barre degli strumenti per una descrizione più dettagliata.
Creare delle macro senza registrarle
Puoi anche copiare/incollare direttamente il codice Python in una macro, senza registrare l'azione della GUI. Basta creare una nuova macro, modificarla e incollare il codice. È quindi possibile salvare la macro nello stesso modo in cui si salva un documento di FreeCAD. La prossima volta che avvierai FreeCAD, la macro apparirà sotto la voce "Macro..." del menu Macro.
Vedere Come installare le macro per una descrizione più dettagliata.
Repositorio di macro
Ci sono due posti principali per le macro. Il primo è il repository di macro ufficiale sottoposto a revisione paritaria su GitHub. La seconda è la pagina Raccolta di macro da cui puoi scegliere alcune utili macro da aggiungere alla tua installazione di FreeCAD. Le macro di entrambi i repository possono essere installate tramite Addon Manager direttamente da FreeCAD.
Informazioni aggiuntive
Tutorial
È possibile installare manualmente le estensioni, tuttavia è molto più semplice utilizzare semplicemente l'Addon Manager.
- FreeCAD scripting: Python, Introduction to Python, Python scripting tutorial, FreeCAD Scripting Basics
- Modules: Builtin modules, Units, Quantity
- Workbenches: Workbench creation, Gui Commands, Commands, Installing more workbenches
- Meshes and Parts: Mesh Scripting, Topological data scripting, Mesh to Part, PythonOCC
- Parametric objects: Scripted objects, Viewproviders (Custom icon in tree view)
- Scenegraph: Coin (Inventor) scenegraph, Pivy
- Graphical interface: Interface creation, Interface creation completely in Python (1, 2, 3, 4, 5), PySide, PySide examples beginner, intermediate, advanced
- Macros: Macros, How to install macros
- Embedding: Embedding FreeCAD, Embedding FreeCADGui
- Other: Expressions, Code snippets, Line drawing function, FreeCAD vector math library (deprecated)
- Hubs: User hub, Power users hub, Developer hub