Blender 3D: уроки, статьи, заметки
При разработке аддонов иногда необходимо использовать пакеты, не входящие в базовый набор Python-интерпретатора Blender. Чаще всего нужные пакеты входят в в Python Package Index (PyPI) и могут быть установлены в Blender через систему управления пакетами Pip.
Менеджер пакетов Pip изначально уже установлен в Blender. Однако Blender не позволяет вызвать команду установки нужного пакета обычным способом “pip install имя_пакета”.
Читать далее «Как установить нужные пакеты через pip в Blender»
Обновление модулей автокомплита Blender Python API от Nutti – добавлена ветка для Blender 2.83.
Последний релиз от 2020.07.24.
GitHub автора: https://github.com/nutti/fake-bpy-module
Файлы отдельно (без установки через pip) https://github.com/Korchy/blender_autocomplete
Для управления поворотом объекта служит свойство “rotation_euler”. Оно представляет собой список из трех значений, каждое из которых соответствует повороту вокруг координатных осей в радианах. В rotation_euler[0] хранится поворот вокруг оси X, в rotation_euler[1] – вокруг оси Y и в rotation_euler[2] – вокруг оси Z. Для того, чтобы повернуть объект вдоль нужной оси на нужный угол, нужно задать значение поворота в радианах в соответствующем нужной оси поле rotation_euler.
Например, чтобы повернуть активный объект вокруг оси X на 90 градусов, нужно выполнить следующий код:
|
1 2 |
import math bpy.context.active_object.rotation_euler[0] = math.radians(90) |
math.radians удобно использовать для преобразования угла из градусов в радианы.
Режим отображения flat/smoot моделей регулируется через свойство “use_smooth” для каждого полигона модели.
Для того, чтобы включить режим сглаженного (smooth) отображения полигонов, нужно для каждого полигона установить свойство “use_smooth” равным True.
Для активного объекта:
|
1 |
bpy.context.object.data.polygons.foreach_set('use_smooth', [True] * len(bpy.context.object.data.polygons)) |
Чтобы установить режим отображения флэт (flat) – для каждого полигона нужно установить “use_smooth” равным False.
|
1 |
bpy.context.object.data.polygons.foreach_set('use_smooth', [False] * len(bpy.context.object.data.polygons)) |
Чтобы изменение отобразилось на экране, нужно вызвать обновление данных объекта.
|
1 |
bpy.context.object.data.update() |
Для переключения к виду из камеры нужно выполнить следующую команду:
|
1 |
bpy.ops.view3d.view_camera() |
Данный оператор работает в режиме “тоггл”, поэтому его повторное выполнение вернет вид в окне к предыдущему состоянию.
Читать далее «Переключение на вид из камеры через Python API»
Для того, чтобы перейти из глобальной системы координат в локальную систему координат объекта нужно умножить глобальные координаты на инвертированную матрицу объекта:
|
1 2 3 4 5 |
import copy object_matrix_inverted = copy.copy(bpy.context.object.matrix_world) object_matrix_inverted.invert() cursor_location_local = object_matrix_inverted @ bpy.context.scene.cursor.location |
Для того, чтобы перейти из локальной системы координат объекта в глобальную систему координат нужно умножить локальные координаты на матрицу объекта:
|
1 2 3 4 5 |
import copy object_matrix = copy.copy(bpy.context.object.matrix_world) vertex_0 = bpy.context.object.data.vertices[0].co vertex_0_global = object_matrix @ vertex_0 |
Для тех, кто хочет разобраться в том, “как устроен Blender”, для написания своих собственных скриптов или аддонов, разработчики предусмотрели очень удобную возможность – просматривать код любого элемента интерфейса в один клик.
Для того, чтобы посмотреть код какого-либо элемента, в отдельном окне Blender откройте текстовый редактор “Text Editor”, затем просто кликните на нужном элементе правой кнопкой мышки и выберете “Edit Source”.
В линейке Blender 2.8x система отмены операций undo/redo (ctrl+z / ctrl+shift+z) была полностью переделана по сравнению с линейкой 2.7x. Одним из результатов такого изменения API является то, что при выполнении операции отмены все объекты в сцене перестраиваются заново – текущий объект уничтожается, а вместо него создается совершенно новый объект. Ссылки, которые указывали на старый объект, до выполнения операции отмены, после нее указывают на невалидный объект с которым больше нельзя работать.
Читать далее «Ссылки на объекты ломаются при использовании отмены ctrl+z»
Часто элементы интерфейса, размещаемые в пользовательских панелях, не соответствуют друг другу по размерам, в результате чего общая компоновка панели выглядит не красиво. В качестве наглядного примера создадим пользовательскую панель и разместим на ней кнопку оператора и текстовое поле ввода.
Выровнять размеры кнопки и поля ввода здесь напрашивается само собой.
Читать далее «Выравнивание элементов пользовательского интерфейса по колонкам»
Для того чтобы получить список коллекций со всеми внутренними коллекциями, можно использовать следующую функцию:
|
1 2 3 4 |
def collections(collection, col_list): col_list.append(collection) for sub_collection in collection.children: collections(sub_collection, col_list) |
Когда по нажатию кнопки в кастомном UI вы вызываете оператор и передаете в него нужные параметры, обратите внимание на то, что только указанные явно параметры будут переданы в оператор. Остальные параметры останутся со значениями по умолчанию.
Например, нам нужно вызвать оператор “transform_apply” – применение трансформаций к объекту, указав применить только масштаб.
Если мы вызовем оператор следующим образом:
|
1 2 3 4 5 6 7 8 9 |
class TESTPANEL_PT_panel(Panel): bl_idname = 'TESTPANEL_PT_panel' bl_label = 'Testpanel' bl_space_type = 'VIEW_3D' bl_region_type = 'UI' bl_category = 'Testpanel' def draw(self, context): self.layout.operator('context.object.transform_apply', text='Apply Scale').scale = True |
К объекту все равно будут применены все трансформации (масштаб, вращение и положение).
Иногда для эффективного распределения нагрузки на “железо” бывает нужно запустить рендер из Blender только на определенных видеокартах их нескольких имеющихся.
Для этого можно использовать несложный скрипт, в котором указать номера используемых для рендера устройств.
Читать далее «Рендер из консоли только на определенных GPU-картах»
Обновление модулей автокомплита Blender Python API от Nutti – добавлена ветка для Blender 2.81a.
Последний релиз от 2020.01.11.
GitHub автора: https://github.com/nutti/fake-bpy-module
Файлы отдельно (без установки через pip) https://github.com/Korchy/blender_autocomplete
При работе с геометрией меша может появится необходимость назначить каждому вертексу дополнительные свойства или данные, которые должны записываться в blend-файл при сохранении, и к которым нужно иметь доступ.
Однако попытка назначить вертексам нужные данные стандартным способом, через создание кастомных свойств, оборачивается неудачей. Вместо кастомного свойства для вертекса создается лишь кортеж со ссылкой на тип задаваемого свойства.
Для манипуляций с размерами и положением интерфейсных окон в Blender предусмотрен ряд операторов.
Чтобы разделить текущее (с текущим context) окно на два в заданном соотношении, нужно выполнить оператор:
|
1 |
bpy.ops.screen.area_split(direction='VERTICAL', factor=0.5) |
Где:
Читать далее «Как разделить и объединить окна в Blender через python API»
API Blender предоставляет для использования набор простых типов свойств, описанных в bpy.props (IntProperty, BoolProperty и т.д.). Но базовых типов не всегда хватает, иногда нужны более сложные. API Blender позволяет группировать простые свойства, создавая таким образом более сложные.
Рассмотрим создание такого свойства на примере матрицы 3х3.
Для того, чтобы получить текущую версию Blender, нужно выполнить команду:
|
1 2 3 |
bpy.app.version # (2, 81, 16) |
или
|
1 2 3 |
bpy.app.version_string # '2.81 (sub 16)' |
Читать далее «Как узнать текущую версию Blender через Python API»
API Blender предоставляет возможность рисовать в окне вьюпорта (3D Viewport) при помощи модуля gpu.
Для примера нарисуем в центре сцены упрощенный виджет системы координат, состоящий из трех линий разного цвета.
К нажатию кнопки в пользовательском интерфейсе обычно привязывают вызов нужного оператора. Однако часто действия, которые нужно выполнить при нажатии на кнопку, достаточно просты и не требуют оформления в виде отдельного оператора. Да и забивать стек зарегистрированных операторов множеством специфических операторов, рассчитанных на выполнение одной конкретной узкоспециализированной функции не имеет смысла. Гораздо удобнее было бы связать нажатие кнопки с вызовом отдельной функции, однако API Blender позволяет связывать кнопки только с вызовом оператора.
Обойти проблему создания отдельного оператора под каждую кнопку можно, воспользовавшись тем, что оператор можно вызывать с указанием входных параметров.
Читать далее «Как привязать к нажатию кнопки вызов функции, а не оператора»
Для корректного задания значений свойству типа EnumProperty необходимо знать все его возможные варианты.
Если попытаться задать значение, которого нет в перечислимом свойстве, Blender выдаст ошибку вида:
TypeError: bpy_struct: item.attr = val: enum “xxx” not found in (‘value_001′, value_002’, …)
где:
xxx – значение, которые мы попытались задать свойству EnumProperty
value_001, value_002, … – возможные значения, которые может принимать данное свойство EnumProperty
Читать далее «Как получить все возможные значения свойства Enum»
Для того, чтобы передвинуть курсор к определенному вертексу меша нужно выполнить следующий код:
|
1 |
bpy.context.scene.cursor.location = bpy.context.object.matrix_world @ bpy.context.object.data.vertices[_VERTEX_NUMBER_].co |
Умножение на матрицу мира должно осуществляться именно в таком порядке (матрица слева).
В 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) |
Чтобы поставить курсор в начало активного стрипа в Blender VSE нужно выполнить команду:
|
1 |
bpy.context.scene.frame_current = bpy.context.scene.sequence_editor.active_strip.frame_start |
Чтобы переместить курсор в конец активного стрипа:
|
1 |
bpy.context.scene.frame_current = bpy.context.scene.sequence_editor.active_strip.frame_final_end |
При создании собственных операторов иногда бывает нужно передавать в них определенные значения – вызывать операторы с параметрами.
Передаваемый параметр должен быть определен, как свойство оператора.
Для переноса выделения с UV-развертки на меш достаточно вспомнить, что развертка напрямую связана с мешем через мешлупы.
Чтобы перенести выделение с развертки на меш нужно пройти по полигонам меша, проверить, какие мешлупы выделены и выделить соответствующие им точки на самом меше.