Scripting und Core API

Sie können 3DСoat-Funktionen mithilfe von Skripten verwalten.
Führen Sie neue Befehle aus oder erstellen Sie sie mithilfe von Skripten oder kompilieren Sie sie, indem Sie auf die Core API zugreifen.

Der Anfang ist ganz einfach. Verwenden Sie einfach das Menü „Skripte“ → „Ihr Skript erstellen “ oder „Neues Core -API- Skript erstellen“ .

Skriptmenü

– Scripting ist eine Reihe von Befehlen, die ohne Kompilierung ausgeführt werden können.
Wenn wir ein Werkzeug auswählen oder eine Funktion ausführen, führen wir einen bereits im Programm enthaltenen Befehl aus. Durch die Erstellung eines Skripts können wir diese Befehle kombinieren, um automatisch eine Reihe von Schritten auszuführen, die unsere Arbeit beschleunigen.

– Bei der Kern -API (Application Programming Interface) handelt es sich nicht nur um die Skripterstellung; Der von Ihnen geschriebene Code läuft mit der vollen Geschwindigkeit von kompiliertem C++.
Es handelt sich um eine leistungsstarke Methode zur Erweiterung der Funktionalität von 3DCoat. Sie können den Job automatisieren oder grundsätzlich neue Tools hinzufügen.

Scripting

3DCoat verwendetAngelScript , eine C++-ähnliche Sprache. Das Skript ist eine Textdatei mit Befehlen, die in einer persönlichen Reihenfolge ausgeführt werden.

Dieser Befehl kann erkannt werden, indem man ihn im Speicher aufzeichnet, indem man gleichzeitig die Funktion RMB+MMB drückt. Wenn wir einen Notizblock öffnen und einfügen, erhalten wir den Text des entsprechenden Befehls. Es ist hilfreich, es in Notepad++ anzuzeigen und zu bearbeiten (wählen Sie „C“-Syntax). Anschließend führen Sie das Skript über das Dateimenü „Skripte / Skript ausführen“ aus.

Core API

Die Core API ist eine leistungsstarke Methode zur Erweiterung der Funktionalität von 3DCoat. Sie können den Job automatisieren oder grundsätzlich neue Tools hinzufügen.
Dabei handelt es sich nicht nur um die Skripterstellung; Der von Ihnen geschriebene Code läuft mit der vollen Geschwindigkeit von kompiliertem C++.

Das Core API Skript ist ein kompatibles C++17-Programm, das mit der vollen nativen C++-Geschwindigkeit arbeitet. Dies ist weit mehr als nur ein Skript; Sie können sogar zeitkritische und Multithread-Aufgaben durchführen und 3DCoat umfassend anpassen, wodurch grundsätzlich neue Funktionen und Tools entstehen.

Der gesamte Prozess ist für Sie jedoch völlig transparent. Sie müssen nichts konfigurieren oder komplexe Projektkonfigurationen verwalten. 3DCoat führt Sie mit einem einfachen Assistenten durch den gesamten Prozess.

* Die Core API funktioniert für Benutzer mit nicht-englischen Benutzernamen korrekt. Der gesamte Installationsprozess ist jetzt super einfach.

* Der CoreAPI-Kompilierungsprozess hat sich grundlegend geändert. Jetzt wird nur noch Visual Studio verwendet; Kein Clang-Cl nötig. Es vereinfacht die Nutzung, da Sie nur noch eine zusätzliche Software installieren müssen und nicht wie bisher zwei. Der Download- und Installationsprozess ist vollständig automatisiert.

* Core API unterstützt auch farbige Voxel.

---

Python-API

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.

---

Wie fange ich an?

Der Anfang ist ganz einfach. Verwenden Sie einfach Skripte→Neues Core API Skript erstellen
Wählen Sie dann die Vorlage und einen Pfad für Ihr Projekt aus.

Wenn Visual Studio (oder Visual Studio Code) installiert ist, wird es mit Ihrer neuen Datei gestartet. Jedes Beispiel ist gut dokumentiert und verwendet eine relativ einfache Syntax, sodass es von einfach bis komplex leicht zu verstehen ist.

 Sie müssen in VStudio keine Standardsyntax festlegen.
 Geben Sie einfach Code ein und führen Sie ihn in 3DCoat aus, nicht in Visual Studio.
 VStudio ist dort wie ein Texteditor, der Hinweise und Hilfe beim Codieren anzeigen kann.
 Schreiben Sie Ihren Code in VStudio, speichern Sie die *.cpp-Datei, öffnen Sie sie in 3DC und sie wird automatisch ausgeführt. 

---

Beispiele

Ein Blick auf die Beispiele ist der beste Weg, die API zu verstehen.

Verwenden Sie Skripte→Neues Core API Skript erstellen, um mit diesen Beispielen zu experimentieren.