Beschreibung

Die 3DCoat Python-API soll UI-Befehle auslösen, die Szene bearbeiten und neue Tools erstellen. Es ist der C++ Core API sehr ähnlich, hat aber seine eigenen Vor- und Nachteile.

• Für die Erstellung Ihrer Skripte ist keine zusätzliche Einrichtung erforderlich. Python ist in die 3DCoat Distribution eingebettet.
• Python ist wie ein Schweizer Messer, mit dem Sie die gesamte Leistungsfähigkeit der Python-Bibliotheken in 3DCoat integrieren können.
• Python ist viel langsamer als C++ und kann daher nur für die allgemeine Verwaltung und nicht für tiefgreifende und komplexe Algorithmen verwendet werden.
• Wenn Sie bereits mit der C++- Core API vertraut sind, ist die Python-API sehr ähnlich, fast 1:1, mit der gleichen Logik und den gleichen Funktionsnamen.

Verwendung

• Verwenden Sie Skripte->Python-Skript erstellen , um ein neues Skript zu erstellen. Sie können zunächst eine erste Vorlage auswählen. Die .py-Datei wird in Ihrem aktuellen Editor geöffnet, der mit .py-Dateien verknüpft ist.
• Für den Betrieb verwenden wir eingebettetes Python 3.8.10. Dies ist die letzte Python-Version, die unter Windows 7 ausgeführt werden kann.
• Bei Bedarf können Sie eine Datei namens „requirements.txt“ mit einer Liste der verwendeten Module erstellen; In diesem Fall werden die Module automatisch installiert, bevor das Skript ausgeführt wird.
• Wir empfehlen Visual Studio Code, da es die 3DCoat spezialisierte Befehlssyntax automatisch erkennt und die richtigen Hinweise bietet.
• Achtung: Die Datei „coat.pyi“ im Projektordner ist für die Hinweise zum Coat-Modul in Visual Studio verantwortlich. Sie können diese Datei öffnen, da sie die Liste aller Klassen und Befehle enthält, die zum schnellen Nachschlagen hilfreich sein kann.
• Verwenden Sie Skripte->Python-Konsole anzeigen , um die Konsolenausgabe von Python anzuzeigen. Derzeit ist dies die einzige Möglichkeit, Skripte zu debuggen. Später planen wir, natives Debugging mit Visual Studio Code hinzuzufügen.
• Sie können zusätzliche Module für Python über Scripts->Install Python Modules installieren. Eine andere Möglichkeit besteht darin, „requirements.txt“ im selben Ordner zu verwenden, in dem sich auch die .py-Datei befindet.

Hauptklassen

Allgemeine E/A: coat.io
Dialogverwaltung: coat.dialog
Mesh-Operationen: Coat.Mesh
Szenenwurzeln: coat.Scene
Szenenelement: coat.SceneElement
Volumenverwaltung: Coat.Volume
UI-Verwaltung: coat.ui
2D-Vektoren Mathematik: coat.vec2
3D-Vektoren Mathematik: coat.vec3
4D-Vektoren Mathematik: coat.vec4
3D-Matrix-Mathematik: coat.mat3
4D-Matrix-Mathematik: coat.mat4
Symmetriemanagement: coat.symm