Comandi dell'interfaccia grafica
I comandi dell'interfaccia grafica utente (GuiCommand) sono una delle funzioni più importanti di FreeCAD in quanto principale metodo di interazione dell'utente. Ogni volta che l'utente seleziona una voce di menu o preme un pulsante della barra degli strumenti, attiva un GuiCommand. Alcuni degli attributi della GuiCommand sonoː
- Definisce un nome
- Contiene una icona
- Definisce la possibilità di annullare/ripetere
- Ha una pagina di aiuto
- Apre e controlla le finestre di dialogo
- Registra macro
- etc...
Nome del comando
Il GuiCommand è denominato in modo standard: ModuleName_CommandName ad esempio, "Base_Open" questo è il comando Open Gui nel sistema Base. Il GuiCommand in un determinato modulo è denominato con il nome del modulo in primo piano, ad esempio "Part_Cylinder".
Se la sua documentazione non è completa usare la maschera Template:UnfinishedDocu (en) - Documentazione incompleta (it).
Pagina di aiuto
Ogni GuiCommand deve avere una pagina di aiuto. La pagina di aiuto è ospitata sul wiki della documentazione di FreeCAD. L'articolo ha lo stesso nome del GuiCommand, es. Draft ShapeString.
Per creare le proprie pagine di aiuto si può utilizzare il modello GuiCommand model (en) - Modello di comando Gui (it)
Esempi in italiano:
Esempi in inglese:
Icone
Ogni comando dell'interfaccia grafica deve avere un'icona. Utilizziamo il Set di icone Tango e le sue linee guida. Sul lato destro si vede la tavolozza dei colori Tango.
Tutte le icone devono essere create in formato SVG con un'applicazione per immagini vettoriali, come Inkscape. Ciò semplifica l'applicazione delle modifiche e la derivazione di icone aggiuntive nello stesso spazio dell'applicazione.
Tabella di codifica colori delle icone
Cerchiamo di rispettare quanto più possibile questo schema, in modo che il colore delle icone abbia un preciso significato.
Power user documentation
- 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