Рендеринг из командной строки и автоматизация на Python в Blender 5.2 LTS

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

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

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

Требования

• Blender должен быть установлен. Примеры команд основаны на документации командной строки Blender 5.2 LTS.

• Нужен файл .blend для рендеринга и доступ к его расположению.

• Для работы из командной строки потребуется терминал операционной системы; для примера с Python подойдут рабочая область Scripting, текстовый редактор или Python Console в Blender.

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

Пошаговая инструкция: фоновый рендеринг

1. Отрендерьте отдельный кадр

Параметр -b или --background запускает Blender без пользовательского интерфейса. С помощью -f задаётся номер кадра для рендеринга; -o задаёт путь и имя выходного файла; -F — формат. Пример ниже рендерит 20-й кадр файла сцена.blend в формате PNG:

blender -b sahne.blend -o //render_ -F PNG -f 20

Путь, начинающийся с //, указывает расположение относительно файла .blend. Если в имени файла нет символа #, Blender автоматически добавляет к имени суффикс с номером кадра. При создании нескольких кадров можно использовать символы # в имени файла, чтобы задать место для номера кадра и формат с заполнением нулями.

2. Отрендерьте анимацию в диапазоне кадров сцены

Параметр -a или --render-anim рендерит анимацию между начальным и конечным кадрами; оба граничных кадра входят в диапазон. В примере ниже указаны относительный путь вывода и формат PNG:

blender -b sahne.blend -o //animasyon_## -F PNG -a

Чтобы отдельно задать начальный и конечный кадры, используйте параметры -s и -e. Параметр -j определяет, на сколько кадров переходить между рендерящимися кадрами. При использовании этих параметров проверьте диапазон сцены и нужный шаг выборки кадров: рендеринг только необходимых кадров упрощает работу с выходной папкой.

Параметр -x или --use-extension определяет, добавлять ли к выходному файлу расширение. Чтобы явно включить расширение, можно использовать -x 1, как в примере из документации. Среди перечисленных форматов — JPEG, PNG, TIFF и HDR; доступность некоторых форматов может зависеть от сборки Blender.

3. Выберите движок рендеринга, число потоков и устройство Cycles

Движок рендеринга можно указать с помощью -E; параметр -E help выводит список доступных движков. Параметр -t задаёт число потоков для рендеринга и других операций. Значение 0 означает, что будет использоваться число процессоров в системе.

Параметр выбора устройства Cycles указывается после обычных параметров командной строки Blender, за двойным тире. В документации перечислены варианты CPU, CUDA, OPTIX, HIP, ONEAPI и METAL. Не следует считать, что все эти варианты будут работать на целевом компьютере: проверьте выбор на используемой системе и установленной версии Blender.

blender -b sahne.blend -f 20 -- --cycles-device OPTIX --cycles-print-stats

Этот пример выбирает устройство OPTIX для Cycles и запрашивает запись статистики использования памяти и времени рендеринга. Добавление +CPU к имени GPU-устройства указывает на совместное использование GPU и CPU. Если выбран не Cycles, вместо параметра выбора устройства Cycles следует изучить настройки соответствующего движка.

4. Читайте данные сцены с помощью Python в Blender

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

import bpy

for obj in bpy.data.objects:
    print(obj.name)

Чтобы запустить этот скрипт в Blender, перейдите в рабочую область Scripting и создайте новый текстовый блок в текстовом редакторе. Вставьте код и выполните его кнопкой Run Script. Для проверки коротких команд и изучения API с автодополнением также можно использовать Python Console.

Тот же файл скрипта можно запустить из командной строки с помощью параметра --python:

blender -b sahne.blend --python rapor.py

Этот способ позволяет регулярно запускать отчёты, которые изучают данные файла без открытия интерфейса. В документации также описан параметр --python-exit-code, позволяющий завершать скрипты, запущенные из командной строки, с определённым кодом выхода при возникновении ошибки Python. Настройка кода выхода помогает тем, кто добавляет скрипт в автоматизированный процесс, обнаруживать неудачные запуски.

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

• Неверная интерпретация пути вывода: относительный путь // отсчитывается от файла .blend. Если искать файл, предполагая, что он сохранён в другой папке, может показаться, что рендер пропал.

• Путаница с номером кадра или диапазоном: -f рендерит один кадр, а -a обрабатывает анимацию между начальным и конечным кадрами сцены. Проверьте значения -s и -e, чтобы задать нужный диапазон.

• Неверное расположение параметра Cycles: параметры Cycles, такие как --cycles-device, должны стоять в командной строке после разделителя --.

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

• Поиск вывода скрипта не там: согласно документации Blender API, вывод некоторых примеров направляется в терминал. Если скрипт завершился, но вывода не видно, проверьте терминал, из которого запущен Blender.

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

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

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

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

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

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

В основу материала легли страницы Blender Manual «Command Line Arguments», а также страницы Python API Blender «Quickstart» и «API Overview». Все три источника распространяются по лицензии CC BY-SA 4.0; материал адаптирован и изложен на турецком языке. Примеры команд и короткий Python-скрипт подготовлены для этого руководства на основе описанных в документации параметров и способов работы с API.