Описание

API 3DCoat Python предназначен для запуска команд пользовательского интерфейса, работы со сценой и создания новых инструментов. Он очень похож на C++ Core API, но имеет свои преимущества и недостатки.

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

Применение

• Используйте Scripts->Create Python Script , чтобы создать новый скрипт. Вы можете выбрать исходный шаблон для запуска. Файл .py откроется в вашем текущем редакторе, связанном с файлами .py.
• Для работы мы используем встроенный Python 3.8.10. Это последняя версия Python, которая может работать в Windows 7.
• При необходимости вы можете создать файл с именем requirements.txt со списком используемых модулей; в этом случае модули будут автоматически установлены до запуска скрипта.
• Мы рекомендуем Visual Studio Code, поскольку он автоматически распознает синтаксис команд, специализированных для 3DCoat, и предлагает правильные подсказки.
• Обратите внимание: файл Coat.pyi, расположенный в папке проекта, отвечает за подсказки модуля Coat в Visual Studio. Вы можете открыть этот файл, так как он содержит список всех классов и команд, которые могут быть полезны для быстрой справки.
• Используйте Scripts->Show Python Console , чтобы увидеть вывод консоли из Python. В настоящее время это единственный способ отладки scripth. Позже мы планируем добавить нативную отладку с помощью Visual Studio Code.
• Вы можете установить дополнительные модули для Python, используя Scripts->Install Python Modules . Другой способ — использовать файл requirements.txt в той же папке, что и файл .py.

Основные классы

Общий ввод/вывод: Coat.io
Управление диалогами: coat.dialog
Операции с сеткой: Coat.Mesh
Корни сцены: пальто.Сцена
Элемент сцены: пальто.SceneElement
Управление объемом: Coat.Volume
Управление пользовательским интерфейсом: Coat.ui
Математика 2D-векторов: coat.vec2
3D-векторы по математике: coat.vec3
Математика 4D-векторов: coat.vec4
3D-матричная математика: coat.mat3
4D-матричная математика: coat.mat4
Управление симметрией: Coat.symm