bpy.context.tool_settings

bpy.context.tool_settings 是 blender 中的一个上下文数据路径。它包含了当前工具的设置和选项。

参考

3D Viewport

.use_occlude_geometry

类型：布尔值 (True/False)，默认值：True

当此值为True时，当前工具（如画笔或选择工具）将在选择容易看到的面时自动隐藏部分几何体。当此值为False时，所有几何体都将可见。

.use_mesh_automerge

类型：布尔值 (True/False)，默认值：False

当此值为True时，网格的自动合并功能将在执行大量编辑操作（例如细化模型）时自动开启。当此值为False时，所有合并操作必须手动执行。

图像/照片

.image_paint.use_global_strength

类型：布尔值 (True/False)，默认值：True

当此值为True时，笔刷的力度将在整个图像上均匀应用。当此值为False时，笔刷的力度将仅应用于当前绘画矩形内的像素。

.image_paint.use_locked_size

类型：布尔值 (True/False)，默认值：False

当此值为True时，在绘画时笔刷的大小将被锁定，以保持与图像缩放相同的大小。当此值为False时，笔刷大小可以随图像缩放而变化。

.image_paint.use_symmetry

类型：布尔值 (True/False)，默认值：False

当此值为True时，启用X/Y轴对称绘画。这需要在同一图层上绘制。

UV 编辑器

.uv_select_mode

类型：枚举

UV编辑器的选择模式。可选方案有：

• 'VERT' 顶点模式
• 'EDGE' 边界模式
• 'FACE' 表面模式

.use_uv_select_sync

类型：布尔值 (True/False)，默认值：True

当此值为True时，选择模式将与3D视图中的模式同步。当此值为False时，可以单独设置选择模式。

剪辑编辑器

.clip_editor.color_config.use_custom_colors

类型：布尔值 (True/False)，默认值：False

当此值为True时，启用自定义颜色。

.clip_editor.color_config.keyframe_border

类型：颜色

关键帧边框颜色。

.clip_editor.color_config.unselected_keyframe_border

类型：颜色

未选择关键帧的边框颜色。

.clip_editor.color_config.handle_border

类型：颜色

处理边框颜色。

.clip_editor.color_config.[..]_mute

类型：颜色

将[...]替换为“处理”、“关键帧”或“轨道”，可设置对应元素的静音颜色。

.clip_editor.color_config.[...].color

类型：颜色

将[...]替换为各个元素（如“处理”、“关键帧”或“轨道”），以设置对应元素的颜色。

.clip_editor.effect_type

类型：枚举

编辑器中使用的特效类型。可选项有：

• 'TRANSFORM' 变换
• 'MASK' 遮罩
• 'COLOR' 颜色
• 'CURVES' 曲线

示例

以下示例演示了如何使用 bpy.context.tool_settings 更改绘画笔刷大小：

import bpy

# 获取活动区域的工具设置
tool_settings = bpy.context.tool_settings

# 将笔刷大小设置为100
tool_settings.image_paint.brush.size = 100

参见

• bpy.context：Blender 上下文数据的详细文档。
• bpy.ops：Blender 操作的详细文档。