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

Комплект разработчика «Вердж3Д» (англ. Developer Kit, DevKit) — это набор примеров, инструментов и исходного кода, которые поставляются с корпоративными версиями «Вердж3Д». Этот набор поможет вам выполнять различные задачи разработчика, такие как:

Изучение и обзор внутренних компонентов набора инструментов «Вердж3Д».
Модификация «Вердж3Д» и использование модифицированных версий в собственных 3Д-приложениях.
Расширение АПИ «Вердж3Д» с помощью собственных классов и методов.
Разработка новых блоков Пазлов.
Совершенствование ГЛТФ-экспортера «Вердж3Д», добавление собственных данных или параметров.
Разработка своего собственного конфигуратора или системы e-commerce с использованием плагина «Вердж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Д». Теперь вы должны найти свой новый пазл в панели инструментов Редактора Пазлов.

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

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