Что делает плагин

Плагин VPano для Cinema 4D собирает из вашей сцены всё, что нужно для 3D-тура: модель, положение камер — будущих точек обзора — и отрендеренные для них панорамы. Из этого получается один файл-пакет .vpano, который плагин может сразу загрузить в выбранный проект VPano.

Посетитель тура переходит между точками обзора и смотрит панорамы, а модель отвечает за плавные переходы и вид снаружи. Сами панорамы плагин не рендерит — это делаете вы в привычном движке.

Что нужно

  • Cinema 4D R20 или новее. Модель сохраняется в GLB; если в вашей версии нет экспорта в glTF (так бывает в R20), плагин сам сохранит её в FBX — VPano преобразует модель при загрузке.
  • Любой движок рендера, который умеет сферическую панораму 2:1.
  • Аккаунт VPano и интернет на компьютере с Cinema 4D.

Окно плагина открывается на языке Cinema 4D: русском, немецком, иначе на английском.

Тариф
Плагин бесплатный. Сколько 3D-туров и точек обзора в туре можно создать, и можно ли показывать 3D-тур по публичной ссылке, зависит от тарифа: доступно не на всех тарифах — см. актуальные тарифы.

Установка

  1. Войдите в аккаунт и скачайте архив на странице плагина для Cinema 4D (блок «Скачать плагин» виден после входа).
  2. В папке plugins Cinema 4D создайте папку, например VPano, и распакуйте в неё архив. Внутри должны лежать папка vpano и файл vpano_plugin.pyp.
  3. Перезапустите Cinema 4D. Плагин появится в меню Extensions (в старых версиях — Plugins) под именем «VPano Экспорт …».

Шаг 1 — Токен в личном кабинете

Раздел «Токены для плагинов» в личном кабинете VPano с кнопкой «Создать токен»

Плагин входит в ваш аккаунт не по паролю, а по токену. Токен можно в любой момент отозвать, пароль при этом не меняется.

  1. Откройте личный кабинет → «Токены для плагинов».
  2. Нажмите «Создать токен».
  3. Укажите «Имя токена» — например, по имени компьютера.
  4. В поле «Область» выберите «Все проекты» или «Только один проект» — тогда плагин сможет загружать только в него.
  5. Выберите «Срок действия»: 30, 90, 180 (по умолчанию) или 365 дней, либо «Не истекает».
  6. Нажмите «Создать». Если у вас включена двухфакторная защита, окно попросит «Код 2FA» из приложения-аутентификатора — введите его и нажмите «Создать» ещё раз.
  7. В окне «Токен создан» нажмите «Скопировать». Токен начинается с vpano_pat_.
Окно «Создать токен»: имя токена, область «Все проекты» или «Только один проект», срок действия
Токен показывается один раз
После закрытия окна токен больше не увидеть. Не успели скопировать — создайте новый. Ненужный токен отзывается кнопкой «Отозвать» в том же разделе.

Шаг 2 — Подключение к VPano

  1. Откройте «VPano Экспорт …» и найдите блок «Подключение к VPano».
  2. Поле «Сервер» уже заполнено адресом https://vpano.ru — оставьте его.
  3. Вставьте токен в поле «Токен» и нажмите «Тест».

При успехе появится «Подключение установлено: ваш e-mail», а список «Проект» заполнится вашими проектами. Плагин запоминает токен — при следующем запуске вводить его не нужно.

Шаг 3 — Камеры точек обзора

Каждая точка обзора — это обычная камера Cinema 4D в нужном месте и на высоте глаз. Назовите камеры pano_1, pano_2, pano_3 и так далее: плагин берёт только камеры с именем pano_ и номером, остальные пропускает.

Блок «Точки обзора и привязка панорам» показывает найденные камеры и счётчик «Найдено камер: N». Добавили или переименовали камеры — нажмите «Обновить».

Модель
Всё, что посетитель должен видеть в виде снаружи и на мини-карте, — стены, пол, мебель — оставьте в сцене. Тяжёлую сцену лучше упростить: так тур быстрее откроется.

Шаг 4 — Панорамы

Для каждой камеры pano_N отрендерите сферическую панораму с соотношением сторон ровно 2:1 (например, 4096 × 2048 или 8192 × 4096) в формате JPG, PNG или WebP.

