Комплект разработчика Вердж3Д

Комплект разработчика «Вердж3Д» (англ. Developer Kit, DevKit) — это набор примеров, инструментов и исходного кода, которые поставляются с корпоративными версиями «Вердж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Д». Теперь вы должны найти свой новый пазл в панели инструментов Редактора Пазлов.

Остались вопросы?

Задайте их на нашем форуме!