Как быстро редактировать объекты сцены в Blender через Python Console

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

Что вы узнаете из этого руководства?

Python Console не только выполняет введённые команды, но и предоставляет историю команд и автодополнение. Сначала мы запросим текущий контекст — активные в Blender объект и режим. Затем изменим положение активного объекта, выведем список выбранных объектов и создадим новый источник света.

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

Требования и подготовка

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

Чтобы выполнить команду в Console, нажмите Return. Во время ввода Tab показывает варианты автодополнения для доступных элементов. Для знакомства со средой документация Blender также рекомендует выполнить команду dir(). В первом примере запрашиваются режим текущего контекста и активный объект:

bpy.context.mode
bpy.context.active_object

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

Шаг за шагом: основные действия в Console

1. Изучите элементы API

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

bpy.

Изучение элементов переменной или модуля помогает ориентироваться в доступном API, а не вводить команды по памяти. В среде Console также доступны сокращения C для bpy.context и D для bpy.data. Сначала можно выполнить dir(), чтобы посмотреть общие функции и переменные, определённые в среде.

2. Измените положение активного объекта

К активному объекту можно обратиться через контекст. В документации приведены примеры изменения координаты X объекта и добавления небольшого значения к этой координате. Сначала проверьте текущую координату объекта, а затем выполните команду ниже, чтобы увеличить значение по оси X на 0,5:

bpy.context.object.location.x += 0.5

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

3. Задайте все три координаты одновременно

Чтобы изменить сразу три компонента положения, можно передать координаты кортежем. В примере ниже значения X, Y и Z устанавливаются соответственно в 1, 2 и 3:

bpy.context.object.location = (1, 2, 3)

Также можно изменить только компоненты X и Y. Этот способ подходит, когда нужно задать значения для двух координат, сохранив текущее значение Z:

bpy.context.object.location.xy = (1, 2)

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

4. Просмотрите выбранные объекты

Если выбрано несколько объектов, bpy.context.selected_objects возвращает их список. Чтобы увидеть выбранные объекты, кроме активного, можно использовать следующее выражение:

[obj for obj in bpy.context.selected_objects if obj != bpy.context.object]

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

5. Добавьте в сцену точечный источник света

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

import bpy

view_layer = bpy.context.view_layer
light_data = bpy.data.lights.new(name="New Light", type='POINT')
light_object = bpy.data.objects.new(name="New Light", object_data=light_data)
view_layer.active_layer_collection.collection.objects.link(light_object)
light_object.location = (5.0, 5.0, 5.0)
light_object.select_set(True)
view_layer.objects.active = light_object

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

Частые ошибки

Одна из самых распространённых проблем — попытка обратиться к свойствам объекта, когда активного объекта нет. Перед примерами с изменением положения убедитесь, что объект выбран и активен. Редактирование не того объекта часто связано с тем, что пользователь не заметил, какой объект активен в текущем контексте.

Ещё одна возможная путаница — считать, что история команд и очистка окна Console означают одно и то же. Согласно документации Blender, команда Clear All в меню Console обновляет отображение, но не удаляет историю команд. Предыдущие и последующие команды можно вызывать клавишами со стрелками. Shift+Return добавляет команду в историю, не выполняя её; для выполнения нажмите Return.

Если после коротких экспериментов вы хотите сохранить команды в виде скрипта, документация указывает сочетание клавиш Copy as Script: оно копирует весь буфер истории в буфер обмена. Содержимое можно вставить в текстовый файл и использовать как Python-скрипт. Перед переходом к более крупной задаче просмотрите код и его воздействие на сцену — это поможет не перенести экспериментальные команды в рабочий файл по ошибке.

Применение в архитектурных и визуализационных рабочих процессах

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

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

Следующие шаги

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

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

Это руководство подготовлено на основе страницы “Python Console” в Blender Manual и справочника “Object” в Blender Python API. Оба источника распространяются по лицензии CC BY-SA 4.0; материал переведён на турецкий и изложен заново, а примеры кода основаны на использовании, описанном в соответствующей документации API.