Библиотеки пазлов

Библиотека — это постоянное хранилище коллекций пазлов для повторного использования в проектах.

Содержание

Введение

В Verge3D есть две библиотеки пазлов:

Системная библиотека — хранится в файле library.xml в папке puzzles дистрибутива Verge3D. Эта библиотека входит в состав Verge3D и доступна только для чтения. Подробная документация на эту библиотеку приведена ниже.
Библиотека пользователя — хранится в файле my_library.xml в папке с приложениями. Вы можете использовать эту библиотеку для добавления своих собственных пазлов.

Добавление записей

Вы можете добавить группу пазлов в библиотеку пользователя, щелкнув на ней правой кнопкой мыши и выбрав опцию Save N Puzzles to Library. В модальном окне введите название группы так, как оно будет отображаться в списке записей библиотеки. Обновите список записей, перезагрузив страницу с редактором пазлов, чтобы обновить этот список.

Использование записей

Сохраненную группу пазлов можно извлечь из библиотеки, перетащив ее на рабочую область.

Переименование записей

В Verge3D переименование записей библиотеки пазлов пока не предусмотрено. Однако вы можете легко переименовать запись, отредактировав файл my_library.xml (в двух местах).

После переименования имя записи вашей библиотеки будет обновлено после обновления редактора.

Удаление записей

Запись можно удалить из библиотеки пользователя, нажав на кнопку ❌.

Резервное копирование

Каждый раз, когда вы сохраняете или удаляете записи, ранее сохраненный файл my_library.xml копируется в папку library_backup с меткой времени, добавленной к имени файла.

Это позволит вам восстановить любую из ранее сохраненных редакций вашей библиотеки пользователя, когда она вам понадобится. Просто скопируйте файл обратно в корень папки puzzles и удалите временную метку из его имени. Ваша библиотека будет обновлена после обновления редактора.

Перечень групп пазлов системной библиотеки

Ниже находится описание всех групп пазлов, входящих в состав системной библиотеки Verge3D.

Alert Message

Отображает уведомление в нижней части экрана.

В данных пазлах вы можете поменять текст и стиль уведомления.

Данная функциональность используется в демо-приложении «Фоторамка» (исходные файлы доступны в магазине ассетов).

Auto-Rotate Camera

Автоматически вращает камеру при неактивности пользователя.

Здесь вы можете указать задержку вращения и его скорость.

Color Picker

Создаёт элемент выбора цвета, привязанный к 3D-объекту.

Замените Cube (Blender), Box001 (3ds Max) или pCube1 (Maya) на требуемое имя объекта, а CubeMaterial (BoxMaterial/standardSurface1) на требуемое имя материала. Также укажите правильный вход ноды материала.

Context Menu

Заменяет штатное браузерное контекстное меню, вызываемое по правой кнопке мыши, на меню, определённое разработчиком приложения (всплывает по клику на 3D-объекте).

Замените Cube (Blender), Box001 (3ds Max) или pCube1 (Maya), пункты меню и обработчики событий для конкретного приложения.

Detect Pressed/Released

Пазл when clicked не позволяет разделить нажатие и отпускание кнопок мыши (или нажатие и отпускание пальца на тачскрине). Следующий набор пазлов позволяет это сделать:

Замените Cube (Blender), Box001 (3ds Max) или pCube1 (Maya) на требуемое имя объекта и пазл print to console на пазлы, необходимые в вашем приложении.

Hovered Cursor

Определяет нахождение курсора над выбранным объектом и меняет курсор на «палец», указывая пользователю, что данный объект кликабелен.

Замените Cube (Blender), Box001 (3ds Max) или pCube1 (Maya) на требуемое имя объекта. Если вам нужно не менять курсор, а делать что-то другое, замените пазл set style.

Данная функциональность используется в демо-приложении «Кольцо» (исходные файлы доступны в магазине ассетов).

HTML Dialogs

Данная библиотека содержит сниппеты для создания и отображения различных диалоговых окон:

Диалог OK

Отображает простой диалог с кнопкой "OK":

Замените "You are doing great!" внутри пазла set prop на собственный текст.

Диалог Yes/No

Отображает диалог с тексту и кнопками "Yes"/"No":

Замените "Would you like to proceed?" внутри пазла set prop на собственный текст. Мы можете также заменить тест (и значения) для кнопок "Yes"/"No".

Логика обработки возвращаемого значения (нажатая кнопка) диалога находится в нижней части соответствующего сниппета:

Здесь используется пазл on event of → close для перехвата момента закрытия диалога и пазл get prop для определения возвращаемого значения (кнопки).

