bpy.ops.gizmogroup.gizmo_tweak

描述

这是一个用于在Blender中拖动和移动对象的工具。它可以通过 Python API 中的 bpy.ops.gizmogroup.gizmo_tweak 调用。

参数

• axis_move：指示在哪个轴向上移动对象。默认值是(False, False, False)，表示不允许沿任何轴向移动对象。
• axis_lock：指示在哪个轴向上锁定移动对象。默认值是(False, False, False)，表示不锁定任何轴向。
• constraint_axis：一个元组，包含允许移动对象的轴线。默认值为(False, False, False)，表示不允许沿任何轴向移动对象。
• snap：指定将移动对象与其他场景元素对齐的选项。默认为bpy.context.scene.tool_settings.snap_elements。
• gpencil_stroke_mode：如果对象是 GreasePencil 笔画，则允许对笔画进行修改。默认为bpy.context.scene.tool_settings.gpencil_tweak_mode。
• cursor_transform：允许在移动对象时对 3D 光标进行修改。默认值为False。
• snap_target：指示应该将对象捕捉到哪些场景元素。默认为bpy.types.Scene.tool_settings.snap_target.
• snap_align：指示对象是否应该移动到最接近的网格或边缘。默认值为False。

示例

import bpy

# 选择对象
bpy.ops.object.select_all(action='DESELECT')
bpy.context.view_layer.objects.active = bpy.data.objects['Cube']
bpy.data.objects['Cube'].select_set(True)

# 启用gizmo_tweak工具
bpy.ops.gizmogroup.gizmo_tweak(
    axis_move=(False, False, True), 
    axis_lock=(False, False, False), 
    constraint_axis=(False, False, True)
)

注意事项

• 该工具只能在3D视图中使用。
• 该工具必须与对象配合使用，因此在使用之前，必须先选择要移动的对象。