Scripting & Core API

Du kan administrere 3DСoat-funktioner ved hjælp af scripting.
Kør eller opret nye kommandoer ved hjælp af scripting eller kompilering af dem ved at få adgang til Core API.

Starten er ret nem. Bare brug Scripts Menu → Opret dit script eller opret et nyt Core API script .

Scripts menu

– Scripting er en række kommandoer, der kan udføres uden kompilering.
Når vi vælger et værktøj eller udfører en funktion, udfører vi en kommando, der allerede er inkluderet i programmet. Oprettelse af et script giver os mulighed for at kombinere disse kommandoer for automatisk at udføre en række trin, der fremskynder vores arbejde.

– Core API (Application Programming Interface) er ikke kun scripting; koden du skriver kører med fuld hastighed af kompileret C++.
Det er en kraftfuld metode til at udvide 3DCoats funktionalitet. Du kan automatisere jobbet eller tilføje primært nye værktøjer.

Scripting

3DCoat brugerAngelScript , som er et C++-lignende sprog. Scriptet er en tekstfil med kommandoer udført i en personlig rækkefølge.

Denne kommando kan kendes ved at optage den i hukommelsen ved at trykke på funktionen RMB+MMB samtidigt. Når vi åbner en notesblok og indsætter den, får vi teksten til den tilsvarende kommando. Det er nyttigt at se og redigere det i Notepad++ (vælg “C”-syntaks). Kør derefter scriptet via filmenuen “Scripts / Run Script”.

Core API

Core API er en kraftfuld metode til at udvide 3DCoats funktionalitet. Du kan automatisere jobbet eller tilføje primært nye værktøjer.
Dette er ikke kun scripting; koden du skriver kører med fuld hastighed af kompileret C++.

Core API script er et kompatibelt C++17-program, der fungerer på den fulde native C++-hastighed. Dette er langt mere end blot et manuskript; du kan lave selv tidskritiske og flertrådede opgaver og tilpasse 3DCoat i dybden, hvilket primært skaber ny funktionalitet og værktøjer.

Men hele processen er fuldstændig gennemsigtig for dig. Du behøver ikke at konfigurere noget eller administrere komplekse projektkonfigurationer. 3DCoat vil lede dig gennem hele processen med en simpel guide.

* Core API fungerer korrekt for brugere med ikke-engelske brugernavne, hele installationsprocessen er nu super nem.

* CoreAPI-kompileringsprocessen ændrede sig væsentligt. Nu bruges kun Visual Studio ; intet behov for clang-cl. Det forenkler brugen, fordi du kun skal installere én ekstra software, ikke to som før. Download- og installationsprocessen er fuldstændig automatiseret.

* Core API understøtter også farvede voxels.

---

Python API

3DCoat Python API er beregnet til at udløse UI-kommandoer, operere over scenen og skabe nye værktøjer. Det ligner meget C++ Core API, men har sine egne fordele og ulemper.

• Intet behov for yderligere opsætning for at lave dine scripts; Python er indlejret i 3DCoat distributivet.
• Python er som en schweizerkniv, der giver dig mulighed for at bringe hele Python-bibliotekernes kraft ind i 3DCoat.
• Python er meget langsommere end C++, så det kan kun bruges til generel styring, ikke til dybe og komplekse algoritmer.
• Hvis du allerede er bekendt med C++ Core API, er Python API meget ens, næsten 1:1, med samme logik og funktionsnavne.

---

Hvordan begynder man?

Starten er ret nem. Bare brug Scripts→ Opret nyt Core API script
Vælg derefter skabelonen, og vælg en sti til dit projekt.

Hvis Visual Studio (eller Visual Studio Code) er installeret, starter den med din nye fil. Hvert eksempel er veldokumenteret og bruger relativt simpel syntaks, så det er let at forstå fra let til komplekst.

 Du behøver ikke indstille nogen standardsyntaks i VStudio.
 Bare skriv kode og kør i 3DCoat, ikke i Visual Studio.
 VStudio er ligesom en teksteditor der, der kan vise tip og hjælp under kodning.
 Skriv din kode på VStudio og gem *.cpp, åbn den i 3DC og den kører automatisk. 

---

Eksempler

At se på eksemplerne er den bedste måde at forstå API’en på.

Brug scripts→Opret et nyt Core API script for at eksperimentere med disse eksempler.