Scripting en Core API

U kunt 3DСoat-functies beheren met behulp van scripting.
Voer nieuwe opdrachten uit of maak ze met behulp van scripting of compileer ze door toegang te krijgen tot de Core API.

Het begin is vrij eenvoudig. Gebruik gewoon het menu Scripts → Maak uw script of maak een nieuw Core API- script .

Scripts-menu

– Scripting is een reeks opdrachten die kunnen worden uitgevoerd zonder te compileren.
Wanneer we een tool selecteren of een functie uitvoeren, voeren we een commando uit dat al in het programma is opgenomen. Door een script te maken, kunnen we deze opdrachten combineren om automatisch een reeks stappen uit te voeren die ons werk versnellen.

– Core API (Application Programming Interface) is niet alleen het scripten; de code die u schrijft, draait op de volledige snelheid van gecompileerde C++.
Het is een krachtige methode om de functionaliteit van de 3DCoat uit te breiden. U kunt de taak automatiseren of voornamelijk nieuwe tools toevoegen.

Scripting

3DCoat gebruiktAngelScript , wat een C++-achtige taal is. Het script is een tekstbestand met opdrachten die in een persoonlijke volgorde worden uitgevoerd.

Dat commando kan bekend worden gemaakt door het in het geheugen op te nemen door tegelijkertijd op de functie RMB+MMB te drukken. Door een kladblok te openen en te plakken, krijgen we de tekst van de bijbehorende opdracht. Het is handig om het in Notepad++ te bekijken en te bewerken (kies “C”-syntaxis). Voer vervolgens het script uit via het bestandsmenu “Scripts / Script uitvoeren”.

Core API

De Core API is een krachtige methode om de functionaliteit van 3DCoat uit te breiden. U kunt de taak automatiseren of voornamelijk nieuwe tools toevoegen.
Dit is niet alleen het script; de code die u schrijft, draait op de volledige snelheid van gecompileerde C++.

Core API script is een compatibel C++17-programma dat werkt op de volledige native C++-snelheid. Dit is veel meer dan alleen een script; je kunt zelfs tijdkritische en multithreaded taken maken en de 3DCoat diepgaand aanpassen, waardoor voornamelijk nieuwe functionaliteit en tools ontstaan.

Maar het hele proces is volledig transparant voor u. U hoeft niets te configureren of complexe projectconfiguraties te beheren. 3DCoat leidt u door het hele proces met een eenvoudige wizard.

* Core API werkt correct voor gebruikers met niet-Engelse gebruikersnamen, het hele installatieproces is nu supergemakkelijk.

* Het compileerproces van de CoreAPI is wezenlijk gewijzigd. Nu wordt alleen Visual Studio gebruikt; geen behoefte aan clang-cl. Het vereenvoudigt het gebruik omdat u slechts één extra software hoeft te installeren, niet twee zoals voorheen. Het download- en installatieproces is volledig geautomatiseerd.

* Core API ondersteunt ook gekleurde voxels.

---

Python-API

De 3DCoat Python API is bedoeld om UI-opdrachten te activeren, over de scène te werken en nieuwe tools te creëren. Het lijkt sterk op de C++ Core API, maar heeft zijn eigen voor- en nadelen.

• Geen extra instellingen nodig om uw scripts te maken; Python is ingebed in de 3DCoat -distributie.
• Python is als een Zwitsers mes, waardoor je de hele kracht van Python-bibliotheken in 3DCoat kunt brengen.
• Python is veel langzamer dan C++, dus het mag alleen worden gebruikt voor algemeen beheer, niet voor diepe en complexe algoritmen.
• Als u al bekend bent met de C++ Core API, lijkt de Python API erg op elkaar, bijna 1:1, met dezelfde logica en functienamen.

---

Hoe te beginnen?

Het begin is vrij eenvoudig. Gebruik gewoon Scripts → Maak een nieuw Core API script
Kies vervolgens de sjabloon en kies een pad voor uw project.

Als Visual Studio (of Visual Studio Code) is geïnstalleerd, begint het met uw nieuwe bestand. Elk voorbeeld is goed gedocumenteerd en gebruikt een relatief eenvoudige syntaxis, dus het is gemakkelijk te begrijpen, van eenvoudig tot complex.

 U hoeft geen standaardsyntaxis in VStudio in te stellen.
 Typ gewoon code en voer uit in 3DCoat, niet in Visual Studio.
 VStudio is daar net een teksteditor die hints en hulp kan tonen tijdens het coderen.
 Schrijf uw code op VStudio en sla de *.cpp op, open het in 3DC en het wordt automatisch uitgevoerd. 

---

Voorbeelden

Kijken naar de voorbeelden is de beste manier om de API te begrijpen.

Gebruik scripts → Maak een nieuw Core API script om met die voorbeelden te experimenteren.