Так называемые рендер-пасы или рендер-проходы, это дополнительные изображения, которые создаются при рендере и которые несут в себе какую-то отдельную дополнительную информацию о рендере. Например, это может быть карта глубины – черно-белое изображение на котором яркость белого цвета соответствует удаленности объектов от камеры. Создание таких рендер-пасов может включаться в Blender пользователем вручную в рабочей области Properties на вкладке View Layer или же с использованием Blender Python API.
.blend file on Patreon
Все рендер-пасы завязаны на текущий слой рендера “View Layer” и создаются только для этого слоя.
Доступ через Python API к включению и выключению рендер-пасов так же осуществляется через объект view_layer.
Указатель на текущий рендер слой мы можем получить через контекст:
|
1 2 3 |
bpy.context.view_layer # bpy.data.scenes['Scene'].view_layers["ViewLayer"] |
Все чекбоксы для отдельных рендер-пасов доступны через соответствующие свойства слоя рендера.
Например, основной рендер-пас, по которому собственно и создается финальное изображение рендера, определяется через свойство “combined”.
Мы можем проверить, включен ли данный рендер-пас, просто проверив значение этого свойства.
|
1 2 3 |
bpy.context.view_layer.use_pass_combined # True |
Значение True означает что рендер-пас включен (чекбокс отмечен) и он будет выполнен при рендере. Значение False означает что данный рендер-пас при рендере не будет выполняться.
Для того чтобы включить нужный рендер-пас, нужно просто присвоить соответствующему свойству значение True.
Например, включим карту глубины:
|
1 |
bpy.context.view_layer.use_pass_z = True |
Некоторые рендер-пасы доступны только для какого-то конкретного рендер-движка. К таким рендер-пасам нужно обращаться через свойство этого рендер движка.
Например, рендер-пас Light – Volume доступен для рендер движка EEVEE, поэтому включать его нужно следующим образом:
|
1 |
bpy.context.view_layer.eevee.use_pass_volume_direct = False |
Перечень свойств для включения и выключения рендер-пасов для Blender 4.4 следующий:
- Data
- Combined: use_pass_combined
- Z: use_pass_z
- Mist: use_pass_mist
- Normal: use_pass_normal
- Position: use_pass_position
- Vector: use_pass_vector
- Light
- Diffuse light: use_pass_diffuse_direct
- Diffuse color: use_pass_diffuse_color
- Specular light: use_pass_glossy_direct
- Specular color: use_pass_glossy_color
- Volume light: eevee.use_pass_volume_direct
- Other
- Emission: use_pass_emit
- Environment: use_pass_environment
- Shadow: use_pass_shadow
- Ambient occlusion: use_pass_ambient_occlusion
- Transparent: eevee.use_pass_transparent
- Cryptomatte
- Object: use_pass_cryptomatte_object
- Material: use_pass_cryptomatte_material
- Asset: use_pass_cryptomatte_asset