Workbench creation/de

Introduction
Diese Seite zeigt dir, wie du einen neuen Arbeitbereich zur FreeCAD Oberfläche hinzufügst. Arbeitbereiche sind Behälter für FreeCAD Befehle. Sie können in Python, in C++ oder in einer Mischung aus beidem programmiert werden, was den Vorteil hat, die Geschwindigkeit von C++ mit der Flexibilität von Python zu verbinden. In allen Fällen wird dein Arbeitsbereich jedoch durch einen Satz von zwei Pythondateien gestartet.

Die Arbeitsbereichsstruktur
Im Grunde ist es einfach: Du benötigst einen Ordner mit einem beliebigen Namen im Mod Verzeichnis, mit einer Init.py Datei und, optional, einer InitGui.py Datei. Die Init Datei wird immer beim Start von FreeCAD ausgeführt, und die InitGui.py Datei wird unmittelbar danach ausgeführt, aber nur, wenn FreeCAD im GUI Modus und nicht im Konsolenmodus gestartet wird. Das ist alles, was FreeCAD braucht, um deinen Arbeitsbereich beim Start zu finden und in seine Oberfläche einzufügen.

The user Mod directory is a sub-directory of the user application data directory (you can find the latter by typing in the Python console):
 * On Linux it is usually.
 * On Windows it is, which is usually.
 * On macOS it is usually.

The Mod directory should look like this:

Innerhalb dieser Dateien kannst du tun, was immer du willst. Normalerweise werden sie so verwendet:


 * In der Datei Init.py fügst du einfach ein paar Dinge hinzu, die auch dann verwendet werden, wenn FreeCAD im Konsolenmodus arbeitet, z.B. die Datei Importeure und -Exporteure


 * In der Datei InitGui.py definierst du normalerweise einen Arbeitsbereich, der einen Namen, ein Symbol und eine Reihe von FreeCAD Befehlen enthält (siehe unten). Dieser Arbeitsbereich definiert auch Funktionen, die ausgeführt werden, wenn FreeCAD geladen wird (Du versuchst, dort so wenig wie möglich zu tun, um den Start nicht zu verlangsamen), eine weitere, die ausgeführt wird, wenn der Arbeitsbereich aktiviert ist (dort wirst Du die meiste Arbeit erledigen), und eine dritte, wenn der Arbeitsbereich deaktiviert ist (damit Du Dinge, wenn nötig, entfernen kannst).

C++ Arbeitsbereichsstruktur
Wenn du deinen Arbeitsbereich in Python programmieren willst, brauchst du keine besondere Vorsicht walten zu lassen und kannst einfach deine anderen Python Dateien zusammen mit deinen Init.py und InitGui.py Dateien unterbringen. Wenn du jedoch mit C++ arbeitest, solltest du größere Sorgfalt walten lassen und damit beginnen, eine grundlegende Regel von FreeCAD zu beachten: Die Trennung deines Arbeitsbereichs zwischen einem Anwendungsteil (der im Konsolenmodus laufen kann, ohne jedes GUI Element) und einem Gui Teil, der nur geladen wird, wenn FreeCAD mit seiner vollständigen GUI Umgebung läuft. Wenn du also einen C++ Arbeitsbereich verwendest, wirst du höchstwahrscheinlich zwei Module verwenden, eine Anwendung und eine Gui. Diese beiden Module müssen natürlich von Python aus aufrufbar sein. Jedes FreeCAD Modul (Anwendung oder Gui) besteht mindestens aus einer Modul Init Datei. Dies ist eine typische AppMyModuleGui.cpp Datei:

Die Init.py Datei
Du kannst jede beliebige Lizenz für deinen Arbeitsbereich wählen, aber sei dir bewusst, dass, wenn du deinen Arbeitsbereich irgendwann in den FreeCAD Quellcode integrierst und mit diesem verteilt sehen möchtest, diese wie im obigen Beispiel unter LGPL2+ stehen muss. Siehe Lizenz.

Die und  Funktionen ermöglichen es dir, den Namen und die Erweiterung eines Dateityps sowie ein für seinen Import verantwortliches Python Modul anzugeben. Im obigen Beispiel wird ein Modul  Dateien handhaben. Siehe Codeschnipsel für weitere Beispiele.

Python Arbeitsbereiche
Ansonsten kannst du alles tun, was du willst: Du kannst deinen gesamten Arbeitsbereichscode in die InitGui.py setzen, wenn du möchtest, aber es ist normalerweise bequemer, die verschiedenen Funktionen deines Arbeitsbereichs in separaten Dateien zu platzieren. Deshalb sind diese Dateien kleiner und einfacher zu lesen. Dann importierst du diese Dateien in deine InitGui.py Datei. Du kannst diese Dateien anordnen wie du willst, ein gutes Beispiel ist eine für jeden FreeCAD Befehl, den du hinzufügst.

