bpy.context.view_layer

• bpy.context.view_layer 表示在当前场景中活动的视图层（View Layer）。
• 视图层定义了场景在渲染、显示和编辑方面的外观和行为。

属性

bpy.context.view_layer.name

• 类型：str
• 获取或设置视图层的名称。

bpy.context.view_layer.active_layer_collection

• 类型：bpy.types.LayerCollection
• 当前激活的图层集合。

bpy.context.view_layer.layer_collection

• 类型：bpy.types.LayerCollection
• 视图层所属的图层集合。

方法

bpy.context.view_layer.update()

• 更新当前活动的视图层。

bpy.context.view_layer.depsgraph

• 返回bpy.types.Depsgraph，视图层所处的数据依赖图（Depsgraph）。

bpy.context.view_layer.engine

• 返回当前视图层使用的渲染引擎的名称。

bpy.context.view_layer.frame_start

• 获取或设置当前视图层的起始帧（Frame）。

bpy.context.view_layer.frame_end

• 获取或设置当前视图层的结束帧。

bpy.context.view_layer.frame_current

• 获取或设置当前视图层的当前帧。

bpy.context.view_layer.use_pass

• 获取或设置当前视图层是否启用 Z 通道（Pass）。

bpy.context.view_layer.use_solid

• 获取或设置当前视图层是否使用 Solid 显示模式。

bpy.context.view_layer.is_locked_main

• 判断当前视图层是否锁定到主相机。

bpy.context.view_layer.set_active()

• 将当前视图层设置为活动视图层。

bpy.context.view_layer.objects

• 返回当前视图层中所有可见的物体。

bpy.context.view_layer.active

• 返回当前视图层中当前活动的物体。

示例

import bpy

# 获取当前场景中的激活视图层
view_layer = bpy.context.view_layer

# 输出当前活动的视图层名称
print(view_layer.name)

# 设置当前视图层的起始帧为1
view_layer.frame_start = 1

# 获取当前视图层所有可见的物体
objects = view_layer.objects
for obj in objects:
    print(obj.name)