В Blender 2.8 кнопка блокировки трансформаций мешей (Manipulate center points) перемещена в N-панель во вкладку “Tool” (Options – Transform – Affect only – Locations) и ее вид изменен с кнопки на чекбокс.
В API Blender 2.79 созданный объект добавляется в сцену через:
|
1 |
bpy.context.scene.objects.link(new_object) |
Попытка добавить объект в сцену таким образом в Blender 2.80, приводит к ошибке:
‘bpy_prop_collection’ object has no attribute ‘link’
В Blender 2.80 API добавлять объект нужно не в саму сцену, а в ее коллекции.
Добавить объект в активную коллекцию:
|
1 |
bpy.context.scene.collection.objects.link(new_object) |
Добавить объект в коллекцию по ее имени:
|
1 |
bpy.data.collections['collection_name'].objects.link(new_object) |
2.79: выбор производится правой кнопкой мышки
2.80: выбор производится левой кнопкой мышки
2.79: вызывалась нажатием клавиши t
2.80: теперь ее нет, функции переместились в основное меню или в контекстное меню по нажатию на правую кнопку мышки
2.79: a – выделить всё и снять всё выделение
2.80: a – выделить всё, a – a или alt+a – снять всё выделение
В API Blender 2.8 ужесточаются требования к наименованию классов и их идентификаторов. Имя класса должно соответствовать следующему шаблону:
|
1 |
UPPER_CASE_{SEPARATOR}_mixed_case |
Где {SEPARATOR} – две буквы, обозначающие принадлежность класса к определенному типу (от какого типа наследуется класс):
Идентификатор класса “bl_idname” должен соответствовать имени класса.
В Blender 2.7 регистрация и разрегистрация аддонов через Python API производилась через Window manager – wm:
|
1 2 3 4 5 |
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:
|
1 2 3 4 5 |
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-курсора
|
1 |
context.scene.cursor_location |
в Blender 2.8 перенесено в объект курсора
|
1 |
context.scene.cursor.location |
При попытке обращения к позиции курсора через “context.scene.cursor_location” Blender выдаст ошибку:
‘Scene’ object has no attribute ‘cursor_location’
В Blender 2.7 для умножения матриц, кватернионов и векторов использовался оператор “*” (звездочка). В Blender 2.8 API он заменен на оператор “@” (ат).
При попытке использования оператора “*” для умножения матриц, векторов или кватернионов, Blender 2.8 сигнализирует ошибкой:
Element-wise multiplication: not supported between ‘Matrix’ and ‘Matrix’ types
Пример использования оператора “@”:
|
1 |
bpy.context.region_data.view_rotation @ Vector((0.0, 0.0, 1.0)) |
Свойство, указывающее на выбранный тип привязки в Blender 2.7
|
1 |
bpy.context.scene.tool_settings.snap_element |
в Blender 2.8 изменилось на
|
1 2 |
bpy.context.scene.tool_settings.snap_elements # {'EDGE'} |
Указание опорной точки в Blender 2.7
|
1 2 |
bpy.context.area.spaces[0].pivot_point # 'BOUNDING_BOX_CENTER': |
в Blender 2.8 API перемещено в:
|
1 2 |
bpy.context.scene.tool_settings.transform_pivot_point # 'MEDIAN_POINT' |
Свойство use_drag_immediately в Blender 2.7
|
1 |
bpy.context.preferences.edit.use_drag_immediately |
в Blender 2.8 API перемещено в
|
1 2 |
bpy.context.preferences.inputs.use_drag_immediately # True |
Обращение к текущей используемой системе координат, которое в Blender 2.7 осуществлялось через
|
1 |
bpy.context.space_data.transform_orientation |
в Blender 2.8 перенесено в коллекцию объектов TransformOrientatiosSlots. Для получения и изменения текущей системы координат нужно обращаться к объектам коллекции сцены transform_orientation_slots.
|
1 2 3 4 5 6 7 8 |
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 вместо своства context.scene используется context.view_layer.
При попытке сделать меш активным через “bpy.context.scene.objects.active” Blender сигнализирует ошибкой:
AttributeError: bpy_prop_collection: attribute “active” not found
Чтобы сделать объект активным, нужно использовать следующую команду:
|
1 2 |
obj = bpy.context.window.scene.objects[0] bpy.context.view_layer.objects.active = obj # obj is the active object now |
В связи с изменениями Blender API в версии 2.8 выбор меша (объекта) теперь осуществляется с помощью геттера/сеттера.
При попытке проверить выбран ли объект через “bpy.context.active_object.select” Blender сигнализирует ошибкой:
AttributeError: ‘Object’ object has no attribute ‘select’
Для проверки, является ли объект выбранным в Blender 2.8 нужно использовать геттер:
|
1 2 |
bpy.context.active_object.select_get() # True |
Для того, чтобы выделить объект в Blender 2.8 нужно использовать сеттер:
|
1 |
bpy.context.active_object.select_set(state=True) |
Для снятия выбора нужно использовать тот же сеттер:
|
1 |
bpy.context.active_object.select_set(state=False) |
В API последней версии Blender 2.8 разработчики внесли множество изменений, поэтому практически все скрипты и аддоны, написанные для более ранних версий Blender (2.7 и ниже), перестали работать. Для того, чтобы пользоваться полюбившимися аддонами в новой версии Blender, их нужно портировать – исправить их код для корректной работы с новым API Blender.
Изменения, которые необходимо внести в код аддона, чтобы он заработал в Blender 2.80:
Портирование аддона для Blender 2.7 в Blender 2.8Read More »