Scripting & Core API

A 3DСoat funkciókat szkriptek segítségével kezelheti.
Futtasson vagy hozzon létre új parancsokat parancsfájl használatával, vagy fordítsa le őket a Core API elérésével.

A kezdés elég könnyű. Csak használja a Scripts menü → Create your Script vagy Hozzon létre egy új Core API- szkriptet .

Szkriptek menü

– A Scripting olyan parancsok sorozata, amelyek fordítás nélkül is végrehajthatók.
Amikor kiválasztunk egy eszközt vagy végrehajtunk egy függvényt, akkor a programban már szereplő parancsot hajtjuk végre. A szkript létrehozása lehetővé teszi, hogy ezeket a parancsokat kombináljuk, hogy automatikusan végrehajtsunk egy sor lépést, amelyek felgyorsítják a munkánkat.

– A Core API (Application Programming Interface) nem csak a szkriptelés; az általad írt kód a lefordított C++ teljes sebességével fut.
Ez egy hatékony módszer a 3DCoat funkcionalitásának kiterjesztésére. Automatizálhatja a munkát, vagy alapvetően új eszközöket adhat hozzá.

Scripting

A 3DCoataz AngelScriptet használja, amely egy C++-szerű nyelv. A szkript egy szöveges fájl, amely parancsokat személyes sorrendben hajt végre.

Ezt a parancsot úgy ismerhetjük meg, hogy a memóriába rögzítjük, az RMB+MMB funkció egyidejű lenyomásával. Egy jegyzettömb megnyitása és beillesztése után megkapjuk a megfelelő parancs szövegét. Hasznos megtekinteni és szerkeszteni a Notepad++ programban (válassza a „C” szintaxist). Ezután futtassa a szkriptet a „Scripts / Run Script” fájlmenüben.

Core API

A Core API egy hatékony módszer a 3DCoat funkcionalitásának kiterjesztésére. Automatizálhatja a munkát, vagy alapvetően új eszközöket adhat hozzá.
Ez nem csak a szkript; az általad írt kód a lefordított C++ teljes sebességével fut.

A Core API script egy kompatibilis C++17 program, amely a teljes natív C++ sebességgel működik. Ez sokkal több, mint egy forgatókönyv; akár időkritikus és többszálú feladatokat is végrehajthat, és mélyrehatóan testreszabhatja a 3DCoat , alapvetően új funkciókat és eszközöket hozva létre.

De az egész folyamat teljesen átlátható az Ön számára. Nem kell semmit konfigurálnia vagy bonyolult projektkonfigurációkat kezelnie. A 3DCoat egy egyszerű varázsló segítségével végigvezeti Önt az egész folyamaton.

* A Core API megfelelően működik a nem angol felhasználói névvel rendelkező felhasználók számára, a telepítési folyamat most rendkívül egyszerű.

* A CoreAPI fordítási folyamat alapvetően megváltozott. Most már csak a Visual Studio használatos; nem kell cseng-cl. Leegyszerűsíti a használatot, mert csak egy további szoftvert kell telepítenie, nem kettőt, mint korábban. A letöltési és telepítési folyamat teljesen automatizált.

* A Core API támogatja a színes voxeleket is.

---

Python API

A 3DCoat Python API célja a felhasználói felület parancsok kiváltása, a jelenet feletti működés és új eszközök létrehozása. Nagyon hasonlít a C++ Core API hoz, de megvannak a maga előnyei és hátrányai.

• Nincs szükség további beállításokra a szkriptek elkészítéséhez; A Python be van ágyazva a 3DCoat disztribúcióba.
• A Python olyan, mint egy svájci kés, amely lehetővé teszi, hogy a Python-könyvtárak teljes erejét behozza a 3DCoat.
• A Python sokkal lassabb, mint a C++, ezért csak általános kezelésre használható, mély és összetett algoritmusokhoz nem.
• Ha már ismeri a C++ Core API t, a Python API nagyon hasonló, majdnem 1:1, ugyanazokkal a logikával és függvénynevekkel.

---

Hogyan kezdjem?

A kezdés elég könnyű. Csak használja a Scripts→Create new Core API parancsfájlt
Ezután válassza ki a sablont, és válassza ki a projekt elérési útját.

Ha a Visual Studio (vagy a Visual Studio Code) telepítve van, akkor az új fájllal indul. Mindegyik példa jól dokumentált, és viszonylag egyszerű szintaxist használ, így könnyen érthető a könnyűtől a bonyolultig.

 A VStudio-ban nem kell szabványos szintaxist beállítani.
 Csak írja be a kódot, és futtassa a 3DCoat, ne a Visual Studioban.
 A VStudio olyan, mint egy szövegszerkesztő, amely tippeket és segítséget nyújthat a kódolás során.
 Írja be a kódot a VStudio-ba, és mentse el a *.cpp-t, nyissa meg 3DC-ben, és automatikusan elindul. 

---

Példák

A példák megtekintése a legjobb módja az API megértésének.

A Parancsfájlok → Hozzon létre egy új Core API parancsfájlt a példákkal való kísérletezéshez.