Диалог Login

Отображает диалог с полями ввода электронной почты и пароля:

Замените "Enter your credetials to sign in" внутри пазла set prop на собственный текст. С помощью минимальных модификаций данный сниппет может быть превращен в диалог регистрации (создания нового пользователя).

Все сниппеты записи "HTML Dialogs" содержат в конце пазл showModal. Это приводит к тому, что соответствующий диалог отобразится сразу после нажатия кнопки выполнения пазлов. Поместите "showModal" куда-нибудь ещё (напр. внутрь пазла when clicked или on event of), чтобы открывать диалог по требованию.

Inquiry Form

Создаёт и показывает диалоговую форму для запроса, который может быть отправлен с помощью WordPress-плагина или стороннего сервиса для обработки форм.

По умолчанию диалог появляется по клику на объекте Cube и отображает форму с полями Name (имя) и Email (почта):

Форма может быть адаптирована согласно вашим требованиям. Не забудьте указать свойство name для всех полей формы.

Всегда заменяйте sandbox.soft8soft.com вашим собственным сервисом отправки форм! Песочница Verge3D, расположенная по данному адресу всегда принимает формы, но уничтожает их сразу по получении.

Keyboard Controls

Эти пазлы определяют нажатие клавиш на клавиатуре.

Замените ArrowLeft/ArrowRight на нужные клавиши и подставьте требуемые пазлы вместо print to console.

Имена клавиш это либо буквы (например "w", "a", "s", "d") набираемые на клавиатуре, либо специальные значения: "ArrowLeft", "ArrowRight", "ArrowUp", "ArrowDown", "Enter", "Tab", "Home", "End", "Delete", "Escape", " " (пробел), и т.д. Смотрите полный список клавиш.

Данная функциональность используется в демо-приложении «Приключения фермера» (исходные файлы доступны в магазине ассетов).

Performance Tweaks

Используйте эти пазлы чтобы регулировать качество и производительность приложений в зависимости от возможностей устройства. На мощных устройствах с экранами высокого разрешения качество рендеринга увеличивается за счёт увеличения числа рисуемых пикселей. На средних и маломощных устройствах эти пазлы отключают тени и постобработку.

Пазлы не требуют дополнительной настройки и рекомендуются к использованию во всех Verge3D-приложениях.

Preloader

Создаёт экран прелоадера, содержащий те же самые элементы, что и прелоадер, запускаемый при старте приложения.

Данный прелоадер может быть показан во время загрузки или добавления новых сцен, либо когда в вашем приложении выполняется что-то «тяжёлое» (получение или отправка данных, вычисления и т.д.). Удобство использования данного сниппета заключается в том, что создаваемый прелоадер сохраняет все стили, указанные в настройках вашего приложения.

Данная запись в библиотеке содержит 3 сниппета, используемые для создания, обновления и удаления прелоадера. Например, чтобы показать прелоадер в процессе работы пазла append scene, используйте следующий сниппет:

Prepare Sound

Этот пазл позволяет убрать ограничения на проигрывание звуков на мобильных устройствах.

Замените mySound.mp3 на звуковой файл из вашего приложения.

URL Params

Сохраняет/восстанавливает указанные данные как URL-параметры. Данные могут быть числами, строками, списками/векторами, а также словарями.

Сохранение и восстановление значений в виде URL-параметров позволяет зафиксировать состояние приложения (например, конфигурацию продукта, настройки пользователя, контактную информацию и т. д.) и представить его в виде измененного URL-адреса. Этот новый адрес можно сохранить в закладках для последующего использования, отправить другим людям или опубликовать в социальных сетях.

В сниппете из библиотеки мы сохраняем и восстанавливаем векторную позицию объекта Cube (в переменной my_value). Замените соответствующий пазл на собственный код.

VR Controls

Позволяет перемещаться в виртуальной реальности с использованием ВР-контроллеров (тачпадов или стиков в зависимости от модели). Данная библиотека совместима с большинством устройств присутствующих на рынке, при условии, что они соответствуют стандарту xr-standard.

Замените объект collision_mesh на навигационный меш, в пределах которого возможно движение камеры. Учтите, что вся зона над этим мешем будет пригодна для перемещения, а места, где этот меш отсутствует, доступны не будут.

Также убедитесь, что при входе в ВР-режим установлен режим позиционирования sitting or standing. Ознакомьтесь с пазлом enter VR mode для получения подробной информации.

Проблема с пазлами?

Обращайтесь за помощью на наш форум!