Blender 3D: уроки, статьи, заметки
Обновление 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.
Удаление коллекций в Blender осуществляется через список коллекций в bpy.data.
Для того, чтобы удалить коллекцию нужно вызвать метод “remove” для списка коллекций сцены, указав в параметрах коллекцию, которую нужно удалить:
Назначение ограничителей (констрейнтов) на объекты производится через свойство объекта “constraints”.
Для того, чтобы назначить ограничитель на текущий активный объект, нужно создать новый констрейнт в списке “constraints” объекта, указав в параметрах его тип:
Читать далее «Как назначить на объект констрейнт при помощи Blender Python API»
Для повышения удобства разработки аддонов Blender с помощью Microsoft Visual Studio Code в этой IDE можно подключить автодополнение кода для стандартных типов API Blender.
Метод подключения автодополнения кода предложен Zen3515.
Обновление fake-bpy-modules – модулей автокомплита Blender Python API от Nutti. Добавлена ветка для Blender 2.91.
Последний релиз от 16.12.2020
GitHub автора: https://github.com/nutti/fake-bpy-module
Файлы отдельно (без установки через pip) https://github.com/Korchy/blender_autocomplete
Значения угла камеры в Blender могут устанавливаться как в миллиметрах – параметр Focal Length, так и в градусах – параметр Field of View.
Для того, чтобы получить Field of View в градусах имея значение Focal Length в миллиметрах, можно впользоваться следующей формулой:
Читать далее «Как получить FOV камеры в градусах из длины фокуса в мм»
Работа с группами точек для текущего активного объекта осуществляется через его структуру “vertex_groups”.
|
1 |
bpy.context.active_object.vertex_groups |
Для того, чтобы создать новую развертку для меша при помощи Blender Python API и задать точкам развертки определенные координаты, нужно:
Создать собственно развертку с нужным именем:
|
1 |
new_uv = bpy.context.active_object.data.uv_layers.new(name='NewUV') |
Далее, для задания координат точек развертке, нужно пройтись по всем “лупам” меша:
Читать далее «Как создать развертку для меша через Blender Python API»
Получить список координат точек развертки меша может понадобиться, например, при экспорте меша из внутреннего формата Blender в какой-нибудь внешний формат.
Список разверток, имеющихся у меша, можно получить, обратившись к элементу uv_layers:
|
1 2 3 |
bpy.context.object.data.uv_layers[:] # [bpy.data.meshes['Cube'].uv_layers["UVMap"], bpy.data.meshes['Cube'].uv_layers["UVMap.001"]] |
Читать далее «Как получить список координат точек UV-развертки»
Для того, чтобы удалить объект из сцены Blender средствами Python API нужно выполнить следующие действия:
Откроем окно текстового редактора “Text Editor”.
Получить все доступные шейдерные ноды в виде списка можно по их типу.
Для начала, добавим в сцену любой объект, например – куб, создадим для него материал и удалим из него все ноды. Сюда, в этот материал, мы выведем все имеющиеся в Blender ноды шейдеров.
Для добавления оператора в заголовок (header) окна используются функции append и prepend в которых параметром нужно указать функцию отрисовки кнопки вызова оператора.
Например, чтобы добавить в заголовок окна вьюпорта (3D View) кнопку вызова оператора добавления в сцену куба, нужно определить функцию отрисовки оператора:
|
1 2 |
def cube_add_fnc(self, context): self.layout.operator('mesh.primitive_cube_add', text='', icon='MESH_CUBE') |
и добавить ее в заголовок окна:
|
1 |
bpy.types.VIEW3D_HT_header.prepend(cube_add_fnc) |
Кнопка с оператором добавления куба в сцену появится в заголовке окна вьюпорта.
Просмотреть список всех функций, добавляющий операторы в заголовок окна можно с помощью свойства _draw_funcs метода draw.
|
1 2 |
bpy.types.VIEW3D_HT_header.draw._draw_funcs # [<function cube_add_fnc at 0x000000000FC8B8B8>, <function VIEW3D_HT_header.draw at 0x000000000F9C0678>, <function draw_pause at 0x0000000011633A68>] |
Обратите внимание, что свойство _draw_funcs определяется в методе draw только если в него добавлены пользовательские операторы. Если пользовательские операторы не в заголовок не добавлялись, будет выдана ошибка
AttributeError: ‘function’ object has no attribute ‘_draw_funcs’
