Плагин 3ds Max для VPano

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

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

• 3ds Max 2018 и новее (используется Python 3 и PySide2; в 3ds Max 2025+ — PySide6)
• Любой движок рендера: Scanline, ART, Corona, V-Ray, Arnold, Octane, Redshift — плагин не вмешивается в сам рендер
• Действующий аккаунт VPano и доступ в интернет с компьютера, где установлен 3ds Max

Скачайте архив плагина (ссылку получите в личном кабинете в разделе «Плагины и интеграции»). Распакуйте папку vpano_export в каталог пользовательских скриптов 3ds Max:

• Стандартный путь: %LOCALAPPDATA%\Autodesk\3dsMax\<версия>\<язык>\scripts\vpano_export\
• Либо в любую другую папку, на которую у вас есть права записи — путь к ней нужно будет указать в MacroScript

Далее перетащите файл vpano_macro.ms мышью прямо в окно вьюпорта 3ds Max — Max автоматически зарегистрирует MacroScript. После этого добавьте кнопку на тулбар или пункт в меню: Customize → Customize User Interface → Toolbars / Menus → Category «VPano», перетащите элемент «VPano Export» в нужное место.

Запускать плагин можно теперь либо кнопкой/пунктом меню, либо горячей клавишей, назначенной через тот же диалог Customize.

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

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

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

Запустите плагин (кнопкой на тулбаре или через меню). В диалоге плагина найдите секцию «Подключение к VPano»:

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

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

VPano собирает тур из точек обзора — это места, где зритель сможет «встать» и осмотреться. В вашей сцене каждой такой точке должна соответствовать обычная камера 3ds Max (Free, Target, V-Ray Camera, Corona Camera), поставленная в нужном положении и на нужной высоте (обычно высота глаз — около 165 см над полом).

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

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

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

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

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

В большинстве движков для рендера 360°-панорамы выбирается специальный тип камеры или режим вывода: в V-Ray — VRayDomeCamera со включённой опцией «Spherical Panorama» и FOV 360°, в Corona — параметр Camera Type «Spherical (Full)», в Arnold — режим Spherical Camera, в стандартном рендере Scanline можно использовать Render → Panorama Exporter.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

MacroScript не появился в Customize → Category «VPano»

Перетащите файл vpano_macro.ms в окно вьюпорта повторно. Убедитесь, что папка vpano_export доступна на запись и что у вас 3ds Max 2018 или новее (в более старых версиях плагин не работает).

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

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

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

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

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