Рабочий процесс рендеринга с V-Ray App SDK: загрузка сцены, предпросмотр и вывод

Согласно документации Chaos, V-Ray App SDK предоставляет интерфейс, с помощью которого сторонние программы могут запускать и контролировать движок V-Ray. В этом руководстве рассмотрены загрузка сцены и рендеринг через SDK, просмотр промежуточного изображения и сохранение результата в файл. Документация не указывает конкретную версию SDK, поэтому приведённые ниже сведения основаны на описанном в ней общем рабочем процессе.

Для каких задач можно использовать V-Ray App SDK?

SDK позволяет создавать сцену V-Ray и выполнять рендеринг в процессе другого приложения или независимо от него. Сцену можно собрать в памяти, преобразовав данные из собственного формата проекта в плагины V-Ray, либо загрузить из .vrscene — формата сцен V-Ray. В числе описанных возможностей также есть поддержка распределённого рендеринга.

Это решение может быть полезно разработчикам, которые хотят встроить рендеринг в собственные инструменты или автоматизированные процессы. SDK — не руководство по стандартному пользовательскому интерфейсу 3ds Max или другой программы для моделирования, а API для создания интеграций с движком V-Ray. Поэтому практическая польза для архитектурных бюро напрямую зависит от того, есть ли в используемом ПО интеграция на базе SDK.

От настройки до получения изображения: пошагово

1. Настройте пути SDK. Документация требует задать переменную среды VRAY_SDK. Если используется привязка Python, папку python внутри SDK нужно добавить в путь поиска модулей Python. В качестве примеров для Windows приводится запуск setenv.bat, а для Linux и macOS — source setenv.sh. Эти скрипты задают соответствующие переменные среды.

2. Проверьте расположение библиотек. Когда задана переменная VRAY_SDK, привязка SDK ищет необходимые двоичные файлы и зависимости в VRAY_SDK/bin. Если в структуре каталогов продукта нет папки bin, можно использовать VRAY_APPSDK_BIN: в этом случае поиск выполняется в указанной папке. Документация также указывает, что при невозможности использовать переменную среды путь поиска библиотек можно задать во время выполнения.

3. Создайте renderer и загрузите сцену. VRayRenderer — основной класс для запуска и управления процессом рендеринга. Сцену можно создать с помощью новых объектов плагинов и параметров или загрузить из файла .vrscene. Оба подхода можно использовать вместе. При разработке интеграции на этом этапе следует определить, как будут передаваться данные сцены.

4. Выберите режим и запустите рендеринг. По умолчанию, согласно документации, используется режим Interactive (CPU). Вызов start() выполняется асинхронно: рендеринг продолжается в отдельном потоке, а приложение в это время может выполнять другие операции. Получение промежуточного изображения во время рендеринга позволяет отслеживать прогресс в режиме предпросмотра. По завершении рендеринга становится доступно итоговое изображение.

5. Получите изображение и освободите ресурсы. SDK предоставляет текущее изображение рендера в виде объекта изображения; его можно показать на экране или сохранить в файл в поддерживаемом формате. После завершения работы нужно закрыть renderer и освободить используемую память — это заключительный шаг базового процесса, описанного в документации.

Краткий пример последовательности вызовов из документации Python:

import vray

with vray.VRayRenderer() as renderer:
    renderer.load('./intro.vrscene')
    renderer.start()
    renderer.waitForRenderEnd(6000)
    image = renderer.getImage()
    image.save('intro.png')

Имена файлов в примере взяты из документации. Этот код следует использовать в интеграции, адаптировав путь к файлу сцены и место сохранения итогового изображения под конкретный проект.

Предпросмотр или финальный рендер?

SDK предусматривает два режима рендеринга. Interactive подходит для быстрого предпросмотра и получения постепенной обратной связи при изменении настроек сцены. Режим Production предназначен для получения нужного финального изображения после тщательной подготовки сцены; на его создание может уйти больше времени. Переключаться между режимами можно для разных рендеров, не пересоздавая renderer и не загружая сцену заново.

Для GPU документация перечисляет CUDA и OptiX для NVIDIA, а Metal и MetalRT — для Apple. Поэтому совместимость оборудования и используемой технологии рендеринга нужно проверить в начале работы над интеграцией. Поддержка плагинов также различается: в справочнике API некоторые компоненты отмечены как полностью или частично поддерживаемые, а для некоторых указано отсутствие поддержки GPU. Это означает, что нельзя считать, будто любой компонент сцены будет работать во всех режимах рендеринга.

Как SDK влияет на рабочий процесс архитектурной визуализации

Для команд архитектурной визуализации ценность SDK заключается в возможности встроить повторяющиеся этапы рендеринга в приложение. Инструмент для работы над проектом может загружать .vrscene, показывать предпросмотр, отслеживать состояние рендеринга и сохранять изображение. Распределённый рендеринг также упоминается в документации SDK, однако возможность его использования зависит от программной и аппаратной конфигурации конкретной интеграции.

Выбор режима может упростить рабочий процесс: Interactive подойдёт для проверки материалов, освещения и кадрирования, а Production — для финального изображения утверждённой сцены. При этом документация SDK не содержит числовых сравнений времени рендеринга, требований к оборудованию или условий лицензирования. Поэтому бюро следует самостоятельно проверить совместимость и оборудование на реальных сценах проекта.

Распространённые ошибки

• Не задать переменные среды: если VRAY_SDK не определена, привязка может не найти необходимые библиотеки. Путь к модулю Python также нужно настроить отдельно.

• Не учитывать асинхронную работу: start() запускает рендеринг в фоновом режиме. Документация указывает, что пока renderer находится в состоянии PREPARING, не следует изменять сцену или сам renderer; такие попытки могут быть отклонены.

• Путать режим предпросмотра с финальным: Interactive предназначен для быстрой обратной связи, а Production — для подготовленного изображения. Использование этих режимов на разных этапах помогает выстроить более последовательный процесс.

• Считать плагины совместимыми без проверки: поддержка GPU в справочнике API зависит от конкретного плагина. Совместимость компонентов сцены с целевым режимом рендеринга следует проверить в ходе тестирования интеграции.

Описанный в этом руководстве рабочий процесс основан на общих принципах использования, изложенных в документации Chaos по V-Ray App SDK; конкретная версия ПО в документации не указана.