Einstellungen
Du kannst eine Einstellungsseite für deinen Python Arbeitsbereich hinzufügen. Die Einstellungsseiten suchen nach einem Einstellungssymbol mit einem bestimmten Namen im Qt Ressourcesystem. Wenn sich dein Symbol nicht im Ressourcensystem befindet oder nicht den korrekten Namen hat, wird dein Symbol nicht auf der Voreinstellungsseite erscheinen.

Hinzufügen deines Arbeitsbereichssymbols:
 * das Einstellungssymbol muss "preferences-" genannt werden + "modulename" + ".svg" (alles Kleinbuchstaben)
 * erstelle eine qrc Datei, die alle Symbolnamen enthält
 * Führe im Haupt *.py Verzeichnis pyside-rcc -o myResources.py myqrc.qrc aus
 * In InitGui.py, füge import myResource(.py) hinzu
 * aktualisiere dein Repositorium (git) mit myResources.py und myqrc.qrc

Wenn du Symbole hinzufügst/änderst, musst du die Schritte erneut ausführen.

@kbwbe hat ein nettes Skript zum Kompilieren von Ressourcen für den A2Plus Arbeitsbereich erstellt. Siehe unten.

Hinzufügen deiner Einstellungsseite(n):
 * Du musst das Qt Designer Zusatzmodul kompilieren, das dir das Hinzufügen von von Präferenzeinstellungen mit Qt Designer ermöglicht
 * Erstelle ein leeres Widget im Qt Designer (keine Schaltflächen oder ähnliches)
 * Gestalte deine Präferenzseite, jede Einstellung, die gespeichert werden muss (Präferenzen), muss eines der Gui::Pref* Widgets sein, die durch das ZUsatzmodul hinzugefügt wurden)
 * Stelle sicher, dass du in einem dieser Felder den PrefName (den Namen deines Präferenzwertes) und PrefPath (ex: Mod/MyWorkbenchName), der deine Werte unter BaseApp/Preferences/Mod/MyWorkbebchName speichern wird
 * Speichere die ui Datei in deinem Arbeitsbereich, stelle sicher, dass sie von cmake gehandhabt wird
 * In deinem Arbeitsbereich, für ex. innerhalb der InitGui Datei, innerhalb der Initialisierungsmethode (aber jeder andere Ort funktioniert auch), füge: FreeCADGui.addPreferencePage("/path/to/myUiFile.ui","MyGroup"), "MyGroup" als eine der Präferenzgruppen auf der linken Seite. FreeCAD sucht automatisch nach einer "preferences-mygroup.svg" Datei an ihren bekannten Speicherorten (die du mit FreeCADGui.addIconPath erweitern kannst)
 * Stelle sicher, dass die Methode addPreferencePage nur einmal aufgerufen wird, andernfalls wird deine Vorzugsseite mehrmals hinzugefügt

C++ Arbeitsbereiche
Wenn du deinen Arbeitsbereich in C++ programmierst, wirst du wahrscheinlich die Arbeitsbereichsdefinition selbst auch in C++ programmieren (obwohl es nicht notwendig ist: Du könntest auch nur die Werkzeuge in C++ programmieren und die Arbeitsbereichsdefinition in Python belassen). In diesem Fall, wird die Datei InitGui.py sehr einfach: Sie könnte nur eine Zeile enthalten:

wobei MyModule dein vollständiger C++ Arbeitsbereich ist, der die Befehle und Arbeitsbereichsdefinition einschließt.

Die Programmierung von C++ Arbeitsbereichen funktioniert auf ziemlich ähnliche Weise. Dies ist eine typische Workbench.cpp Datei, die du in den Gui Teil deines Moduls aufnehmen kannst:

Einstellungen
Du kannst auch eine Voreinstellungsseite für C++ Arbeitsbereiche hinzufügen. Die Schritte sind ähnlich wie die für Python.

FreeCAD Befehle
FreeCAD Befehle sind die Grundbausteine des FreeCAD Interface. Sie können als Knöpfe in Werkzeugleisten und als Einträge in Menüs erscheinen. Es handelt sich dabei immer um den selben Befehl. Ein Befehl ist einfach eine Python Klasse, die eine Reihe von vordefinierten Attributen und Funktionen enthält, wie der Befehlsname, das Symbol und der Code, der ausgeführt wird, wenn der Befehl aktiviert wird.

C++ Befehlsdefinition
In ähnlicher Weise kannst du deine Befehle in C++ programmieren, normalerweise hast du eine Commands.cpp Datei in deinem Gui Modul. Dies ist eine typische Commands.cpp Datei:

"Kompilieren" deiner Ressourcendatei
compileA2pResources.py aus dem A2Plus Arbeitsbereich: