Scripting & Core API

Du kan hantera 3DСoat-funktioner med hjälp av skript.
Kör eller skapa nya kommandon genom att använda skript eller kompilera dem genom att komma åt Core API.

Starten är ganska lätt. Använd bara skriptmenyn → Skapa ditt skript eller skapa ett nytt Core API- skript .

Skriptmeny

– Scripting är en serie kommandon som kan köras utan att kompilera.
När vi väljer ett verktyg eller utför en funktion, kör vi ett kommando som redan finns i programmet. Genom att skapa ett skript kan vi kombinera dessa kommandon för att automatiskt utföra en rad steg som påskyndar vårt arbete.

– Core API (Application Programming Interface) är inte bara skriptet; koden du skriver körs med full hastighet av kompilerad C++.
Det är en kraftfull metod för att utöka 3DCoats funktionalitet. Du kan automatisera jobbet eller lägga till huvudsakligen nya verktyg.

Scripting

3DCoat använderAngelScript , som är ett C++-liknande språk. Skriptet är en textfil med kommandon som körs i en personlig ordning.

Det kommandot kan man känna till genom att spela in det i minnet genom att trycka på funktionen RMB+MMB samtidigt. Genom att öppna ett anteckningsblock och klistra in det får vi texten till motsvarande kommando. Det är användbart att visa och redigera det i Notepad++ (välj “C”-syntax). Kör sedan skriptet via filmenyn “Scripts / Run Script”.

Core API

Core API är en kraftfull metod för att utöka 3DCoats funktionalitet. Du kan automatisera jobbet eller lägga till huvudsakligen nya verktyg.
Detta är inte bara skriptet; koden du skriver körs med full hastighet av kompilerad C++.

Core API script är ett kompatibelt C++17-program som fungerar med full inbyggd C++-hastighet. Detta är mycket mer än bara ett manus; du kan göra till och med tidskritiska och flertrådade uppgifter och anpassa 3DCoat på djupet, skapa i huvudsak nya funktioner och verktyg.

Men hela processen är helt transparent för dig. Du behöver inte konfigurera någonting eller hantera komplexa projektkonfigurationer. 3DCoat kommer att leda dig genom hela processen med en enkel guide.

* Core API fungerar korrekt för användare med icke-engelska användarnamn, hela installationsprocessen är nu superenkel.

* CoreAPI-kompileringsprocessen förändrades väsentligt. Nu används endast Visual Studio ; inget behov av clang-cl. Det förenklar användningen eftersom du bara behöver installera en extra programvara, inte två som tidigare. Nedladdnings- och installationsprocessen är helt automatiserad.

* Core API stöder också färgade voxlar.

---

Python API

3DCoat Python API är avsett att utlösa UI-kommandon, arbeta över scenen och skapa nya verktyg. Det är mycket likt C++ Core API, men har sina egna fördelar och nackdelar.

• Inget behov av ytterligare inställningar för att göra dina skript; Python är inbäddat i 3DCoat -distributionen.
• Python är som en schweizisk kniv, vilket gör att du kan ta med hela kraften hos Python-bibliotek till 3DCoat.
• Python är mycket långsammare än C++, så det kan endast användas för allmän hantering, inte för djupa och komplexa algoritmer.
• Om du redan är bekant med C++ Core API är Python API väldigt likt, nästan 1:1, med samma logik och funktionsnamn.

---

Hur ska man börja?

Starten är ganska lätt. Använd bara Skript→ Skapa nytt Core API -skript
Välj sedan mallen och välj en väg för ditt projekt.

Om Visual Studio (eller Visual Studio Code) är installerat kommer den att börja med din nya fil. Varje exempel är väldokumenterat och använder relativt enkel syntax, så det är lätt att förstå från lätt till komplext.

 Du behöver inte ställa in någon standardsyntax i VStudio.
 Skriv bara kod och kör i 3DCoat, inte i Visual Studio.
 VStudio är precis som en textredigerare där som kan visa tips och hjälp vid kodning.
 Skriv din kod på VStudio och spara *.cpp, öppna den i 3DC och den körs automatiskt. 

---

Exempel

Att titta på exemplen är det bästa sättet att förstå API.

Använd skript→Skapa ett nytt Core API skript för att experimentera med dessa exempel.