BPY plus

BPY plus – набор модулей, расширяющий Blender Python API.

BPY plus – это Open Source проект, основанный на Blender bpy и расширяющий его несколькими новыми возможностями, а также упрощающий использование некоторых базовых функций.

Лицензия и использование

BPY Plus распространяется под лицензией GNU GPL 3.

BPY plus можно бесплатно использовать в любых проектах.

Поддержка

Проект развивается и дополняется новыми модулями, за счет поддержки на Patreon. Вы можете выбрать любой уровень. Специальный уровень BPY Plus support предоставляет вам специальную роль и цвет в Discord чате B3D Interplanety.

Модули BPY plus

about – модуль с информацией о самом BPY plus.
bounding – модуль для работы с ограничивающими формами.
collections – модуль для упрощения работы с коллекциями
color – модуль для работы с цветом.
context – модуль для работы с контекстом
file_system – модуль для работы с файловой системой.
props – набор модулей, добавляющих дополнительные Property типы
math – модуль с математическими функциями
mesh – модуль для упрощения работы с объектами типа “mesh”
names – модуль для упрощения работы с именами объектами.
objects – модуль для упрощения работы с 3D объектами.
output – модуль для получения выходных данных по рендеру
render – модуль для работы с рендерингом.
transform – модуль для работы с трансформациями 3D объектов.
vse – модуль для упрощения работы с Video Sequence Editor (VSE)

Пример использования

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

from bpy_plus import *

1	from bpy_plus import *

и далее вызывать нужный функционал.

Например, для нахождения ограничивающей сферы (bounding sphere) импортируем класс “Bounding” из модуля bpy_plus “bounding”:

from bpy_plus.bounding import Bounding

1	from bpy_plus.bounding import Bounding

Рассчитаем ограничивающую сферу вокруг выделенных объектов при помощи метода “sphere”:

import bpy

b_sphere = Bounding.sphere(
    objects=bpy.context.selected_objects,
    mode='GEOMETRY'
)

import bpy

b_sphere = Bounding.sphere(

objects=bpy.context.selected_objects,

mode='GEOMETRY'

)

Метод возвращает центр и радиус сферы. Для наглядности добавим в сцену пустышку в виде сферы и зададим ей полученные положение и радиус, чтобы визуально отобразить найденную ограничивающую сферу:

empty = bpy.data.objects.new(name='empty', object_data=None)
empty.empty_display_type = 'SPHERE'
empty.location = b_sphere[0]
empty.empty_display_size = b_sphere[1]
bpy.context.collection.objects.link(object=empty)

empty = bpy.data.objects.new(name='empty', object_data=None)

empty.empty_display_type = 'SPHERE'

empty.location = b_sphere[0]

empty.empty_display_size = b_sphere[1]

bpy.context.collection.objects.link(object=empty)

Результат:

Полный код:

import bpy
from bpy_plus.bounding import Bounding

b_sphere = Bounding.sphere(
    objects=bpy.context.selected_objects,
    mode='GEOMETRY'
    )

empty = bpy.data.objects.new(name='empty', object_data=None)
empty.empty_display_type = 'SPHERE'
empty.location = b_sphere[0]
empty.empty_display_size = b_sphere[1]
bpy.context.collection.objects.link(object=empty)

import bpy

from bpy_plus.bounding import Bounding

b_sphere = Bounding.sphere(

objects=bpy.context.selected_objects,

mode='GEOMETRY'

)

empty = bpy.data.objects.new(name='empty', object_data=None)

empty.empty_display_type = 'SPHERE'

empty.location = b_sphere[0]

empty.empty_display_size = b_sphere[1]

bpy.context.collection.objects.link(object=empty)

Текущая версия

1.8.0.

Для Blender версии

2.93, 3.0, 3.1, 3.2, 3.3, 3.4

История версий

История версий на GitHub