Popis

3DCoat Python API je určené na spúšťanie príkazov používateľského rozhrania, ovládanie scény a vytváranie nových nástrojov. Je veľmi podobné C++ Core API, ale má svoje výhody a nevýhody.

• Na vytváranie skriptov nie je potrebné žiadne ďalšie nastavenie; Python je vložený do distributívu 3DCoat .
• Python je ako švajčiarsky nôž, ktorý vám umožňuje preniesť celú silu Pythonových knižníc do 3DCoat.
• Python je oveľa pomalší ako C++, takže ho možno použiť iba na všeobecnú správu, nie na hlboké a zložité algoritmy.
• Ak už poznáte C++ Core API, Python API je veľmi podobné, takmer 1:1, s rovnakou logikou a názvami funkcií.

Použitie

• Na vytvorenie nového skriptu použite Skripty->Vytvoriť skript Pythonu . Na začiatok si môžete vybrať počiatočnú šablónu. Súbor .py sa otvorí vo vašom aktuálnom editore priradenom k ​​súborom .py.
• Na fungovanie používame vložený Python 3.8.10. Toto je posledná verzia Pythonu, ktorá môže bežať v systéme Windows 7.
• V prípade potreby môžete vytvoriť súbor s názvom requirements.txt so zoznamom použitých modulov; v tomto prípade sa moduly automaticky nainštalujú pred spustením skriptu.
• Odporúčame Visual Studio Code, pretože automaticky rozpozná syntax príkazov špecializovaných na 3DCoat a ponúkne správne rady.
• Venujte pozornosť: súbor coat.pyi umiestnený v priečinku projektu je zodpovedný za rady modulu kabátu vo Visual Studiu. Tento súbor môžete otvoriť, pretože obsahuje zoznam všetkých tried a príkazov, čo môže byť užitočné pre rýchlu orientáciu.
• Ak chcete vidieť výstup konzoly z Pythonu, použite Skripty->Zobraziť konzolu Python. V súčasnosti je to jediný spôsob, ako ladiť skript. Neskôr plánujeme pridať natívne ladenie pomocou Visual Studio Code.
• Ďalšie moduly pre Python môžete nainštalovať pomocou Skripty->Inštalovať moduly Pythonu . Ďalším spôsobom je použiť súbor requirements.txt v rovnakom priečinku ako je umiestnenie súboru .py.

Hlavné triedy

Všeobecné I/O: coat.io
Správa dialógov: kabát.dialóg
Sieťové operácie: kabát.Sieťovina
Korene scény: kabát.Scéna
Prvok scény: kabát.SceneElement
Správa objemu: kabát.Volume
Správa používateľského rozhrania: coat.ui
Matematika 2D-vektorov: kabát.vec2
Matematika 3D-vektorov: kabát.vec3
Matematika 4D-vektorov: kabát.vec4
3D-maticová matematika: kabát.mat3
4D-maticová matematika: kabát.mat4
Riadenie symetrie: kabát.symm