Opis

Interfejs API 3DCoat Python ma na celu wyzwalanie poleceń interfejsu użytkownika, działanie na scenie i tworzenie nowych narzędzi. Jest bardzo podobny do C++ Core API, ale ma swoje zalety i wady.

• Nie ma potrzeby dodatkowej konfiguracji do tworzenia skryptów; Python jest osadzony w dystrybucji 3DCoat .
• Python jest jak szwajcarski nóż, który pozwala wykorzystać całą moc bibliotek Pythona w 3DCoat.
• Python jest znacznie wolniejszy niż C++, więc może być używany tylko do ogólnego zarządzania, a nie do głębokich i złożonych algorytmów.
• Jeśli znasz już C++ Core API, Python API jest bardzo podobny, prawie 1:1, z tą samą logiką i nazwami funkcji.

Stosowanie

• Użyj Skrypty->Utwórz skrypt Pythona, aby utworzyć nowy skrypt. Możesz wybrać początkowy szablon, aby rozpocząć. Plik .py otworzy się w bieżącym edytorze powiązanym z plikami .py.
• Do działania używamy wbudowanego języka Python 3.8.10. To ostatnia wersja Pythona, która może działać w systemie Windows 7.
• W razie potrzeby możesz utworzyć plik o nazwie wymagania.txt z listą używanych modułów; w takim przypadku moduły zostaną automatycznie zainstalowane przed uruchomieniem skryptu.
• Polecamy Visual Studio Code, ponieważ automatycznie rozpozna składnię poleceń wyspecjalizowanych w 3DCoat i zaoferuje poprawne wskazówki.
• Uwaga: plik coat.pyi znajdujący się w folderze projektu odpowiada za wskazówki dotyczące modułu coat w Visual Studio. Możesz otworzyć ten plik, ponieważ zawiera on listę wszystkich klas i poleceń, które mogą być pomocne do szybkiego odniesienia.
• Użyj Skrypty->Pokaż konsolę Pythona , aby zobaczyć dane wyjściowe konsoli z Pythona. Obecnie jest to jedyny sposób debugowania scripth. Później planujemy dodać natywne debugowanie przy użyciu Visual Studio Code.
• Możesz zainstalować dodatkowe moduły dla Pythona, używając Skrypty->Zainstaluj moduły Pythona . Innym sposobem jest użycie pliku requirements.txt w tym samym folderze, w którym znajduje się plik .py.

Główne zajęcia

Ogólne we/wy: coat.io
Zarządzanie dialogami: coat.dialog
Operacje na siatce: płaszcz.Mesh
Korzenie sceny: płaszcz.Scena
Element sceny: płaszcz.SceneElement
Zarządzanie objętością: coat.Volume
Zarządzanie interfejsem użytkownika: coat.ui
Matematyka wektorów 2D: coat.vec2
Matematyka wektorów 3D: coat.vec3
Matematyka wektorów 4D: coat.vec4
Matematyka matrycy 3D: coat.mat3
Matematyka matrycy 4D: coat.mat4
Zarządzanie symetrią: coat.symm