Сборка Blender как модуля Python

Blender — это автономное 3d-приложение с открытым исходным кодом, в котором есть функция, называемая скриптингом. Сценарий — это инструмент, который использует API python для запуска и управления Blender. Например, вы можете создать куб с помощью этого скрипта, наложить на него текстуру и выполнить рендеринг с помощью этого скрипта. Это очень полезно для создателей для построения сложного моделирования, автоматизации нескольких шагов в их конвейере и многого другого.

Есть и другой способ использования этого скрипта, это «Blender как модуль Python» во внешних программах python. Вы можете импортировать модуль blender как «import bpy» и выполнять скрипт, связанный с blender, в другом приложении. Это избавит вас от необходимости запускать скрипт blender python из внешнего файла. И нам не нужно запускать blender как программный экземпляр на вашем компьютере.

Опция сборки Blender как Python-модуля официально не поддерживается, в том смысле, что Blender.org не распространяет ее вместе с обычными релизами. В настоящее время это опция сборки, которую вы можете включить для собственного использования.

Это опция сборки, позволяющая импортировать blender в python и получить доступ к его модулям.
Вот некоторые из возможных вариантов использования этого модуля
рендеринг анимации.

  • обработка изображений с использованием композитора Blender.
  • редактирование видео (с использованием секвенсора Blender).
  • импортеры, экспортеры (конвертация форматов 3D файлов).
  • разработка, доступ к bpy из Python IDE и инструменты отладки, например.
  • автоматизация.

Давайте погрузимся в начальную настройку.

Сборка Blender под Windows

Ниже приведены инструкции по сборке Blender для Windows с помощью Microsoft Visual Studio.

Установите инструменты разработки

Нам нужно установить Subversion, Git, CMake и Visual Studio для Windows.

  • Установите Visual Studio 2019 или 2022 Community Edition (бесплатно, не забудьте установить рабочую нагрузку «Desktop Development with C++»).
  • Установите Subversion для Windows (SlikSVN)
  • Установите Git для WindowsВ программе установки выберите добавление Git в PATH, чтобы «make update» мог корректно работать.
  • Установите CMakeВ программе установки установите опцию системного пути Add CMake to the system PATH for all users.

Откройте командную строку

Откройте окно командной строки, нажав клавиши Windows+R и введя cmd.exe.

Важно, чтобы вы использовали именно cmd.exe, а не powershell или любую другую оболочку, иначе приведенные ниже инструкции могут не сработать.

Загрузка исходных текстов и библиотек

Создайте папку для хранения вашей копии исходного кода Blender. В данном руководстве предполагается, что выбранная вами папка будет C:blender-git.
Скачайте исходный код Blender:

cd C:blender-git
git clone git://git.blender.org/blender.git
Войдите в полноэкранный режим Выйдите из полноэкранного режима

Скачайте библиотеки Blender:

cd C:blender-gitblender
make update
Войдите в полноэкранный режим Выйти из полноэкранного режима

make автоматически определит нужные вам библиотеки и предложит загрузить их для вас. Обратите внимание, что размер этого набора библиотек составляет несколько гигабайт, и загрузка может занять некоторое время.
_Необходимо установить Subversion для Windows перед запуском этого кода. _

Сборка

Простой (автоматизированный) способ: смотрите инструкции в документации по сборке blender, но запустите.

Все должно собраться как обычно, за исключением того, что в каталоге cmake у вас будет ./bin/bpy.so (./bin/bpy.pyd в Windows) вместо ./bin/blender.

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

C:blender-git
          |------blender
          |------lib
          |------build_windows_Bpy_x64_vc16_Release

Вход в полноэкранный режим Выход из полноэкранного режима

Установите

Давайте добавим модуль python в вашу среду разработки. Версия python должна соответствовать версии python, используемой в Blender. Например, у меня на компьютере стоит Python 3.10, и я получил последнюю версию Blender, которая была создана с использованием Python 3.10. Если версия не совпадает, вы можете столкнуться с ошибкой компиляции.

  1. Создайте виртуальную среду

virtualenv -p python python310
Создайте папку py37 и установите в нее виртуальное окружение. Это среда, которую мы можем использовать для наших проектов / разработки аддонов. Структура папок будет выглядеть следующим образом

C:blender-dev
          |------blender
          |------lib
          |------build_windows_Bpy_x64_vc16_Release
          |------python310
Вход в полноэкранный режим Выйти из полноэкранного режима
  1. Активируйте виртуальную среду

  2. Добавьте следующие файлы в нужное место

  • скопируйте файл bpy.pyd и все *.dll файлы из *blender-devbuild_windows_Bpy_x64_vc16_ReleasebinRelease* в python310Libsite-packages

  • Внутри папки *blender-devbuild_windows_Bpy_x64_vc16_ReleasebinRelease* вы также увидите папку 3.xx, в зависимости от того, какую версию Blender вы собрали. В моем случае это была 3.14.
    Скопируйте эту папку и вставьте ее в системный каталог python.
    Например: C:UsersJanaAppDataLocalProgramsPythonPython310

Тестирование

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

python -c "import bpy; bpy.ops.render.render(write_still=True)"
Войти в полноэкранный режим Выйдите из полноэкранного режима

Будет отрисовано изображение с кубом, вы можете найти результат в C:/tmp/.png

Оцените статью
devanswers.ru
Добавить комментарий