from 2.7 to 2.8 — Blender

Изменения в регистрации аддонов через API в Blender 2.8

В Blender 2.7 регистрация и разрегистрация аддонов через Python API производилась через Window manager — wm:

bpy.ops.wm.addon_install(filepath='_path_to_addon', overwrite=True)

bpy.ops.wm.addon_enable(module='addon_name')

bpy.ops.wm.addon_remove(module='addon_name')

bpy.ops.wm.addon_install(filepath='_path_to_addon', overwrite=True)

bpy.ops.wm.addon_enable(module='addon_name')

bpy.ops.wm.addon_remove(module='addon_name')

В Blender 2.8 API операторы работы с аддонами перенесены в preferences:

bpy.ops.preferences.addon_install(filepath='_path_to_addon', overwrite=True)

bpy.ops.preferences.addon_enable(module='addon_name')

bpy.ops.preferences.addon_remove(module='addon_name')

bpy.ops.preferences.addon_install(filepath='_path_to_addon', overwrite=True)

bpy.ops.preferences.addon_enable(module='addon_name')

bpy.ops.preferences.addon_remove(module='addon_name')

Положение 3D курсора в Blender 2.8 Python API

Свойство, указывающее на местоположение 3D-курсора

context.scene.cursor_location

1	context.scene.cursor_location

в Blender 2.8 перенесено в объект курсора

context.scene.cursor.location

1	context.scene.cursor.location

При попытке обращения к позиции курсора через «context.scene.cursor_location» Blender выдаст ошибку:

‘Scene’ object has no attribute ‘cursor_location’

Умножение матриц, векторов, кватернионов в Blender 2.8 Python API

В Blender 2.7 для умножения матриц, кватернионов и векторов использовался оператор «*» (звездочка). В Blender 2.8 API он заменен на оператор «@» (ат).

При попытке использования оператора «*» для умножения матриц, векторов или кватернионов, Blender 2.8 сигнализирует ошибкой:

Element-wise multiplication: not supported between ‘Matrix’ and ‘Matrix’ types

Пример использования оператора «@»:

bpy.context.region_data.view_rotation @ Vector((0.0, 0.0, 1.0))

1	bpy.context.region_data.view_rotation @ Vector((0.0, 0.0, 1.0))

Доступ к элементам привязки в Blender 2.8 Python API

Свойство, указывающее на выбранный тип привязки в Blender 2.7

bpy.context.scene.tool_settings.snap_element

1	bpy.context.scene.tool_settings.snap_element

в Blender 2.8 изменилось на

bpy.context.scene.tool_settings.snap_elements
# {'EDGE'}

1 2	bpy.context.scene.tool_settings.snap_elements # {'EDGE'}

Указание центральной точки в Blender 2.8 Python API

Указание опорной точки в Blender 2.7

bpy.context.area.spaces[0].pivot_point
# 'BOUNDING_BOX_CENTER':

1 2	bpy.context.area.spaces[0].pivot_point # 'BOUNDING_BOX_CENTER':

в Blender 2.8 API перемещено в:

bpy.context.scene.tool_settings.transform_pivot_point
# 'MEDIAN_POINT'

1 2	bpy.context.scene.tool_settings.transform_pivot_point # 'MEDIAN_POINT'

Свойство use_drag_immediately в Blender 2.8 Python API

Свойство use_drag_immediately в Blender 2.7

bpy.context.preferences.edit.use_drag_immediately

1	bpy.context.preferences.edit.use_drag_immediately

в Blender 2.8 API перемещено в

bpy.context.preferences.inputs.use_drag_immediately
# True

1 2	bpy.context.preferences.inputs.use_drag_immediately # True

Переключение системы координат в Blender 2.8 Python API

Обращение к текущей используемой системе координат, которое в Blender 2.7 осуществлялось через

bpy.context.space_data.transform_orientation

1	bpy.context.space_data.transform_orientation

в Blender 2.8 перенесено в коллекцию объектов TransformOrientatiosSlots. Для получения и изменения текущей системы координат нужно обращаться к объектам коллекции сцены transform_orientation_slots.

bpy.context.window.scene.transform_orientation_slots[0].type

# 'GLOBAL'

bpy.context.window.scene.transform_orientation_slots[0].type = 'LOCAL'
bpy.context.window.scene.transform_orientation_slots[0].type

# 'LOCAL'

bpy.context.window.scene.transform_orientation_slots[0].type

# 'GLOBAL'

bpy.context.window.scene.transform_orientation_slots[0].type = 'LOCAL'

bpy.context.window.scene.transform_orientation_slots[0].type

# 'LOCAL'

Как сделать объект (меш) активным в Blender 2.8 Python API

Для того, чтобы сделать меш (объект) активным в Blender 2.8 Python API вместо своства context.scene используется context.view_layer.

При попытке сделать меш активным через «bpy.context.scene.objects.active» Blender сигнализирует ошибкой:

AttributeError: bpy_prop_collection: attribute «active» not found

Чтобы сделать объект активным, нужно использовать следующую команду:

obj = bpy.context.window.scene.objects[0]
bpy.context.view_layer.objects.active = obj    # obj is the active object now

1 2	obj = bpy.context.window.scene.objects[0] bpy.context.view_layer.objects.active = obj # obj is the active object now

Выбор объекта (меша) в Blender 2.8 Python API

В связи с изменениями Blender API в версии 2.8 выбор меша (объекта) теперь осуществляется с помощью геттера/сеттера.

При попытке проверить выбран ли объект через «bpy.context.active_object.select» Blender сигнализирует ошибкой:

AttributeError: ‘Object’ object has no attribute ‘select’

Для проверки, является ли объект выбранным в Blender 2.8 нужно использовать геттер:

bpy.context.active_object.select_get()
# True

1 2	bpy.context.active_object.select_get() # True

Для того, чтобы выделить объект в Blender 2.8 нужно использовать сеттер:

bpy.context.active_object.select_set(state=True)

1	bpy.context.active_object.select_set(state=True)

Для снятия выбора нужно использовать тот же сеттер:

bpy.context.active_object.select_set(state=False)

1	bpy.context.active_object.select_set(state=False)

Портирование аддона для Blender 2.7 в Blender 2.8

В API последней версии Blender 2.8 разработчики внесли множество изменений, поэтому практически все скрипты и аддоны, написанные для более ранних версий Blender (2.7 и ниже), перестали работать. Для того, чтобы пользоваться полюбившимися аддонами в новой версии Blender, их нужно портировать — исправить их код для корректной работы с новым API Blender.

Изменения, которые необходимо внести в код аддона, чтобы он заработал в Blender 2.80:

Читать далее «Портирование аддона для Blender 2.7 в Blender 2.8»