ViewLayer(bpy_struct)#

base class — bpy_struct

class bpy.types.ViewLayer(bpy_struct)#

View layer

active_aov#

Active AOV

Type:

AOV, (readonly)

active_aov_index#

Index of active AOV

Type:

int in [0, inf], default 0

active_layer_collection#

Active layer collection in this view layer’s hierarchy

Type:

LayerCollection, (never None)

active_lightgroup#

Active Lightgroup

Type:

Lightgroup, (readonly)

active_lightgroup_index#

Index of active lightgroup

Type:

int in [0, inf], default 0

aovs#
Type:

AOVs bpy_prop_collection of AOV, (readonly)

cycles#

Cycles ViewLayer Settings

Type:

CyclesRenderLayerSettings, (readonly)

depsgraph#

Dependencies in the scene data

Type:

Depsgraph, (readonly)

eevee#

View layer settings for EEVEE

Type:

ViewLayerEEVEE, (readonly, never None)

freestyle_settings#
Type:

FreestyleSettings, (readonly, never None)

has_export_collections#

At least one Collection in this View Layer has an exporter

Type:

boolean, default False, (readonly)

layer_collection#

Root of collections hierarchy of this view layer, its ‘collection’ pointer property is the same as the scene’s master collection

Type:

LayerCollection, (readonly, never None)

lightgroups#
Type:

Lightgroups bpy_prop_collection of Lightgroup, (readonly)

material_override#

Material to override all other materials in this view layer

Type:

Material

name#

View layer name

Type:

string, default “”, (never None)

objects#

All the objects in this layer

Type:

LayerObjects bpy_prop_collection of Object, (readonly)

pass_alpha_threshold#

Z, Index, normal, UV and vector passes are only affected by surfaces with alpha transparency equal to or higher than this threshold

Type:

float in [0, 1], default 0.0

pass_cryptomatte_depth#

Sets how many unique objects can be distinguished per pixel

Type:

int in [2, 16], default 6

samples#

Override number of render samples for this view layer, 0 will use the scene setting

Type:

int in [0, inf], default 0

use#

Enable or disable rendering of this View Layer

Type:

boolean, default False

use_ao#

Render Ambient Occlusion in this Layer

Type:

boolean, default False

use_freestyle#

Render stylized strokes in this Layer

Type:

boolean, default False

use_motion_blur#

Render motion blur in this Layer, if enabled in the scene

Type:

boolean, default False

use_pass_ambient_occlusion#

Deliver Ambient Occlusion pass

Type:

boolean, default False

use_pass_combined#

Deliver full combined RGBA buffer

Type:

boolean, default False

use_pass_cryptomatte_accurate#

Generate a more accurate cryptomatte pass

Type:

boolean, default True

use_pass_cryptomatte_asset#

Render cryptomatte asset pass, for isolating groups of objects with the same parent

Type:

boolean, default False

use_pass_cryptomatte_material#

Render cryptomatte material pass, for isolating materials in compositing

Type:

boolean, default False

use_pass_cryptomatte_object#

Render cryptomatte object pass, for isolating objects in compositing

Type:

boolean, default False

use_pass_diffuse_color#

Deliver diffuse color pass

Type:

boolean, default False

use_pass_diffuse_direct#

Deliver diffuse direct pass

Type:

boolean, default False

use_pass_diffuse_indirect#

Deliver diffuse indirect pass

Type:

boolean, default False

use_pass_emit#

Deliver emission pass

Type:

boolean, default False

use_pass_environment#

Deliver environment lighting pass

Type:

boolean, default False

use_pass_glossy_color#

Deliver glossy color pass

Type:

boolean, default False

use_pass_glossy_direct#

Deliver glossy direct pass

Type:

boolean, default False

use_pass_glossy_indirect#

Deliver glossy indirect pass

Type:

boolean, default False

use_pass_material_index#

Deliver material index pass

Type:

boolean, default False

use_pass_mist#

Deliver mist factor pass (0.0 to 1.0)

Type:

boolean, default False

use_pass_normal#

Deliver normal pass

Type:

boolean, default False

use_pass_object_index#

Deliver object index pass

Type:

boolean, default False

use_pass_position#

Deliver position pass

Type:

boolean, default False

use_pass_shadow#

Deliver shadow pass

Type:

boolean, default False

use_pass_subsurface_color#

Deliver subsurface color pass

Type:

boolean, default False

use_pass_subsurface_direct#

Deliver subsurface direct pass

Type:

boolean, default False

use_pass_subsurface_indirect#

Deliver subsurface indirect pass

Type:

boolean, default False

use_pass_transmission_color#

Deliver transmission color pass

Type:

boolean, default False

use_pass_transmission_direct#

Deliver transmission direct pass

Type:

boolean, default False

use_pass_transmission_indirect#

Deliver transmission indirect pass

Type:

boolean, default False

use_pass_uv#

Deliver texture UV pass

Type:

boolean, default False

use_pass_vector#

Deliver speed vector pass

Type:

boolean, default False

use_pass_z#

Deliver Z values pass

Type:

boolean, default False

use_sky#

Render Sky in this Layer

Type:

boolean, default False

use_solid#

Render Solid faces in this Layer

Type:

boolean, default False

use_strand#

Render Strands in this Layer

Type:

boolean, default False

use_volumes#

Render volumes in this Layer

Type:

boolean, default False

world_override#

Override world in this view layer

Type:

World

classmethod update_render_passes()#

Requery the enabled render passes from the render engine

update()#

Update data tagged to be updated from previous access to data or operators

classmethod bl_rna_get_subclass(id, default=None)#
Parameters:

id (string) – The RNA type identifier.

Returns:

The RNA type or default when not found.

Return type:

bpy.types.Struct subclass

classmethod bl_rna_get_subclass_py(id, default=None)#
Parameters:

id (string) – The RNA type identifier.

Returns:

The class or default when not found.

Return type:

type

Inherited Properties#

Inherited Functions#

References#