Руководство пользователя ProtoStage
Содержание
1. Что такое ProtoStage и для кого он
ProtoStage — это браузерное приложение для быстрой предварительной визуализации сценических конструкций и подготовки технического дизайна для мероприятий. Оно помогает:
- Дизайнерам — ускорить черновой скетчинг и сделать быстрые варианты композиции сцены и залов.
- Менеджерам проката — собрать конфигурацию из типовых моделей или каталога, прокомментировать и согласовать.
- Техническим директорам — сформировать понятную постановку задач для инженеров и подрядчиков.
2. Быстрый старт (5 минут)
- Откройте приложение (index.html). При первом запуске вы увидите пустую сцену и сетку. Появится стартовая «Плита».
- В левой панели «Библиотека объектов» выберите «Базовые элементы» и добавьте, например, «Куб» или «Кулиса (волнистая)».
- Поворот/панорамирование камеры: ЛКМ — вращение, колёсико — зум, ПКМ — панорамирование.
- Выберите объект кликом. Клавиши W/E/R переключают режимы: перемещение, вращение, масштаб.
- Включите временный снаппинг (удерживайте Shift), чтобы двигать с шагом 0.5 м и вращать на 15°[1].
- Сделайте скриншот: PNG или PDF в разделе «Сцена (экспорт/импорт)».
Подсказка: готовые 3D‑модели (GLTF/GLB) можно просто перетащить мышью на область вьюпорта.
3. Обзор интерфейса
- Левая панель — Библиотека и инструменты. Добавление базовых элементов, импорт GLTF/GLB, аннотации, камера/виды, инструменты трансформации, сетка/оси, снаппинг, экспорт/импорт проекта.
- Центральная область — Вьюпорт. 3D‑сцена с сеткой, системой координат, рамкой выделения и аннотациями.
- Правая панель — Инспектор и дерево сцены. Свойства выделенного объекта, дублирование/удаление, фокус, опустить на пол, иерархия объектов и групп с контролами блокировки/видимости.
- Статус‑бар внизу вьюпорта показывает кол-во объектов, тип камеры и примерную сложность сцены (треугольники).
- Загрузчик отображается при импорте моделей и проекта.
4. Библиотека объектов и импорт моделей
4.1. Базовые элементы
Доступные типы и ключевые параметры:
- Плита (floor): ширина, глубина, толщ.;
- Коробка помещения (roomBox): ширина, глубина, высота стен, толщ. стен;
- Стена (wall): ширина, высота, толщ.;
- N‑угольные: колонна/пирамида (sides, радиус, высота);
- Кольцо (ring): радиус, «трубка» (толщина);
- Кулиса волнистая (drape): ширина, высота;
- Куб/Шар/Полусфера/Трибуна: габариты, ступени (для трибуны);
- Цвет — через палитру «Цвет модели» или в Инспекторе.
4.2. Импорт GLTF/GLB
- Выберите категорию (Сценическое/Звук/Свет/Экраны/Мебель) и модель из списка — нажмите «Добавить».
- Импорт локальных файлов: «Выбрать файл(ы)» или просто перетяните .gltf/.glb на вьюпорт. Зависимости *.bin/текстуры подхватятся автоматически.
- Цвет GLTF: можно задать общий оттенок в момент добавления или позже в Инспекторе (если материал поддерживает цвет).
→ Перейти к выбору и трансформациям
5. Выбор, трансформации и снаппинг
5.1. Выбор
- Один объект — ЛКМ по объекту.
- Мультивыбор — Ctrl/⌘+клик по объектам.
- Рамка выбора — Ctrl/⌘+Shift и протянуть мышью по вьюпорту.
- ПКМ по объекту — контекстное меню действий. ПКМ по пустому месту меню не открывает.
5.2. Инструменты трансформации
- Перемещение — W или «Двигать».
- Вращение — E или «Вращать».
- Масштаб — R или «Масштаб».
- Фокус на объект — F; Опустить на пол — G.
- Групповое перемещение/вращение: при мультивыборе смещение и поворот синхронно применяются ко всем, с корректной осью и центром группы.
5.3. Сетка, оси и шаги (снаппинг)
- Показать сетку/оси — чекбоксы «Показать сетку/оси».
- Шаги снаппинга: перемещение (м), поворот (°), масштаб — раздел «Снаппинг (шаги)».
- Временный снаппинг: удерживайте Shift — 0.5 м / 15° / 0.1 масштаба[2].
- Шаг сетки: кнопки 0.5–5 м в статус‑баре внизу вьюпорта.
→ Перейти к группам и видимости
6. Группы, блокировка и видимости
- Объединить — Ctrl/⌘+G (минимум 2 объекта в выделении).
- Разъединить — Ctrl/⌘+B или кнопка «✖» у группы.
- Блокировка группы — иконка «🔒» в дереве сцены (в Инспекторе — «Заблокировать» для объекта).
- Режим видимости группы:
- 👁 Видимая — обычная работа;
- ◐ Полупрозрачная («ghost») — для контекстной подложки, не мешает работе;
- 🚫 Скрытая — временно исключена из вида и экспорта GLTF (если скрыта) и взаимодействий.
- Удаление: объект внутри группы нельзя удалить напрямую — сначала извлеките или разъедините группу[3].
7. Аннотации
- Добавление — в левой панели введите текст и нажмите «Добавить» (привязывается к выделенному объекту).
- Перемещение — перетащите пузырь аннотации; она хранит смещение относительно якоря даже при трансформациях.
- Скрыть/показать — чекбокс «Показать аннотации».
- Удаление — крестик на пузыре или при удалении якорного объекта аннотация удалится автоматически.
- Экспорт PNG/PDF — аннотации попадают на итоговое изображение.
→ Перейти к экспорту и импортам
8. Экспорт PNG/PDF/GLTF и проекты
- PNG: делает снимок вьюпорта без статус‑бара и рамки выделения.
- PDF: ландшафт A4, картинка вписывается по большей стороне с полями.
- GLTF: экспортирует текущие видимые объекты сцены.
- Экспорт проекта (JSON): сохраняет состав сцены, параметры, расположение, аннотации, камеру и тему. История действий не сохраняется[4].
- Импорт проекта: загрузите ранее сохранённый JSON.
→ Перейти к копированию и дублированию
9. Копирование, вставка и дублирование
- Копия — Ctrl/⌘+C.
- Вставить со сдвигом — Ctrl/⌘+V.
- Вставить на то же место — Alt+V.
- Дублировать — D.
- Поведение:
- GLTF из URL — вставляется повторной загрузкой по адресу (с сохранением имени и цвета);
- GLTF без URL (локальный импорт) — клонируется из сцены;
- Группы — копируются как пустые контейнеры (без автоматического копирования содержимого);
- Базовые элементы — создаются заново с теми же параметрами.
10. Камера, виды и тема
- Режимы камеры: «Перспектива» и «Ортографическая».
- Быстрые виды: Изометрия, Сверху, Спереди, Слева.
- Режимы камеры: «Перспектива» и «Ортографическая».
- Быстрые виды: Изометрия, Сверху, Спереди, Слева.
- Управление мышью: ЛКМ — вращение, Колесо — зум, ПКМ — панорамирование.
- Управление клавиатурой (камера): Стрелки — панорамирование; PageUp/PageDown — движение по высоте; Home/End — поворот вокруг цели (target).
- Модификаторы для перемещений/поворотов камеры: Alt — тонкий шаг, Ctrl/⌘ — крупный, Shift — временный снаппинг (15° для поворота; 0.5 м для перемещения, если шаг перемещения не задан).
- Тема: кнопка ☀️/🌙 в шапке — светлая/тёмная. Запоминается в браузере.
- Инструменты: W/1 — Перемещение; E/2 — Вращение; R/3 — Масштаб; Esc — снять инструмент.
- Выбор: Ctrl/⌘ — мультивыбор; Ctrl/⌘+Shift — рамка выбора.
- Камера (клавиатура): Стрелки — панорамирование; PageUp/PageDown — вверх/вниз; Home/End — поворот вокруг цели.
- Модификаторы камеры: Alt — тонкий шаг; Ctrl/⌘ — крупный; Shift — временный снаппинг (15° для поворота; 0.5 м для перемещения, если шаг перемещения не задан).
- Действия с объектами: F — фокус; G — опустить на пол; D — дублировать; Delete — удалить.
- Группы: Ctrl/⌘+G — объединить; Ctrl/⌘+B — разъединить.
- Буфер обмена: Ctrl/⌘+C — копировать; Ctrl/⌘+V — вставить (со сдвигом); Alt+V — вставить на место.
- Отмена/повтор: Ctrl/⌘+Z — отмена; Ctrl/⌘+Y или Ctrl/⌘+Shift+Z — повтор.
- Экспорт проекта: Ctrl+S.
- Временный снаппинг: Shift — 0.5 м / 15° / 0.1 масштаба.
- Начните с «Плиты» или «Коробки помещения», задайте габариты.
- Кольца/траверсы/кулисы — соберите базовую композицию и задайте цветовые пятна.
- Включайте «◐ Полупрозрачный» на вспомогательных группах, чтобы фокусироваться на ключевых объектах.
- Экспорт в PNG/PDF — быстрый способ собрать борд для обсуждения.
- Импортируйте GLTF из каталога, приводите цвет к бренду клиента (тон материалам).
- Используйте аннотации с уточнениями (модель, количество, сроки поставки), экспортируйте PDF для согласования.
- Группируйте по подсистемам (Свет, Звук, Сцена), блокируйте готовые группы «🔒», чтобы исключить случайные правки.
- Устанавливайте шаги снаппинга (например, 1 м и 15°) и шаг сетки (кнопки 1–2–5 м) для аккуратной раскладки.
- Ортографическая камера + виды «Сверху/Спереди» — удобны для схем и планов.
- Опускайте объекты на пол (G), подписывайте группы, фиксируйте состояния видимости для разных стадий проекта.
- Экспорт GLTF — передайте инженерам на проверку/доработку в CAD/DCC.
- Не удаётся удалить объект. Если он внутри группы — сначала извлеките его или разъедините группу[3].
- Объект не двигается. Проверьте: не заблокирован ли объект или одна из родительских групп (замок «🔒»).
- GLTF не загружается. Проверьте доступность URL или целостность локальных файлов (включая .bin/текстуры).
- Слишком «тяжёлая» сцена. Следите за числом треугольников в статус‑баре. Скрывайте/«ghost»-ьте большие группы.
- Горячие клавиши не работают. Во время ввода текста (переименование, аннотации) хоткеи отключены, кликните в пустое место.
- История действий короткая. Встроенная история хранит несколько последних шагов[4]. Для надёжности используйте «Экспорт проекта» чаще.
- Аннотации пропали после импорта проекта. Убедитесь, что импортируете правильный JSON, аннотации сохраняются вместе с проектом.
- Временный снаппинг: удерживайте Shift, чтобы временно переключиться на шаги 0.5 м / 15°. Это удобно для быстрой «сеточной» правки. ↩
- Постоянные шаги задаются в разделе «Снаппинг (шаги)». Временный снаппинг при Shift не меняет ваши сохранённые настройки. ↩
- Внутри группы объекты защищены от удаления, чтобы случайно не нарушить состав. Удалите/разъедините группу или извлеките объект на верхний уровень. ↩
- Встроенная история действий ограничена несколькими последними шагами (для экономии памяти). Для надёжных откатов используйте «Экспорт проекта» регулярно. ↩
10. Камера, виды и тема
На macOS клавиши Home/End обычно доступны как Fn+←/Fn+→.
11. Горячие клавиши
→ Перейти к рекомендациям по ролям