Popis
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í.
Používání
- K vytvoření nového skriptu použijte Skripty->Vytvořit skript Pythonu . Pro začátek si můžete vybrat počáteční šablonu. Soubor .py se otevře ve vašem aktuálním editoru spojeném se soubory .py.
- K provozu používáme vestavěný Python 3.8.10. Toto je poslední verze Pythonu, která může běžet na Windows 7.
- V případě potřeby můžete vytvořit soubor s názvem requirements.txt se seznamem použitých modulů; v tomto případě budou moduly automaticky nainstalovány před spuštěním skriptu.
- Doporučujeme Visual Studio Code, protože automaticky rozpozná syntaxi příkazů specializovaných na 3DCoat a nabídne správné rady.
- Věnujte pozornost: soubor coat.pyi umístěný ve složce projektu je zodpovědný za rady modulu kabátu ve Visual Studiu. Tento soubor můžete otevřít, protože obsahuje seznam všech tříd a příkazů, což může být užitečné pro rychlou orientaci.
- Chcete-li zobrazit výstup konzoly z Pythonu, použijte Skripty->Zobrazit konzolu Pythonu. V současné době je to jediný způsob, jak ladit skript. Později plánujeme přidat nativní ladění pomocí Visual Studio Code.
- Další moduly pro Python můžete nainstalovat pomocí Skripty->Instalovat moduly Pythonu . Dalším způsobem je použít soubor requirements.txt ve stejné složce jako je umístění souboru .py.
Hlavní třídy
Obecné I/O: coat.io
Správa dialogů: kabát.dialog
Síťové operace: kabát.Síťovina
Kořeny scény: kabát. Scéna
Prvek scény: kabát.SceneElement
Ovládání hlasitosti: kabát.Volume
Správa uživatelského rozhraní: coat.ui
Matematika 2D vektorů: kabát.vec2
Matematika 3D vektorů: kabát.vec3
Matematika 4D vektorů: kabát.vec4
3D-maticová matematika: kabát.mat3
4D-maticová matematika: kabát.mat4
Správa symetrie: kabát.symm