Последние новости
Настройки Unreal Engine Lumen: свет и отражения в интерьерахIntel Nova Lake-S показал в тесте 28 ядер и частоту 5,2 ГГцКак создать архитектурное видео в Veo 3.1: от промпта к сценариюПодготовка lightmap UV из Blender для Unreal Engine: пошаговое руководствоВышла бета CADQuader: преобразование STEP и IGES в quad-сеткиПодготовка архитектурного листа в Rhino 8: Layout, Detail и экспорт в PDFАрхитектурная визуализация с Images 2.6: от промпта к контролируемым правкамThéâtre Royal de Rabat завершён: дизайн, вдохновлённый берегом Бу-РегрегаПеренос USD-сцены из Blender в Unreal Engine: пошаговое руководствоВышла Inkling 2 Mini: циклическая архитектура для локального запуска
УрокиBlenderOMAMari

Знакомство с Blender Python API: первые автоматизации для архитектурных сцен

Blender Python API позволяет изучать данные сцены, добавлять пользовательские свойства объектам и создавать простые инструменты. Это руководство для начинающих показывает первые шаги автоматизации в сценах архитектурной визуализации.

Рабочий стол дизайн-студии с архитектурной моделью интерьераИИ-изображение
Иллюстрация создана с помощью ИИ.Изображение: 3dsınıfı / FCA AI

Коротко

  1. Python Console подходит для проверки коротких команд и изучения API с помощью автодополнения.
  2. bpy.data предоставляет доступ к данным объектов, сцен и материалов в открытом файле Blender.
  3. Пользовательские свойства можно добавлять объектам и сохранять вместе с blend-файлом.
  4. Оператор можно зарегистрировать в Blender и запускать через меню поиска.

Чему вы научитесь в этом руководстве?

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

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

Требования

  • Blender должен быть установлен. В исходной документации не указана конкретная версия Blender, поэтому здесь мы не называем точный номер версии, с которой обеспечена совместимость.

  • Отдельно устанавливать Python не нужно: примеры выполняются в Python Console или Text Editor внутри Blender.

  • В источниках не указаны требования к учётной записи или платной лицензии.

  • Для изучения API полезно включить в настройках Blender параметры Developer Extras и Python Tooltips. Подсказки кнопок могут помочь найти соответствующие атрибуты Python и имена операторов.

Для коротких команд и экспериментов можно использовать Python Console. Для редактирования и сохранения многострочных скриптов удобнее рабочее пространство Blender Scripting и Text Editor. Его можно открыть через вкладки на верхней панели.

Пошагово: доступ к данным сцены и создание первого инструмента

1. Выведите список объектов сцены с помощью Python

Откройте рабочее пространство Scripting и перейдите в Python Console. Консоль также удобна для изучения имён данных и свойств в bpy, поскольку в ней есть автодополнение. Запустите следующий код, чтобы вывести объекты открытой сцены по очереди:

python
import bpy

for ob in bpy.context.scene.objects:
    print(ob)

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

2. Найдите данные через bpy.data

Доступ к блокам данных в файле Blender осуществляется через bpy.data. В документации приведены примеры коллекций объектов, сцен и материалов. К элементу коллекции можно обратиться по имени:

python
bpy.data.objects["Cube"]

Доступ к той же коллекции возможен и по числовому индексу, однако документация предупреждает, что индекс элемента может измениться во время работы. Поэтому при поиске определённого элемента сцены обращение по имени понятнее, чем использование индекса как постоянного значения. Учитывайте, что имя в вашем файле может отличаться: Cube в примере — только имя тестового объекта из документации.

3. Добавьте пользовательскую информацию активному объекту

Чтобы добавить пользовательское свойство объекту, сцене или коллекции, можно воспользоваться соответствующими возможностями Python API. В следующем примере текстовое значение записывается в активный объект, если он существует:

python
import bpy

obj = bpy.context.object
if obj is not None:
    obj["project_note"] = "interior study"

bpy.context.object возвращает активный объект в зависимости от контекста. Условие позволяет ничего не делать, если активного объекта нет. Согласно исходной документации, такие пользовательские свойства сохраняются вместе с blend-файлом и переносятся при копировании объектов. Поэтому их можно использовать, чтобы добавлять к объекту проектную заметку или простую информацию, принятую в команде. Последовательные имена свойств упрощают поиск данных при работе с несколькими скриптами и файлами.

Пользовательским свойствам можно присваивать только базовые типы Python: целые числа, числа с плавающей точкой, строки, последовательности чисел и словари, отвечающие определённым правилам. Для вложенных словарей документация указывает максимальную глубину в 1024 уровня; превышение этого предела может привести к ошибке и потере данных. В этом примере используется простое текстовое значение, поэтому вложенная структура не возникает.

4. Превратите повторяющуюся задачу в оператор

Чтобы повторно запускать фрагмент кода из Blender, можно определить оператор. В следующем примере создаётся простой оператор, который выводит объекты сцены и не запускается, если активного объекта нет:

python
import bpy

