Руководство по фильтрации bitmap и запеканию текстур в V-Ray SDK

По состоянию на 7 октября 2026 года документация Chaos по V-Ray SDK перечисляет параметры для фильтрации bitmap-текстур и запекания текстур с помощью BakeView. Это руководство предназначено для технических художников и разработчиков, которые работают с функциями SDK, а не с меню интерфейса. В документации не указано, к какой версии программного обеспечения V-Ray относятся эти возможности, поэтому здесь не следует предполагать совместимость с конкретной версией. Цель — разобраться в назначении параметров и осознаннее настраивать процессы работы с текстурами и bake.

1. Выберите тип фильтрации bitmap-текстуры

BitmapBuffer используется для передачи bitmap-данных из файла текстурному плагину TexBitmap. Тип фильтрации задаётся параметром filter_type. В документации варианты представлены числовыми значениями, поэтому при интеграции SDK важно проверить, какому методу соответствует каждое число.

1. Сначала выберите метод фильтрации, подходящий для конкретного применения текстуры, затем убедитесь, что значение filter_type соответствует выбранному методу. Например, 1 — это mip-map-фильтрация, а 5 — резкая mip-map-фильтрация. Это разные настройки.

2. Если фильтрация не нужна, рассмотрите вариант 0; если требуется поведение фильтрации ближайшим соседом — -1. Документация описывает эти варианты, но не рекомендует одно оптимальное значение для любой сцены или типа текстуры.

3. Не используйте значение 4 в новой конфигурации. В документации SDK оно отмечено как устаревшее.

4. filter_blur также указан среди свойств BitmapBuffer, но в предоставленном тексте документации для этого параметра нет ни рекомендуемого значения, ни описания поведения. Поэтому вместо того, чтобы принимать фиксированное значение blur за данность, проверьте документацию используемого приложения.

Влияние фильтрации на изображение определяется не только выбором числового значения. На обработку bitmap также могут влиять данные о цветопередаче и цветовом пространстве. Поэтому не рассматривайте параметры фильтрации в отрыве от управления цветом.

2. Настройте transfer function и цветовое пространство вместе

Параметр transfer_function в BitmapBuffer указывает способ передачи текстуры: 0 означает linear, 1 — gamma corrected, 2 — sRGB, а 3 — auto. В документации также содержится важное предупреждение: если transfer_function не задан, фильтрация текстуры может работать некорректно. Поэтому при выборе типа фильтрации этот параметр также необходимо явно учитывать.

1. Определите подходящую функцию передачи для источника текстуры и задайте соответствующее значение transfer_function. В документации приведены названия вариантов и их числовые соответствия, но нет общего правила, какое значение использовать для каждого типа файла.

2. Рассматривайте поле rgb_color_space как линейное RGB-цветовое пространство текстуры. Значением по умолчанию указано raw, то есть преобразование не выполняется.

3. Среди встроенных названий цветовых пространств есть lin_srgb и acescg. В документации lin_srgb описано как линейное RGB-пространство для sRGB. Если задана переменная среды OCIO или параметр ocio_config_file в SettingsUnitsInfo, можно использовать и другие названия цветовых пространств, доступные в соответствующей конфигурации OCIO.

4. Учитывайте порядок преобразований: согласно документации, преобразование цветового пространства выполняется после применения transfer function. Поэтому несогласованность этих двух параметров может привести к неожиданному результату обработки цвета.

Эти нюансы особенно важны в рабочих процессах на базе SDK, где в одной сцене используются текстуры из разных источников. Однако документация не рекомендует конкретное цветовое пространство или значение transfer function для определённой сцены: выбор следует проверять с учётом свойств исходной текстуры и конфигурации OCIO, используемой в проекте.

3. Определите область запекания с помощью BakeView

В документации BakeView описан как плагин, который при запекании текстур используется вместо RenderView. Цель bake задаётся через bake_node, а целевые объекты для проекционного запекания — через target_nodes. Генератор UV можно подключить с помощью bake_uvwgen; поля u_min, v_min, u_max и v_max задают границы диапазона UV для запекания.

1. Определите, какой объект нужно запечь и какие объекты будут целями проекции. Для включения проекционного запекания параметр projection_baking принимает значение 0 для обычного bake и 1 для проекционного bake.

2. Подключите генератор UV к BakeView. Чтобы разместить несколько объектов на одном изображении, можно использовать mapped_bake_nodes и генераторы UV, соответствующие каждому объекту. В качестве альтернативы один и тот же генератор UV можно назначить всем узлам через bake_uvwgen.

3. Если нужно задать области bake по отдельности, учитывайте, что поля mapped_x0, mapped_y0, mapped_x1 и mapped_y1 определяют область вывода для каждого объекта. Для автоматического размещения областей предусмотрено свойство mapped_bake_nodes_auto; согласно документации, оно запекает узлы в одно изображение без задания областей.

4. Контролируйте поведение лучей. max_depth позволяет игнорировать геометрию, расположенную дальше указанного расстояния вдоль луча; при значении 0 геометрия не исключается по этой причине. ray_offset задаёт смещение начальной точки луча вдоль нормали. Документация не рекомендует универсальные оптимальные значения для этих параметров.

5. При необходимости задайте тип нормали и направление bake. При значении normal 0 используется smooth normal, а при 1 — geometry normal. Для from_camera значение 0 означает отражение лучей вдоль нормали поверхности и аналогичные эффекты затенения; значение 1 — bake с помощью лучей, выходящих из камеры. Прежде чем менять эти параметры, определите, какой метод bake вам нужен.

Частые ошибки

Самая важная ошибка — выбрать фильтр, но не задать transfer_function: в документации SDK прямо сказано, что в этом случае фильтрация может работать некорректно. Другая распространённая ошибка — неправильно истолковать числовое значение filter_type или выбрать вариант 4, который уже не рекомендуется использовать.

При запекании важно помнить, что ненулевое значение max_depth может повлиять на удалённую геометрию. Кроме того, при использовании mapped_bake_nodes необходимо согласованно настроить генератор UV для каждого объекта и логику выходных областей. Документация содержит параметры SDK, но не приводит путь к меню, номер версии или готовую настройку качества для 3ds Max либо другого приложения.

Влияние на рабочие процессы архитектуры и визуализации

Эти параметры полезны командам, которые автоматизируют загрузку текстур и bake через V-Ray SDK. Технические художники, разрабатывающие инструменты для архитектурной визуализации, могут явно задавать цветовое пространство bitmap и данные transfer, а также управлять областью bake и UV-областями для объектов сцены на уровне кода. Для архитектурных и интерьерных команд преимущество заключается не столько в появлении новой визуальной функции, сколько в возможности лучше контролировать подготовку ресурсов.

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