Шрифт:
def invoke(self, context, event):
self.x = event.mouse_x
self.y = event.mouse_y
self.init_x = self.x
self.init_y = self.y
self.execute(context)
print(context.window_manager.modal_handler_add(self))
return {'RUNNING_MODAL'}
#
# Панель в районе tools
#
class MyModalPanel(bpy.types.Panel):
bl_label = "My modal operator"
bl_space_type = "VIEW_3D"
bl_region_type = "TOOLS"
def draw(self, context):
self.layout.operator("mine.modal_op")
# Регистрация
bpy.utils.register_module(__name__)
# Автоматически перемещает активный объект при запуске
bpy.ops.mine.modal_op('INVOKE_DEFAULT')
Invoke (вызов) против execute (выполнения)
Этот скрипт иллюстрирует разницу между invoke (вызывать) и execute (выполнять). Вызываемое (invoking) событие является аргументом функции
Operator.invoke
, который устанавливает два свойства целого типа x и y для положения мыши и вызывает функцию Operator.execute
. Как альтернатива, мы можем выполнить (execute) оператор и явно установить x
и y
: bpy.ops.wm.mouse_position(’EXEC_DEFAULT’, x=20, y=66
) Вместо вывода координат мыши в окно терминала, информация отправляется в информационную панель в верхнем правом углу. Это хорошее место для отображения краткого уведомления, так как пользователю не придется искать его в другом окне, тем более, что терминал/DOS-окно отображается не во всех версиях Blender. Однако длинные сообщения трудно вписываются в ограниченное пространство информационной панели.
#----------------------------------------------------------
# File invoke.py # from API documentation
#----------------------------------------------------------
import bpy
class SimpleMouseOperator(bpy.types.Operator):
""" Этот оператор показывает расположение мыши,
эта строка используется для подсказки (tooltip) и документирования API
"""
bl_idname = "wm.mouse_position"
bl_label = "Mouse location"
x = bpy.props.IntProperty
y = bpy.props.IntProperty
def execute(self, context):
# Вместо печати в консоли, используется функция report,
# таким образом, появляется сообщение в заголовке
self.report({'INFO'}, "Mouse coords are %d %d" % (self.x, self.y))
return {'FINISHED'}
def invoke(self, context, event):
self.x = event.mouse_x
self.y = event.mouse_y
return self.execute(context)
#
# Панель в районе tools
#
class MousePanel(bpy.types.Panel):
bl_label = "Mouse"
bl_space_type = "VIEW_3D"
bl_region_type = "TOOL_PROPS"
def draw(self, context):
self.layout.operator("wm.mouse_position")
#
# Регистрация
# Нет действительной необходимости регистрировать класс, потому что
# это происходит автоматически, когда регистрируется модуль.
# С другой стороны, это не повредит.
bpy.utils.register_class(SimpleMouseOperator)