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

Содержание
- Введение
- Добавление записей
- Использование записей
- Переименование записей
- Удаление записей
- Резервное копирование
- Перечень групп пазлов системной библиотеки
Введение
В «Вердж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.

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