Комплект разработчика Вердж3Д
Комплект разработчика «Вердж3Д» (англ. Developer Kit, DevKit) — это набор примеров, инструментов и исходного кода, которые поставляются с корпоративными версиями «Вердж3Д». Этот набор поможет вам выполнять различные задачи разработчика, такие как:
- Изучение и обзор внутренних компонентов набора инструментов «Вердж3Д».
- Модификация «Вердж3Д» и использование модифицированных версий в собственных 3Д-приложениях.
- Расширение АПИ «Вердж3Д» с помощью собственных классов и методов.
- Разработка новых блоков Пазлов.
- Совершенствование ГЛТФ-экспортера «Вердж3Д», добавление собственных данных или параметров.
- Разработка своего собственного конфигуратора или системы e-commerce с использованием плагина «Вердж3Д для ВордПресс» в качестве референса.
Комплект разработчика предназначен для опытных программистов, желающих модифицировать движок. Он не нужен для создания приложений «Вердж3Д» со стандартным набором функций.
- Установка и настройка
- Структура комплекта разработчика
- Сборка «Вердж3Д»
- Добавление нового метода в «ЯваСкрипт» АПИ
- Добавление нового класса в «ЯваСкрипт» АПИ
- Добавление новых пазлов
Установка и настройка
Возьмите архив DevKit из области загрузки панели инструментов вашей учетной записи. Распакуйте этот архив в выбранную вами директорию.
Если вы собираетесь собрать движок «Вердж3Д» или редактор пазлов из исходного кода, вам понадобится утилита npm, которая является частью среды разработки Node.js. Вы можете установить ее с помощью этих инструкций.
Наконец, перейдите в распакованный каталог DevKit и выполните следующую команду для установки зависимостей:
npm install
Структура комплекта разработчика
DevKit включает следующие каталоги:
| Каталог | Описание |
|---|---|
| addons/verge3d | Исходный код дополнения для Блендер (только «Вердж3Д для Блендера»). |
| build | Готовые скрипты движка «Вердж3Д» и дополнительные модули (ammo.js и т.д.). |
| max_plugin | Исходный код плагина для 3дс Макс (только «Вердж3Д для 3дс Макса»). |
| maya_plugin | Исходный код плагина для Майя (только «Вердж3Д для Майи»). |
| puzzles | Готовые скрипты и исходный код редактора пазлов. |
| python | Python 3 и служебные модули. |
| src | Исходный код движка «Вердж3Д». |
| templates | Шаблоны приложений «Вердж3Д». |
| wordpress | Исходный код плагина «Вердж3Д для ВордПресс». |
| xz | Исходный код модуля сжатия XZ. |
Сборка «Вердж3Д»
Перед компиляцией «Вердж3Д», пожалуйста, убедитесь что вы установили npm и все необходимые зависимости, как описано выше.
Чтобы скомпилировать неоптимизированный билд «Вердж3Д», что хорошо подходит для целей тестирования и отладки, выполните следующую команду в директории DevKit:
npm run build
Вы можете найти скомпилированные модули в директории build вашего DevKit. Чтобы протестировать его, просто скопируйте модуль движка v3d.js в ваше приложение внутри «Вердж3Д», например:
cp build/v3d.js ~/verge3d/applications/my_awesome_application/
Чтобы скомпилировать оптимизированную версию «Вердж3Д» (она же релизная версия), выполните следующую команду в директории DevKit:
npm run build-release
Для сборки логического редактора Пазлов используются следующие команды. Для создания неоптимизированной версии введите:
npm run build-puzzles
Чтобы собрать оптимизированную версию, выполните команду:
npm run build-puzzles-release
Скомпилированный скрипт редактора Пазлов находится в директории puzzles вашего DevKit. Чтобы применить его в «Вердж3Д», скопируйте все содержимое этого каталога в каталог puzzles в вашей директории «Вердж3Д» (заменяя уже существующие там файлы).
Добавление нового метода в «ЯваСкрипт» АПИ
Допустим, вы хотите добавить еще один метод в класс App. Например, метод printHelloWorld() должен вывести что-то на консоль браузера:
App.printHelloWorld()
Класс App реализован в модуле, расположенном по адресу src/extras/App.js. Откройте его и добавьте следующий код в конец файла, прямо перед закрывающими скобками класса App. Не забудьте добавить еще одну запятую там, где заканчивается предыдущий метод.
printHelloWorld: function() {
console.log('Hello World!');
}
Соберите и скопируйте среду выполнения Пазлов в папку с установленным «Вердж3Д». Теперь вы можете попробовать новый добавленный блок в редакторе Пазлов.
Добавление нового класса в «ЯваСкрипт» АПИ
Чтобы дополнить АПИ «Вердж3Д» каким-либо пользовательским классом, создайте .js файл с именем вашего класса в соответствующем подкаталоге папки src DevKit (например, src/extras/MyAwesomeClass.js). В этом .js-файле реализуйте свой класс - вы можете вдохновиться уже существующими классами. Наконец, зарегистрируйте свой класс в глобальном пространстве имен v3d, добавив следующую строку в файл src/v3d.js:
export { MyAwesomeClass } from './extras/MyAwesomeClass.js';
Соберите и скопируйте среду выполнения «Вердж3Д» в ваше приложение и попробуйте ее в консоли браузера.
var myAwesomeStuff = new v3d.MyAwesomeClass();
myAwesomeStuff.whatEver();
Добавление новых пазлов
Чтобы создать собственный блок пазлов, отредактируйте файл puzzles/src/puzzles_blocks.js. Вы можете вдохновиться уже существующими пазлами. Зарегистрируйте его в соответствующей категории панели инструментов в верхней части файла.
Соберите и скопируйте среду выполнения Пазлов в папку с установленным «Вердж3Д». Теперь вы должны найти свой новый пазл в панели инструментов Редактора Пазлов.
Остались вопросы?
Задайте их на нашем форуме!