опис

API 3DCoat Python призначений для запуску команд інтерфейсу користувача, роботи над сценою та створення нових інструментів. Він дуже схожий на C++ Core API, але має свої переваги та недоліки.

• Немає необхідності в будь-якому додатковому налаштуванні для створення ваших сценаріїв; Python вбудовано в дистрибутив 3DCoat .
• Python схожий на швейцарський ніж, що дозволяє вам використовувати всю потужність бібліотек Python у 3DCoat.
• Python набагато повільніший за C++, тому його можна використовувати лише для загального керування, а не для глибоких і складних алгоритмів.
• Якщо ви вже знайомі з C++ Core API, API Python дуже схожий, майже 1:1, з тією самою логікою та назвами функцій.

Використання

• Використовуйте Сценарії->Створити сценарій Python , щоб створити новий сценарій. Ви можете вибрати початковий шаблон для початку. Файл .py відкриється у вашому поточному редакторі, пов’язаному з файлами .py.
• Для роботи ми використовуємо вбудований Python 3.8.10. Це остання версія Python, яка може працювати в Windows 7.
• За потреби ви можете створити файл з назвою requirements.txt зі списком використовуваних модулів; у цьому випадку модулі будуть автоматично встановлені перед виконанням сценарію.
• Ми рекомендуємо Visual Studio Code, оскільки він автоматично розпізнає синтаксис спеціалізованих команд 3DCoat і запропонує правильні підказки.
• Зверніть увагу: файл coat.pyi, який знаходиться в папці проекту, відповідає за підказки модуля coat у Visual Studio. Ви можете відкрити цей файл, оскільки він містить список усіх класів і команд, які можуть бути корисними для швидкого ознайомлення.
• Використовуйте «Сценарії»->Показати консоль Python , щоб побачити вихід консолі з Python. Наразі це єдиний спосіб налагодити сценарій. Пізніше ми плануємо додати нативне налагодження за допомогою Visual Studio Code.
• Ви можете встановити додаткові модулі для Python за допомогою Сценарії->Встановити модулі Python . Іншим способом є використання requirements.txt у тій же папці, що й файл .py.

Основні класи

Загальний вхід/вивід: coat.io
Керування діалогом: coat.dialog
Операції з сіткою: coat.Mesh
Коріння сцени: пальто.Сцена
Елемент сцени: coat.SceneElement
Управління об’ємом: пальто.Об’єм
Керування інтерфейсом користувача: coat.ui
2D-векторна математика: coat.vec2
3D-векторна математика: coat.vec3
4D-векторна математика: coat.vec4
3D-матриця математики: coat.mat3
Математика 4D-матриці: coat.mat4
Керування симетрією: coat.symm