Leírás
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.
Használat
- Új szkript létrehozásához használja a Parancsfájlok->Python-szkript létrehozása parancsot. Kiválaszthat egy kezdeti sablont az indításhoz. A .py fájl megnyílik a .py fájlokhoz társított jelenlegi szerkesztőben.
- A működéshez beágyazott Python 3.8.10-et használunk. Ez az utolsó Python-verzió, amely Windows 7 rendszeren futhat.
- Ha szükséges, létrehozhat egy követelmény.txt nevű fájlt a használt modulok listájával; ebben az esetben a modulok automatikusan telepítésre kerülnek, mielőtt a szkript futna.
- Javasoljuk a Visual Studio Code-ot, mivel automatikusan felismeri a 3DCoat-specifikus parancsok szintaxisát, és megfelelő tippeket kínál.
- Figyelem: a projekt mappájában található coat.pyi fájl felelős a Visual Studio coat modul tippjéért. Megnyithatja ezt a fájlt, mivel tartalmazza az összes osztály és parancs listáját, ami hasznos lehet a gyors áttekintéshez.
- A Scripts->Show Python Console segítségével megtekintheti a Python konzol kimenetét. Jelenleg ez az egyetlen módja a szkriptek hibakeresésének. Később azt tervezzük, hogy hozzáadjuk a natív hibakeresést a Visual Studio Code használatával.
- A Pythonhoz további modulokat telepíthet a Scripts->Install Python Modules segítségével. Egy másik lehetőség, ha a követelmények.txt fájlt ugyanabban a mappában használja, ahol a .py fájl található.
Fő osztályok
Általános I/O: coat.io
Párbeszédkezelés: coat.dialog
Hálóműveletek: kabát.Háló
Jelenet gyökerei: kabát.Scene
Jelenet elem: kabát.SceneElement
Térfogatkezelés: kabát.Térfogat
UI kezelése: coat.ui
2D-vektoros matematika: coat.vec2
3D-vektorok matematika: coat.vec3
4D-vektorok matematika: coat.vec4
3D-mátrix matematika: coat.mat3
4D-mátrix matematika: coat.mat4
Szimmetriakezelés: coat.symm