Scripting и Core API

Вы можете управлять функциями 3DCoat с помощью скриптов.
Запускайте или создавайте новые команды, используя сценарии или компилируя их, обращаясь к Core API.

Старт довольно легкий. Просто используйте меню «Сценарии» → «Создайте свой сценарий» или «Создайте новый сценарий Core API» .

Меню скриптов

– Scripting — это последовательность команд, которые можно выполнять без компиляции.
Когда мы выбираем инструмент или выполняем функцию, мы выполняем команду, уже включенную в программу. Создание сценария позволяет нам комбинировать эти команды для автоматического выполнения ряда шагов, которые ускоряют нашу работу.

– Core API (Application Programming Interface) — это не просто скрипты; код, который вы пишете, работает на полной скорости скомпилированного C++.
Это мощный метод расширения функциональности 3DCoat. Вы можете автоматизировать работу или добавить принципиально новые инструменты.

Scripting

3DCoat используетAngelScript , язык, похожий на C++. Скрипт представляет собой текстовый файл с командами, выполняемыми в индивидуальном порядке.

Эту команду можно узнать, записав ее в память одновременным нажатием над функцией RMB+MMB. Открыв блокнот и вставив его, мы получим текст соответствующей команды. Полезно просматривать и редактировать его в Notepad++ (выберите синтаксис «C»). Затем запустите скрипт через файловое меню «Scripts/Run Script».

Core API

Core API — это мощный метод расширения функциональности 3DCoat. Вы можете автоматизировать работу или добавить принципиально новые инструменты.
Это не просто сценарий; код, который вы пишете, работает на полной скорости скомпилированного C++.

Сценарий Core API — это совместимая программа C++17, которая работает на полной собственной скорости C++. Это гораздо больше, чем просто сценарий; вы можете делать даже срочные и многопоточные задачи и глубоко настраивать 3DCoat , создавая принципиально новые функции и инструменты.

Но весь процесс полностью прозрачен для вас. Вам не нужно ничего настраивать или управлять сложными конфигурациями проекта. 3DCoat проведет вас через весь процесс с помощью простого мастера.

* Core API работает правильно для пользователей с неанглийскими именами пользователей, весь процесс установки теперь очень прост.

* Существенно изменился процесс компиляции CoreAPI. Сейчас используется только Visual Studio ; нет необходимости в clang-cl. Это упрощает использование, поскольку вам нужно установить только одно дополнительное программное обеспечение, а не два, как раньше. Процесс загрузки и установки полностью автоматизирован.

* Core API также поддерживает цветные воксели.

---

API Python

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

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

---

Как начать?

Старт довольно легкий. Просто используйте «Сценарии» → «Создайте новый сценарий Core API».
Затем выберите шаблон и выберите путь для вашего проекта.

Если установлена Visual Studio (или Visual Studio Code), она начнется с вашего нового файла. Каждый пример хорошо документирован и использует относительно простой синтаксис, поэтому его легко понять от простого к сложному.

 Вам не нужно устанавливать какой-либо стандартный синтаксис в VStudio.
 Просто введите код и выполните его в 3DCoat, а не в Visual Studio.
 VStudio похож на текстовый редактор, который может показывать подсказки и помощь при написании кода.
 Напишите свой код в VStudio и сохраните *.cpp, откройте его в 3DC, и он автоматически запустится. 

---

Примеры

Просмотр примеров — лучший способ понять API.

Используйте «Сценарии» → «Создайте новый сценарий Core API» , чтобы поэкспериментировать с этими примерами.