Удобно сразу называть файлы по номеру камеры — pano_1.jpg или panorama_1.jpg: тогда их можно привязать одной кнопкой.

Шаг 5 — Привязка панорам

В строке каждой камеры видно имя, статус и путь к файлу панорамы.

  • «Автопривязка из папки …» — выберите папку с панорамами. Плагин найдёт для камеры pano_3 файл panorama_3, pano_3 или файл с тем же именем, что у камеры, и сообщит, сколько совпадений нашёл.
  • Кнопка «…» в строке — выбрать файл для одной камеры вручную.

Статус «OK» — файл найден, «нет файла» — панорамы ещё нет. Привязка сохраняется рядом с файлом сцены, при следующем открытии делать её заново не нужно.

Стекло и невидимые стены

Окна, стеклянные перегородки и вспомогательные стены можно отметить прямо в Cinema 4D, в блоке «Стекло / Невидимые стены»:

  1. Выделите объект (или несколько) в менеджере объектов.
  2. Нажмите «Отметить объект как стекло» или «Отметить объект как невидимую стену».

Плагин добавляет к имени объекта метку, по которой VPano узнаёт его при загрузке. Строка под кнопками показывает «Выбрано объектов: N, отмечено: M» (кнопка «Обновить» пересчитывает). «Снять метку vpano» возвращает объекту прежнее имя.

Поправить пометки можно и позже в Студии — см. Стекло и невидимые стены.

Шаг 6 — Экспорт и загрузка

Сначала сохраните сцену: папка для результата по умолчанию создаётся рядом с файлом сцены.

  1. В блоке «Вывод» проверьте «Папка:» (другую можно выбрать кнопкой «Обзор …») и оставьте включёнными «Экспортировать модель (GLB, иначе FBX)» и «Создать пакет (.vpano)».
  2. В блоке «Подключение к VPano» выберите «Проект» и включите «После экспорта загрузить в VPano».
  3. По желанию нажмите «Предпросмотр маркеров» — плагин покажет список точек обзора с координатами, ничего не экспортируя.
  4. Нажмите «Запустить экспорт».

В блоке «Статус» видно, что происходит: запись маркеров, копирование панорам, экспорт модели, упаковка пакета, затем «Загрузка в VPano…» с размером файла и «Загрузка завершена».

  • Загрузка идёт в 3D-тур выбранного проекта. Если 3D-тура в проекте ещё нет, он будет создан.
  • Точки обзора с теми же именами обновляются, новые — добавляются. Так можно заново отправить сцену после правок.
  • Из плагина загружается пакет до 512 МБ. Пакет больше — загрузите файл .vpano из папки вывода вручную в мастере 3D.

Шаг 7 — Тур в VPano

Откройте личный кабинет, выбранный проект и нажмите «3D Студия». Точки обзора стоят там, где стояли камеры, у каждой — своя панорама. Модель целиком видна снаружи в виде «3D режим».

Дальше тур настраивается как любой 3D-тур VPano: метки, дизайн, экскурсия, публикация — см. 3D Студия.

Если что-то не так

«Неверный формат токена (ожидается vpano_pat_…)»

Токен скопирован не полностью или с лишними символами. Скопируйте его заново или создайте новый.

«Токен недействителен или отозван.»

Срок токена истёк или он отозван. Создайте новый токен в личном кабинете и нажмите «Тест» ещё раз.

«Сервер недоступен. Проверьте URL и интернет.»

Проверьте адрес в поле «Сервер» и интернет. В корпоративной сети попросите администратора разрешить доступ к vpano.ru.

«Не найдено камер-точек обзора.»

Имена камер должны быть вида pano_1, pano_2 — без пробелов и лишних слов. Объект должен быть камерой.

«Сцена не сохранена — путь … не может быть разрешён.»

Сохраните сцену или укажите папку вывода вручную кнопкой «Обзор …».

Ошибка загрузки про лимит тарифа

VPano не принял пакет, потому что достигнут лимит 3D-туров или точек обзора, либо проект заблокирован после окончания тарифа. Пакет при этом остаётся в папке вывода — его можно загрузить позже.

Плагина нет в меню

Проверьте, что vpano_plugin.pyp и папка vpano лежат вместе в одной папке внутри plugins, и перезапустите Cinema 4D.

Дальше