Оператор wm.context_toggle предназначен для переключения состояния чекбоксов в интерфейсе Blender. С его помощью можно настроить быстрое переключение любых чекбоксов в любых окнах и панелях.
Для примера настроим включение/выключение отображения сетки (wireframe) во вьюпорте.
Оператор «wm.context_toggle» принимает в качестве первого аргумента текстовый указатель на свойство, описываемое чекбоксом, в Blender Python API.
Для чекбокса включающего и выключающего отображение сетки во вьюпорте этот путь выглядит следующим образом:
|
1 |
bpy.context.space_data.overlay.show_wireframes |
Обращение к нему при помощи оператора wm.context_toggle:
|
1 |
bpy.ops.wm.context_toggle(data_path='space_data.overlay.show_wireframes') |
Оператор контекстный, поэтому для правильной работы с чекбоксом окна 3D Viewport, он должен вызываться только из окна 3D Viewport. Также поэтому в пути к свойству нет необходимости указывать полный путь с контекстом bpy.context.space_data.overlay.show_wireframes, а достаточно указать лишь часть, после указания контекста.
В таком виде этот оператор можно назначить, например, на кнопку в пользовательской панели. Однако гораздо удобнее при помощи этого оператора назначать комбинации клавиш для быстрого переключения нужных чекбоксов.
Для того, чтобы связать включение/выключение сетки с нажатием клавиши на клавиатуре, в окне «Preferences» в разделе «KeyMap» в списке «3D View — Object Mode — Object Mode(Global)» создайте новый шорткод на подходящую комбинацию клавиш.
В поле «Identifier» нужно указать вызов самого оператора «wm.context_toggle», а в появившемся поле для аргумента «Context Attribute» ввести API-путь к нужному свойству «space_data.overlay.show_wireframes».
Теперь при нажатии указанной клавиши в окне вьюпорта будет включаться/выключаться отображение сетки на объектах.