Beskrivelse

3DCoat Python API er ment å utløse UI-kommandoer, operere over scenen og lage nye verktøy. Det ligner veldig på C++ Core API, men har sine egne fordeler og ulemper.

• Du trenger ikke noe ekstra oppsett for å lage skriptene dine; Python er innebygd i 3DCoat distributivet.
• Python er som en sveitsisk kniv, og lar deg bringe hele kraften til Python-biblioteker inn i 3DCoat.
• Python er mye tregere enn C++, så det kan bare brukes til generell administrasjon, ikke for dype og komplekse algoritmer.
• Hvis du allerede er kjent med C++ Core API, er Python API veldig lik, nesten 1:1, med samme logikk og funksjonsnavn.

Bruk

• Bruk Scripts->Create Python Script for å lage et nytt skript. Du kan velge en innledende mal for å starte. .py-filen åpnes i din nåværende editor knyttet til .py-filer.
• Vi bruker innebygd Python 3.8.10 for å operere. Dette er den siste Python-versjonen som kan kjøre på Windows 7.
• Om nødvendig kan du lage en fil kalt requirements.txt med en liste over brukte moduler; i dette tilfellet vil modulene bli automatisk installert før skriptet kjøres.
• Vi anbefaler Visual Studio Code, da den automatisk gjenkjenner 3DCoat spesialiserte kommandosyntaks og gir de riktige hintene.
• Vær oppmerksom: filen coat.pyi som ligger i prosjektmappen er ansvarlig for tipsene til kappemodulen i Visual Studio. Du kan åpne den filen, siden den inneholder listen over alle klasser og kommandoer, noe som kan være nyttig for rask referanse.
• Bruk Skript->Vis Python-konsoll for å se konsollutdataene fra Python. Foreløpig er dette den eneste måten å feilsøke script. Senere planlegger vi å legge til naturlig feilsøking ved å bruke Visual Studio Code.
• Du kan installere tilleggsmoduler for Python ved å bruke Scripts->Install Python Modules . En annen måte er å bruke requirements.txt i samme mappe som .py-filens plassering.

Hovedklasser

Generell I/O: coat.io
Dialogstyring: coat.dialog
Mesh operasjoner: pels.Mesh
Scene røtter: pels.Scene
Sceneelement: pels.SceneElement
Volumstyring: pels.Volum
UI-administrasjon: coat.ui
2D-vektorer matematikk: coat.vec2
3D-vektorer matematikk: coat.vec3
4D-vektorer matematikk: coat.vec4
3D-matrise matematikk: coat.mat3
4D-matrise matematikk: coat.mat4
Symmetrihåndtering: coat.symm