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