Beskrivelse

3DCoat Python API er beregnet til at udløse UI-kommandoer, operere over scenen og skabe nye værktøjer. Det ligner meget C++ Core API, men har sine egne fordele og ulemper.

• Intet behov for yderligere opsætning for at lave dine scripts; Python er indlejret i 3DCoat distributivet.
• Python er som en schweizerkniv, der giver dig mulighed for at bringe hele Python-bibliotekernes kraft ind i 3DCoat.
• Python er meget langsommere end C++, så det kan kun bruges til generel styring, ikke til dybe og komplekse algoritmer.
• Hvis du allerede er bekendt med C++ Core API, er Python API meget ens, næsten 1:1, med samme logik og funktionsnavne.

Brug

• Brug Scripts->Create Python Script til at oprette et nyt script. Du kan vælge en indledende skabelon til at starte. .py-filen åbnes i din nuværende editor, der er knyttet til .py-filer.
• Vi bruger indlejret Python 3.8.10 til at fungere. Dette er den sidste Python-version, der muligvis kører på Windows 7.
• Hvis det er nødvendigt, kan du oprette en fil kaldet requirements.txt med en liste over brugte moduler; i dette tilfælde vil modulerne automatisk blive installeret, før scriptet kører.
• Vi anbefaler Visual Studio Code, da den automatisk genkender 3DCoat-specialiseret kommandosyntaks og giver de korrekte hints.
• Vær opmærksom: filen coat.pyi, der findes i projektmappen, er ansvarlig for pelsmodul-tipsene i Visual Studio. Du kan åbne den fil, da den indeholder listen over alle klasser og kommandoer, hvilket kan være nyttigt for hurtig reference.
• Brug Scripts->Vis Python Console for at se konsoloutputtet fra Python. I øjeblikket er dette den eneste måde at debugge script. Senere planlægger vi at tilføje native debugging ved hjælp af Visual Studio Code.
• Du kan installere yderligere moduler til Python ved hjælp af Scripts->Installer Python-moduler . En anden måde er at bruge requirements.txt i samme mappe som .py-filens placering.

Hovedklasser

Generel I/O: coat.io
Dialogstyring: coat.dialog
Mesh operationer: coat.Mesh
Scene rødder: pels. Scene
Sceneelement: frakke.SceneElement
Volumenstyring: pels.Volume
UI-styring: coat.ui
2D-vektorer matematik: coat.vec2
3D-vektorer matematik: coat.vec3
4D-vektorer matematik: coat.vec4
3D-matrix matematik: coat.mat3
4D-matrix matematik: coat.mat4
Symmetristyring: coat.symm