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)

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

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