Blender 3D: уроки, статьи, заметки
Если нужный объект расположен в скрытой коллекции, в больших сценах бывает сложно его найти.
Для того, чтобы узнать, в какой коллекции размещается нужный объект по его типу, нужно выполнить следующий код.
Например для камеры:
|
1 2 3 |
[(obj.name, obj.users_collection) for obj in bpy.data.objects if obj.type=='CAMERA'] # [('Camera', (bpy.data.collections['camera'],))] |
Этот код вернет список камер и коллекций в которых они размещены.
Некоторые операторы в Blender можно вызывать только в той рабочей области, для которой они предназначены.
Если вызывать, например, оператор, предназначенный только для работы в области 3D вьюпорта в Python-консоли, оператор или просто не выполнится:
|
1 2 3 |
bpy.ops.wm.toolbar() # {'CANCELLED'} |
или вернет сообщение о неверном контексте:
|
1 2 3 |
bpy.ops.view3d.background_image_add() # RuntimeError: Operator bpy.ops.view3d.background_image_add.poll() failed, context is incorrect |
Однако выполнить операторы в “не родной” рабочей области все же можно. Для этого в любой оператор можно передать первым неявным параметром указание на контекст рабочей области, в которой должен быть выполнен этот оператор. Этот параметр обычно называют “переопределенный контекст”.
Для того, чтобы переключить активный инструмент из Т-панели в окне 3D вьюпорта нужно вызвать соответствующий оператор в параметре “name” которого нужно передать идентификатор idname требуемого инструмента.
Например для того, чтобы включить выделение окружностью Select Circle нужно вызвать оператор:
|
1 2 3 |
import bpy bpy.ops.wm.tool_set_by_id(name='builtin.select_circle') |
Читать далее «Как сменить текущий инструмент при помощи Blender Python API»
Модули, используемые в скриптах и аддонах Blender, располагаются или в той же директории, что и сам скрипт или аддон, или в директории установки Blender по пути “версия_blender\python\lib\”. Однако возможно подключить для работы и модуль, расположенный в другом месте на жестком диске.
Для этого нужно подключить модуль по его абсолютному пути.
Читать далее «Как подключить Python-модуль по абсолютному пути»
Если требуется привязать меш к кости арматуры так, чтобы меш сохранил свое текущее положение, при помощи Blender Python API, нужно выполнить следующие действия:
Читать далее «Как привязать меш к кости с сохранением текущего положения»
Для того, чтобы точно выровнять кость одной арматуры по кости другой арматуры нужно соотнести глобальные матрицы арматур и локальные матрицы костей в режиме позы.
Для этого нужно выполнить следующий код:
Читать далее «Как переместить кость арматуры на место кости другой арматуры»
Чаще всего для быстрых упрощенных расчетов с геометрией объектов используются их Bounding Box – минимальный параллелепипед, в который вписан данный объект. Однако. иногда большую точность и простоту в расчетах может дать Bounding Sphere – минимальная сфера, в которую можно вписать объект. И если размеры и расположение Bounding Box доступно в Blender для любого объекта сразу, Bounding Sphere необходимо рассчитывать самостоятельно.
Напишем функцию, которая на основании переданного объекта вернет нам координаты центра и радиус описывающей его Bounding Sphere.
Попытка инвертировать матрицу преобразования при помощи метода inverted() может привести к ошибке, если, например, на объект, для которого вычисляется исходная матрица оказывает влияние какой-нибудь ограничитель.
В этом случае Blender сгенерирует ошибку вида:
ValueError: Matrix.invert(ed): matrix does not have an inverse
К сожалению, интерфейс Blender не поддерживает перенос строк и многострочный вывод в текстовых полях. Слишком длинные для показа на панели текстовые строки обрезаются. Однако, текст в несколько строк все же можно вывести на панель интерфейса, используя несколько текстовых элементов вместо одного.
Для начала создадим простейшую панель в N-панели окне вьюпорта 3D Viewport и разместим на ней текстовый элемент label с нужным текстом.
Читать далее «Многострочный текст в панелях интерфейса Blender»
Модуль BPY plus для упрощения работы с именами объектов.
Чтобы получить количество вертексов, ребер и полигонов меша, можно просто взять их количество из нужного блока данных: vertices, edges и polygons. Однако в структуре меша нет отдельного блока данных под треугольники.
Для того, чтобы получить количество треугольников в меше, нужно выполнить следующий код:
Читать далее «Как получить количество треугольников для меша»
Камера в Blender всегда определяется двумя углами поля видимости FOV – вертикальным и горизонтальным.
Один из них всегда задается пользователем через параметр камеры – Feild of View (или комбинации параметров Focal Length и Sensor Width).
Читать далее «Вертикальный и горизонтальный углы FOV камеры»
Обновление fake-bpy-modules – модулей автокомплита Blender Python API от Nutti. Добавлена ветка для Blender 2.92.
Последний релиз от 04.03.2020
GitHub автора: https://github.com/nutti/fake-bpy-module
Файлы отдельно (без установки через pip) https://github.com/Korchy/blender_autocomplete
Для того, чтобы манипулировать трансформациями объектов при помощи матриц в Blender включен модуль “mathutils” в котором определен класс “Matrix”. С помощью этого класса можно удобно создавать нужные матрицы трансформаций – перемещения, поворота и масштаба.
Для создания матрицы масштабирования используется следующая команда:
|
1 2 3 |
from mathutils import Matrix scale_matrix = Matrix.Scale(SCALE_VALUE, MATRIX_SIZE, AXIS) |
Классический способ локализации аддона Blender (перевода аддона на разные языки) удобен тем, что для него требуется всего лишь одно обращение к Blender python API – получение текущей используемой локали. Он хорош своей независимостью, однако Blender не был бы Blender-ом, если бы не предоставил пользователям возможность локализации аддонов через свой API.
Принцип создания мультиязычных аддонов с использованием Blender python API по сути мало отличается от классического. Нам точно так же необходимо создать словарь со всеми вариантами перевода текстовых строк, используемых в нашем аддоне, и в дальнейшем пользоваться им для перевода.
При обращении к геометрии меша – его точкам, ребрам и полигонам, Blender оперирует исходными данными без учета наложенных на объект модификаторов.
Например количество точек для активного объекта, которое можно получить с помощью команды:
|
1 |
len(bpy.context.active_object.data.vertices) |
будет возвращено без учета наложенного на объект модификатора Subdivision, который подразделяет геометрию меша, увеличивая ее значения.
Читать далее «Как получить данные меша с учетом модификаторов»
Для того, чтобы выполнить переход по url-адресу из Blender – открыть нужный адрес в браузере, можно воспользоваться системным оператором wm.url_open.
Для демонстрации его работы создадим в N-панели простейшую вкладку с одной кнопкой, по нажатию на которую в браузере будет открываться нужная нам страничка.
Читать далее «Как сделать кнопку перехода по url-адресу в интерфейсе Blender»
Если нужно одновременно иметь доступ и к текущему контексту, например для работы с операторами, и к данным сцены, например для работы с мешами, мы обращаемся к двум предопределенным в Blender Python API структурам: “bpy.context” и “bpy.data”.
Например мы можем передать указатели на эти две структуры в функцию:
|
1 2 3 4 5 6 7 8 9 10 11 |
import bpy def my_func(context, scene_data): print(context, scene_data) my_func( context=bpy.context, scene_data=bpy.data ) # <bpy_struct, Context at 0x00000000050EF568> <bpy_struct, BlendData at 0x0000000007FA6408> |
Однако в структуре контекста “bpy.context” уже есть ссылка с именем “blend_data”, которая указывает на данные сцены. С помощью этого указателя можно обращаться к данным сцены, не передавая его отдельно в явном виде.
|
1 2 3 4 5 6 7 8 9 10 |
import bpy def my_func(context): print(context, context.blend_data) my_func( context=bpy.context, ) # <bpy_struct, Context at 0x00000000050EF568> <bpy_struct, BlendData at 0x0000000007FA6408> |
Для меша в Blender можно снимать и устанавливать выделение точек через свойство “select” для каждой точки.
Однако для снятия выделения с точки недостаточно установить значение свойства “select” точки равным “False”.
Модуль BPY plus для упрощения работы с мешами.
Если вы хотите, чтобы ваш аддон был доступен для всех пользователей Blender по всему миру, вам обязательно нужно предусмотреть его локализацию – перевод интерфейса на разные языки.
Простейший способ сделать ваш аддон мультиязычным – классический, он используется во многих программах и, к тому же, требует минимального обращения к Blender Python API.
Модуль BPY plus для упрощения работы с 3D объектами.
Модуль BPY plus для работы с трансформациями 3D объектов.
Модуль BPY plus для работы с ограничивающими формами.
Модуль BPY plus с информацией о самом BPY plus.
