blender-manual/manual/interface/operators.rst

1.4 KiB
Raw Permalink Blame History

Sphinx Warnings

6: WARNING: undefined label: 'bpy.types.uipopupmenu'
6: WARNING: undefined label: 'bpy.ops.wm.search_menu'
17: WARNING: undefined label: 'bpy.ops.screen.redo_last'

Note the preview is not accurate and warnings may not indicate real issues.

Operators

Operators execute an action the moment theyre activated, which makes them different from tools (which require some sort of input). Operators can be started from Ui operator buttons, bpy.types.UIPopupMenu, or bpy.ops.wm.search_menu. Examples of operators include adding a new object, deleting it, or setting its shading to smooth.

Operator Properties

Most operators have properties that can be adjusted to refine their result. First run the operator (which will use its default settings), then adjust the properties in the bpy.ops.screen.redo_last region.

Modal Operators

Modal operators exist as a concept in between Tools and regular operators. They require some sort of interactive input.

The action of a modal operator can be confirmed using LMB or Return. To cancel a modal operator use RMB or Esc.

Slider Operators

Slider operators are used to interactively adjust a percentage value in the editors Ui region header.

You can adjust the percentage by dragging the slider left or right. This can be made coarser (snapping in 10% increments) by holding Ctrl and more precise by holding Shift. For some sliders, you can toggle “overshoot” with E, which lets you go beyond the 0-100% range.