Scripting & Core API

Funkce 3DСoat můžete spravovat pomocí skriptování.
Spouštějte nebo vytvářejte nové příkazy pomocí skriptování nebo je kompilujte pomocí Core API.

Začátek je celkem snadný. Stačí použít nabídku Skripty → Vytvořit skript nebo Vytvořit nový skript Core API .

Nabídka skriptů

– Scripting je řada příkazů, které lze provádět bez kompilace.
Když vybereme nástroj nebo provedeme funkci, provedeme příkaz již zahrnutý v programu. Vytvoření skriptu nám umožňuje zkombinovat tyto příkazy a automaticky provést řadu kroků, které urychlí naši práci.

– Core API (Application Programming Interface) není jen skriptování; kód, který píšete, běží plnou rychlostí kompilovaného C++.
Je to účinná metoda pro rozšíření funkčnosti 3DCoat. Úlohu můžete automatizovat nebo přidat zásadně nové nástroje.

Scripting

3DCoat používáAngelScript , což je jazyk podobný C++. Skript je textový soubor s příkazy prováděnými v osobním pořadí.

Tento příkaz lze poznat tak, že jej zaznamenáte do paměti současným stisknutím funkce RMB+MMB. Otevřením poznámkového bloku a jeho vložením získáme text odpovídajícího příkazu. Je užitečné jej zobrazit a upravit v programu Notepad++ (zvolte syntaxi „C“). Poté spusťte skript přes nabídku souboru „Skripty / Spustit skript“.

Core API

Core API je výkonná metoda pro rozšíření funkčnosti 3DCoat. Úlohu můžete automatizovat nebo přidat zásadně nové nástroje.
Nejde jen o skriptování; kód, který píšete, běží plnou rychlostí kompilovaného C++.

Core API skript je kompatibilní program C++17, který pracuje s plnou rychlostí nativního C++. To je mnohem víc než jen scénář; můžete provádět i časově kritické a vícevláknové úkoly a 3DCoat do hloubky přizpůsobit, čímž vytvoříte zásadně nové funkce a nástroje.

Celý proces je ale pro vás zcela transparentní. Nemusíte nic konfigurovat ani spravovat složité konfigurace projektu. 3DCoat vás provede celým procesem pomocí jednoduchého průvodce.

* Core API funguje správně pro uživatele s neanglickými uživatelskými jmény, celý proces instalace je nyní velmi snadný.

* Proces kompilace CoreAPI se podstatně změnil. Nyní se používá pouze Visual Studio ; není potřeba cinkání-cl. Zjednodušuje používání, protože potřebujete nainstalovat pouze jeden další software, nikoli dva jako dříve. Proces stahování a instalace je zcela automatizovaný.

* Core API podporuje také barevné voxely.

---

Python API

3DCoat Python API je určeno ke spouštění příkazů uživatelského rozhraní, ovládání scény a vytváření nových nástrojů. Je velmi podobné C++ Core API, ale má své výhody a nevýhody.

• Pro vytváření skriptů není potřeba žádné další nastavení; Python je zabudován do distributivu 3DCoat .
• Python je jako švýcarský nůž, který vám umožňuje přenést celou sílu knihoven Pythonu do 3DCoat.
• Python je mnohem pomalejší než C++, takže jej lze použít pouze pro obecnou správu, nikoli pro hluboké a složité algoritmy.
• Pokud jste již obeznámeni s C++ Core API, Python API je velmi podobné, téměř 1:1, se stejnou logikou a názvy funkcí.

---

jak začít?

Začátek je celkem snadný. Stačí použít Skripty→Vytvořit nový skript Core API
Poté vyberte šablonu a zvolte cestu pro svůj projekt.

Pokud je nainstalováno Visual Studio (nebo Visual Studio Code), začne s vaším novým souborem. Každý příklad je dobře zdokumentován a používá relativně jednoduchou syntaxi, takže je snadno srozumitelný od jednoduchého po komplexní.

 Ve VStudio nemusíte nastavovat žádnou standardní syntaxi.
 Stačí zadat kód a spustit v 3DCoat, ne ve Visual Studiu.
 VStudio je jako textový editor, který může zobrazovat rady a pomoc při kódování.
 Napište svůj kód na VStudio a uložte *.cpp, otevřete jej v 3DC a automaticky se spustí. 

---

Příklady

Pohled na příklady je nejlepší způsob, jak porozumět API.

K experimentování s těmito příklady použijte Skripty→Vytvořit nový skript Core API .