Python

Кнопки мультивыбора в пользовательской панели в Blender

При проектировании пользовательского UI в аддонах и расширениях в Blender чаще всего используются кнопки-селекторы для выбора одного значения из установленного набора. Такое поведение обычно называют «радио-батн». Однако иногда нужно сделать так, чтобы из предложенного списка значений пользователь мог выбрать сразу несколько. То есть, сделать такой ряд чекбоксов, объединенных в один блок. Это можно легко осуществить используя свойство EnumProperty.

Универсальная функция для деселекта геометрии в базовом меше и в BMesh

При работе с объектами сцены в Blender через Python API часто приходится манипулировать как базовыми структурами объектов — Mesh, так и более продвинутой версией — BMesh. Формат снятия выбора с точек, ребер и полигонов у обоих структур немного различается, но мы можем сделать простую универсальную функцию деселекта, которая будет корректно обрабатывать оба случая.

Определяем, в какие максимально удаленные тайлы, попадает UV развертка в Blender

Обычно развертка меша в Blender ограничивается базовым тайлом — сектором с координатами от нуля до единицы. Однако при необходимости развертку можно легко масштабировать так, чтобы ее точки выходили за указанные пределы. При этом, для того, чтобы не сбивать тайлинг текстур, бывает нужно знать, на сколько именно тайлов растянулась развертка по всем четырем направлениям. Определить, насколько тайлов развертка отстоит от базового можно при помощи несложного скрипта.

Многострочные текстовые поля на пользовательских UI панелях

Если раньше для отображения многострочного текста на пользовательских панелях в UI Blender приходилось прибегать к обходным методам, то начиная с версии 5.2 разработчики предусмотрели специальный вид поля в UI, в которое можно выводить текст в несколько строк.

Делаем выбранные ребра в меше последовательно активными

Многие операторы в Blender Python API работают отталкиваясь от текущего активного элемента — точки, ребра или полигона. Но очень часто возникает необходимость выполнить такой оператор несколько раз для нескольких выделенных, а не активных, элементов. Чтобы это сделать, нужно последовательно в цикле делать каждый из выделенных элементов активным, и вызывать нужный оператор.

Добавляем HTML ссылку на пользовательскую панель в Blender

Раньше разработчики аддонов и расширений могли указывать ссылку, например, на форму обратной связи или на сайт с дополнительной информацией и документацией только в информации по самому аддону/расширению. Ссылка отображалась в виде кнопки в информационном блоке в рабочей области Preference — Add-ons. С версии Blender 5.2 разработчики сделали возможность размещения HTML-ссылок в любом месте на панелях UI.

Ищем самую верхнюю кость в риге при помощи Blender Python API

При работе со сложным ригом, бывает необходимо быстро найти самую верхнюю кость. Так как все кости в риге связаны между собой через систему родитель-ребенок, можно написать простой скрипт, который пройдет по всей иерархии, начиная от текущей активной кости, и найдет самую верхнюю кость.

Выделяем висящую геометрию в Blender

Так называемая «не-манифолд» геометрия в 3D-объектах, это отдельные, висящие в пространстве, точки, ребра или полигоны, а так же отверстия в сплошном меше, выделяется в Blender через пункт меню 3D-вьюпорта: Select — Select All By Trait — Non Manifold. Также эту команду можно выполнить при помощи Blender Python API через оператор bpy.ops.mesh.select_non_manifold(). Если же мы работаем с геометрией через объект BMesh, в нем такого специального оператора не предусмотрено. Однако мы можем выделить такую не-манифолд геометрию самостоятельно.

Создаем полигон через BMesh и назначаем его точкам UV-координаты

Создавая новую геометрию в Blender при помощи Python API очень часто нужно не просто создавать новые полигоны, а еще и сразу присваивать им правильные координаты UV-развертки. При работе через объект BMesh это делается через связку точек геометрии с точками развертки мешлупами.

Определяем активный полигон в объекте BMesh

Объект BMesh безусловно обладает большей функциональностью и возможностями для работы с данными мешей по сравнении со стандартным набором данных, хранящимся в свойстве data объекта. Однако некоторые моменты управления данными меша в объекте BMesh не всегда очевидны. Рассмотрим, на пример, достаточно тривиальная операция по получению текущего активного полигона.