Command Line Rendering

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

Одним из преимуществ использования командной строки является то, что нам не нужен графический дисплей (например, нет необходимости в X-сервере в Linux), и, следовательно, мы можем выполнять рендеринг через удаленную оболочку (обычно SSH).

См. Аргументы командной строки для получения полного списка аргументов (например, чтобы указать, какую сцену визуализировать (render), номер конечного кадра и т. д.) или просто запустите:
См. Запуск из командной строки для получения конкретных инструкций по запуску Blender из командной строки.

blender --help

Примечание

Аргументы выполняются в том порядке, в котором они заданы!

Следующая команда не будет работать, поскольку вывод и расширение устанавливаются после того, как Blender’у будет указано выполнить рендеринг:

blender -b file.blend -a -x 1 -o //render

Следующая команда сработает ожидаемым образом:

blender -b file.blend -x 1 -o //render -a

Всегда ставьте -f или -a в качестве последних аргументов.

Одно изображение (single image)

blender -b file.blend -f 10

-b: Рендеринг в фоновом режиме (без пользовательского интерфейса).
file.blend: Путь к blend-файлу для рендера.
-f 10: Рендер только 10-го кадра.

blender -b file.blend -o /project/renders/frame_##### -F OPEN_EXR -f -2

-o /project/renders/frame_#####: Путь сохранения визуализированного (rendered) изображения с использованием пяти (padded-ведущих) нулей в качестве номера кадра.
-F OPEN_EXR: Переопределить формат изображения, указанный в blend-файле, и сохранить его в образ OpenEXR.
-f -2: Рендер только предпоследнего кадра.

Предупреждение

Аргументы чувствительны к регистру! -F и -f не одно и то же.

Анимация

blender -b file.blend -a

-a: Визуализировать (render) всю анимацию, используя все настройки, сохранённые в blend-файле.

blender -b file.blend -E CYCLES -s 10 -e 500 -t 2 -a

-E CYCLES: Использовать движок «Cycles Render». Чтобы просмотреть список доступных механизмов рендеринга (render engines), запустите blender -E help.
-s 10 -e 500: Установить начальный кадр на 10, а конечный — на 500.
-t 2: Использовать только два потока (threads).

Cycles

In addition to the options above, which apply to all render engines, Cycles has additional options to further control its behavior.

blender -b file.blend -f 20 -- --cycles-device CPU

Примечание

Unlike the generic options, the Cycles-specific ones must be passed on the end of the command line, following a double dash.

--cycles-device CPU: Override the device that is used to render frames. Currently supported options are CPU, CUDA, OPTIX, HIP, ONEAPI, and METAL. Additionally, you can append +CPU to any GPU type for hybrid rendering.
--cycles-print-stats: Show detailed statistics about memory and time usage for Cycles renders on the console.