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

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

Содержание

Введение

В «Вердж3Д» есть две библиотеки:

System Library (системная библиотека) — хранится в файле library.xml в папке puzzles дистрибутива «Вердж3Д». Эта библиотека входит в состав «Вердж3Д» и доступна только для чтения.
User Library (библиотека пользователя) — хранится в файле my_library.xml в папке с приложениями. Вы можете использовать эту библиотеку для добавления своих собственных пазлов.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Hovered Cursor

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

Замените Cube на требуемое имя объекта. Если вам нужно не менять курсор, а делать что-то другое, замените пазл set style.

Смотрите пример в магазине ассетов — «Кольцо».

Detect Pressed/Released

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

Замените Cube на требуемое имя объекта и пазл print to console на пазлы необходимые в вашем приложении.

Keyboard Controls

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

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

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

Смотрите пример в магазине ассетов — «Приключения фермера».

Performance Tweaks

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

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

Setup Fullscreen iFrame

Заменить кнопку входа в полноэкранный режим собственным ХТМЛ-элементом.

Для работы пазлов укажите идентификатор нового элемента-контейнера вместо fs_button, элемента-изображения вместо fs_image, и новый набор изображений для входа/выхода из полноэкранного режима вместо enter.png/exit.png.

Этот набор пазлов разработан для случая, когда элементы расположены на родительской странице, а 3Д-часть встраивается через элемент iframe. Контейнерный элемент кнопки находится на родительской странице (чаще всего это будет <a> or <div>), поэтому здесь используется свойство in parent doc. Также мы модифицируем свойство src, что значит, что дочерним элементом будет <img>. Однако вы можете разработать свою собственную конфигурацию элементов и поменять данный набор пазлов согласно своим предпочтениям. Смотрите подробности в документации на пазл init fullscreen.

Смотрите пример в магазине ассетов — «Подогреватель чайников».

Sound iOS Workaround

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

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

Alert Message

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

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

Смотрите пример в магазине ассетов — «Фоторамка».

Map Range

Отобразить один числовой интервал на другой. С версии «Вердж3Д» 4.2 этот набор пазлов считается устаревшим. Вместо него вам следует использовать встроенный пазл map range.

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

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