Как добавить кнопку в хедер окна в Blender

С помощью Python API в Blender можно кастомизировать интерфейс, настроив его удобным для себя образом. Например, можно вынести наиболее часто используемые операторы в хедер (верхнее меню) любой рабочей области Таким образом можно собрать собственный риббон из “быстрых” кнопок.

.blend file on Patreon

Хедер каждой рабочей области (окна) в Blender описывается в API собственным типом. Например, хедер 3D вьюпорта описана в bpy.types.VIEW3D_HT_header.

Проще всего определить тип хедера у нужного окна, кликнув по любой кнопке на нем правой кнопкой мышки, в выпадающем меню выбрав “Edit Source” (должны быть включены Developer Extras в настройках) и открутив открывшийся в текстовом редакторе код вверх до определения класса.

Для основных рабочих областей Blender типы хедеров следующие:

3D Viewport – VIEW3D_HT_header

Image Editor – IMAGE_HT_header

UV Editor – IMAGE_HT_header

Compositor – NODE_HT_header

Texture Node Editor – NODE_HT_header

Geometry Node Editor – NODE_HT_header

Shader Editor – NODE_HT_header

Video Squiencer – SEQUENCER_HT_header

Movie Clip Editor – CLIP_HT_header

Dope Sheet – DOPESHEET_HT_header

Time Line – DOPESHEET_HT_header

Graph Editor – GRAPH_HT_header

Drivers – GRAPH_HT_header

Nonlinear Animation – NLA_HT_header

Text Editor – TEXT_HT_header

Python Console – CONSOLE_HT_header

Info – INFO_HT_header

Outliner – OUTLINER_HT_header

Properties – PROPERTIES_HT_header

File Browser – FILEBROWSER_HT_header

Asset Browser – FILEBROWSER_HT_header

Spreadsheet – SPREADSHEET_HT_header

Preferences – USERPREF_HT_header

Для того, чтобы добавить какие-либо элементы интерфейса в хедер, определим функцию для их отрисовки, аналогично функции “draw” для пользовательских панелей.

Например, кнопка для оператора, вставляющего в сцену дефолтный куб “bpy.ops.mesh.primitive_cube_add”:

@persistent
def TEST_HT_view3d(self, context):
    self.layout.operator(
        operator='mesh.primitive_cube_add',
        icon='MESH_CUBE',
        text=''
    )

@persistent

def TEST_HT_view3d(self, context):

self.layout.operator(

operator='mesh.primitive_cube_add',

icon='MESH_CUBE',

text=''

)

Чтобы функция не терялась при перезагрузке сцены, мы обернули ее в декоратор @persistent.

Теперь для размещения кнопки вызова этого оператора в хедере 3D вьюпорта, добавим нашу функцию в хедер командой “prepend”.

bpy.types.VIEW3D_HT_header.prepend(TEST_HT_view3d)

1	bpy.types.VIEW3D_HT_header.prepend(TEST_HT_view3d)

При использовании “prepend” все элементы интерфейса, определенные в нашей функции, будут отрисовываться в хедере перед его основными кнопками. Можно так же использовать функцию “append”, в этом случае все элементы из нашей функции будут отрисованы в хедере после его базовых кнопок.

Для того, чтобы убрать добавленные нами кнопки из хедера, нужно удалить нашу функцию, вызвав метод хедера “remove”:

bpy.types.VIEW3D_HT_header.remove(TEST_HT_view3d)

1	bpy.types.VIEW3D_HT_header.remove(TEST_HT_view3d)