Плагин Cinema 4D для VPano

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

Никакого ручного экспорта моделей, никакого FTP, никаких таблиц с координатами — всё одним действием прямо из C4D. Инструкция рассчитана на пользователей, у которых уже есть аккаунт на vpano.ru. Если аккаунта пока нет — зарегистрируйтесь бесплатно, базового тарифа достаточно, чтобы пройти весь сценарий ниже.

• Cinema 4D R20 и новее (поддерживаются как Python 2.7 в R20–R22, так и Python 3 в R23+)
• Любой движок рендера: Standard, Physical, Octane, Redshift, V-Ray, Arnold — плагин не вмешивается в сам рендер
• Действующий аккаунт VPano и доступ в интернет с компьютера, где установлен C4D

Скачайте архив плагина (ссылку получите в личном кабинете в разделе «Плагины и интеграции»). Распакуйте его и скопируйте папку Vpano-exportв каталог плагинов Cinema 4D:

• Windows: C:\Program Files\Maxon Cinema 4D <версия>\plugins\Vpano-export\
• macOS: /Applications/Maxon Cinema 4D <версия>/plugins/Vpano-export/
• Либо в пользовательский каталог плагинов, который указан в Edit → Preferences → Files

Перезапустите Cinema 4D. После запуска плагин появится в меню Extensions → VPano Export. Если вы предпочитаете запускать его как скрипт, файл vpano_export.py из того же архива можно положить в Script Manager и привязать к горячей клавише.

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

1. Откройте личный кабинет → Профиль
2. Найдите раздел «Токены для плагинов» и нажмите «Создать токен»
3. Заполните поля:
   • Имя — произвольное, например «Cinema 4D на рабочей станции»
   • Область — выберите «Все проекты» или конкретный проект
   • Срок действия — рекомендуем 180 дней с возможностью продления
4. Нажмите «Создать». На экране появится значение токена — длинная строка вида vpano_pat_...

Если в вашем аккаунте включена двухфакторная аутентификация, при создании токена потребуется ввести шестизначный код из приложения-аутентификатора.

Откройте в Cinema 4D пункт Extensions → VPano Export. В диалоге плагина найдите секцию «Подключение к VPano»:

• Поле «Сервер» уже заполнено: https://vpano.ru — оставьте как есть
• В поле «Токен» вставьте значение, скопированное на предыдущем шаге
• Нажмите «Тест»

При успешном подключении плагин покажет сообщение «Подключение установлено: ваш-email@example.com», а в выпадающем списке «Проект» появятся все 3D-проекты из вашего аккаунта. Если вы видите ошибку — посмотрите раздел «Решение проблем».

VPano собирает тур из точек обзора — это места, где зритель сможет «встать» и осмотреться. В вашей сцене каждой такой точке должна соответствовать обычная камера Cinema 4D, поставленная в нужном положении и на нужной высоте (обычно высота глаз — около 165 см над полом).

Имя каждой камеры обязательно должно начинаться с префикса pano_ и заканчиваться числом:

• pano_1 — первая точка
• pano_2 — вторая точка
• pano_3, pano_4 и так далее

Плагин автоматически находит в сцене все камеры с таким именем, сортирует их по номеру и использует только их. Любые другие камеры (рабочие, рендерные, для роликов) он пропускает.

Сами панорамы плагин не рендерит — это делаете вы в привычном движке. Для каждой камерыpano_* отрендерите сферическую панораму в формате equirectangular 2:1:

• Рекомендуемое разрешение: 4096×2048 пикселей для большинства задач, 8192×4096 — для премиум-объектов и больших экранов в шоуруме
• Формат файла: JPG или PNG
• Соотношение сторон: ровно 2:1, иначе сшивка панорамы будет искажена

Большинство движков (Octane, Redshift, V-Ray, Corona, Arnold, стандартный рендер C4D) умеют рендерить equirectangular-панорамы — обычно это отдельный режим камеры или параметр в настройках вывода. В Cinema 4D встроенный рендер делает это через настройку Camera → Spherical.

Когда панорамы готовы, вернитесь в диалог плагина. Под списком камер вы увидите кнопки для назначения файла каждой камере:

• Ручной режим: напротив каждой камеры — кнопка выбора файла, выбираете нужную панораму
• Автоматический режим: укажите папку, в которой лежат панорамы с именами pano_1.jpg, pano_2.jpg и так далее — плагин сам разложит их по камерам

Если у файлов имена другого формата (например, panorama_1.jpg) — это тоже поддерживается, плагин ищет номер в конце имени.

В нижней части диалога:

1. Включите чекбокс «После экспорта загрузить в VPano»
2. В выпадающем списке «Проект» выберите проект, в который нужно отправить тур
3. Нажмите «Экспортировать»

Плагин соберёт геометрию модели, координаты камер и файлы панорам в один пакет .vpanoи автоматически загрузит его в ваш аккаунт. Прогресс отображается в реальном времени. На обычном проекте из 10–20 точек весь процесс — от нажатия кнопки до готового тура — занимает несколько минут.

После завершения загрузки откройте личный кабинет и перейдите в раздел «3D-проекты». Ваш тур появится в списке выбранного проекта: дольхаус-вид с моделью здания, все точки обзора расставлены ровно там, где стояли камеры в C4D, на каждую точку назначена соответствующая панорама.

Дальше тур работает как обычный 3D-тур VPano: можно настроить переходы, добавить хотспоты, оформить под бренд, опубликовать и поделиться ссылкой.

«Токен недействителен» или «Unauthorized»

Токен был отозван, истёк срок действия или скопирован с пробелом в начале/конце. Создайте новый токен в личном кабинете и вставьте его снова.

«Сервер недоступен» или «Connection refused»

В системе настроен HTTP-прокси (например, корпоративный Privoxy), и он мешает плагину дойти до vpano.ru. Плагин старается обходить системный прокси автоматически, но если у вас жёсткий корпоративный firewall, попросите системного администратора добавить vpano.ru в список разрешённых.

В списке камер пусто

Проверьте, что имена камер начинаются с pano_ и заканчиваются числом. Камеры с другими именами плагин игнорирует.

Плагин не появился в меню Extensions

Проверьте путь установки и права на папку плагинов (особенно в Program Files на Windows — может понадобиться запуск C4D от имени администратора при первой установке). В Cinema 4D R20 убедитесь, что в системе есть Python 2.7 — он поставляется вместе с C4D, но в редких случаях бывает повреждён.

«TWO_FACTOR_REQUIRED» при создании токена

В вашем аккаунте включена двухфакторная аутентификация. Откройте приложение-аутентификатор и введите текущий шестизначный код.

Когда тур загружен в VPano, его можно дорабатывать в 3D-студии: добавлять солнечные блики, расставлять навигационные хотспоты, оформлять под бренд через White Label, или экспортировать готовый тур ZIP-архивом — подробнее на странице ZIP-экспорт.

Если вы работаете с архитектурными визуализациями, посмотрите также раздел VPano для archviz-студий и наш сценарий сборки тура из рендеров.

Есть вопросы или предложения по плагину? Напишите нам — мы развиваем интеграции с DCC-пакетами как один из приоритетов и рады обратной связи от пользователей C4D.