Ви можете керувати функціями 3DСoat за допомогою скриптів.
Виконуйте або створюйте нові команди за допомогою сценаріїв або компілюйте їх за допомогою доступу до Core API.
Початок досить простий. Просто скористайтеся меню «Сценарії» → «Створити свій сценарій» або «Створіть новий сценарій основного API ».
![](https://3dcoat.com/documentation/wp-content/uploads/2023/06/Scripts-1.jpg)
– Scripting — це набір команд, які можна виконувати без компіляції.
Коли ми вибираємо інструмент або виконуємо функцію, ми виконуємо команду, яка вже включена в програму. Створення сценарію дозволяє нам комбінувати ці команди для автоматичного виконання серії кроків, які прискорюють нашу роботу.
– Core API (Application Programming Interface) – це не просто сценарії; код, який ви пишете, працює на повній швидкості скомпільованого C++.
Це потужний спосіб розширити функціональність 3DCoat. Ви можете автоматизувати роботу або додати принципово нові інструменти.
Scripting
3DCoat використовуєAngelScript , який є C++-подібною мовою. Скрипт являє собою текстовий файл з командами, які виконуються в особистому порядку.
Цю команду можна дізнатися, записавши її в пам’ять, одночасно натиснувши клавішу RMB+MMB. Відкривши блокнот і вставивши його, ми отримаємо текст відповідної команди. Корисно переглядати та редагувати його в Notepad++ (виберіть синтаксис «C»). Потім запустіть скрипт через меню файлів «Сценарії / Запустити сценарій».
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, API Python дуже схожий, майже 1:1, з тією самою логікою та назвами функцій.
Як почати?
Початок досить простий. Просто використовуйте Скрипти→Створити новий сценарій Core API
Потім виберіть шаблон і виберіть шлях для свого проекту.
Якщо встановлено Visual Studio (або Visual Studio Code), він розпочнеться з вашого нового файлу. Кожен приклад добре задокументований і використовує відносно простий синтаксис, тому його легко зрозуміти від легкого до складного.
Вам не потрібно встановлювати стандартний синтаксис у VStudio. Просто введіть код і виконайте його в 3DCoat, а не у Visual Studio. VStudio схожий на текстовий редактор, який може показувати підказки та допомогу під час кодування. Напишіть свій код у VStudio та збережіть *.cpp, відкрийте його в 3DC, і він автоматично запуститься.
Приклади
Перегляд прикладів — найкращий спосіб зрозуміти API.
Використовуйте «Сценарії»→Створіть новий сценарій Core API , щоб поекспериментувати з цими прикладами.