def main(context):
    for ob in context.scene.objects:
        print(ob)

class SimpleOperator(bpy.types.Operator):
    """Tooltip"""
    bl_idname = "object.simple_operator"
    bl_label = "Simple Object Operator"

    @classmethod
    def poll(cls, context):
        return context.active_object is not None

    def execute(self, context):
        main(context)
        return {'FINISHED'}

def menu_func(self, context):
    self.layout.operator(
        SimpleOperator.bl_idname,
        text=SimpleOperator.bl_label
    )

def register():
    bpy.utils.register_class(SimpleOperator)
    bpy.types.VIEW3D_MT_object.append(menu_func)

def unregister():
    bpy.utils.unregister_class(SimpleOperator)
    bpy.types.VIEW3D_MT_object.remove(menu_func)

if __name__ == "__main__":
    register()

В рабочем пространстве Scripting выберите Text Editor, нажмите New, чтобы создать новый текстовый блок, вставьте код и нажмите Run Script. Согласно примеру из исходной документации, после регистрации оператора его можно найти через Operator Search по запросу Simple. Проверка poll() не позволяет запустить оператор, если активного объекта нет. Это важно, когда скрипт зависит от контекста пользователя.

5. Учитывайте контекст консоли и интерфейса

Содержимое bpy.context меняется в зависимости от области, в которой выполняется код. Python Console и 3D Viewport могут не иметь одних и тех же элементов контекста. Кроме того, значения context нельзя изменять напрямую: в документации поясняется, что попытка напрямую назначить активный объект приводит к ошибке, а вместо этого можно использовать путь bpy.context.view_layer.objects.active. Если оператор работает неожиданно, сначала проверьте, в какой области и режиме он запущен.

Распространённые ошибки

  • Использовать индекс как постоянный идентификатор: индексы элементов коллекции могут меняться во время работы. Обращаться к конкретному элементу по имени понятнее; убедитесь, что это имя действительно есть в файле.

  • Считать, что любой оператор работает везде: некоторым операторам нужны подходящие область, режим или выделение. Условие poll() проверяет, подходит ли контекст; вызов в неподходящем контексте может привести к ошибке.

  • Пытаться напрямую менять Context: bpy.context описан как доступный только для чтения. Если требуется изменение, используйте документированный API данных или подходящую функцию API.

  • Складывать сложные данные в пользовательские свойства: список поддерживаемых типов ограничен; значения словарей тоже должны состоять из базовых типов. Предпочитайте простые и понятные свойства.

  • Искать вывод скрипта не там: в примере вывод print отправляется в терминал. Если вы не видите результат выполнения, проверьте терминал Blender.

Дальнейшие шаги: рабочие процессы архитектуры и визуализации

Эти базовые приёмы могут стать отправной точкой для архитекторов, интерьерных дизайнеров и художников по визуализации, которым нужно проверять структуру сцены или привязывать к объектам дополнительную информацию. Например, список объектов в файле может упростить проверку содержимого больших сцен, а пользовательские свойства — хранение простых меток, принятых в команде. Сами по себе эти приёмы не обеспечивают соответствие определённому стандарту BIM или автоматизированное управление проектами: возможности зависят от написанного скрипта и используемых данных.

Проводите первые эксперименты на копии blend-файла. Затем изучайте нужные пути к данным с помощью Python Tooltips и автодополнения консоли; не добавляйте атрибут в рабочий скрипт, пока не убедитесь в его назначении. Позже адаптируйте оператор к реальной повторяющейся задаче и протестируйте его при разных вариантах выделения, активного объекта и контекста. Для скриптов, которыми будут пользоваться в офисе, также необходимо отдельно проверять совместимость с версией Blender; в источниках нет конкретной матрицы совместимости.

Источник и лицензия

Это руководство подготовлено на основе примеров и пояснений из краткого руководства по Blender Python API. Документ распространяется по лицензии CC BY-SA 4.0. В блоге разработчиков Blender за 2011 год приведён исторический контекст расширения документации API; эта публикация не заменяет актуальные инструкции по работе с API.

Источники

Источников: 2
C
code.blender.orgcode.blender.org/2011/02/blenderpython-api-docs
Контекст
D(
docs.blender.org (CC BY-SA 4.0)docs.blender.org/api/current/info_quickstart.html
Пересказ

Тексты источников не перепечатываются; короткие цитаты отмечены, остальное — наш пересказ и комментарий.

Мнение 3dsınıfı
3dОценка редактора

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

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

Частые вопросы

Где запускать код Blender Python API?

Короткие команды можно проверять в Python Console. Скрипты запускаются через Text Editor в рабочем пространстве Blender Scripting.

Как добавить объекту пользовательскую информацию в Blender?

API позволяет добавлять пользовательские свойства объектам. Они могут сохраняться вместе с blend-файлом и переноситься при копировании объекта.

Требуется ли для Blender Python API определённая версия?

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

Комментарии и форум — на турецком языке.Присоединиться к обсуждению
+

Похожие новости