Command Line Rendering

In some situations we want to increase the render speed, access Blender remotely to render something or build scripts that use the command line.

One advantage of using the command line is that we do not need a graphical display (no need for X server on Linux for example) and consequently we can render via a remote shell (typically SSH).

• See Command Line Arguments for a full list of arguments (for example to specify which scene to render, the end frame number, etc.), or simply run:

• See Command Line Launching for specific instructions on launching Blender from the command line.

blender --help

Nota

Arguments are executed in the order they are given!

The following command will not work, since the output and extension are set after Blender is told to render:

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

El siguiente comando se comportará como se espera:

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

Siempre ubicar -f o -a como los últimos argumentos.

Imagen fija

blender -b file.blend -f 10

-b

Procesar en segundo plano (sin interfaz).

archivo.blend

Ruta al archivo .blend a ser procesado.

-f 10

Procesar sólo el décimo fotograma.

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

-o /project/renders/imagen_#####

Ruta donde guardar la imagen procesada, usando un relleno de cinco ceros para el número de fotograma.

-F OPEN_EXR

Redefinir el formato de imagen especificado en el archivo .blend y guardar a una imagen OpenEXR.

-f -2

Procesar sólo el penúltimo fotograma.

Advertencia

¡Los argumentos son sensibles a mayúsculas y minúsculas! -F y -f no son lo mismo.

Animación

blender -b file.blend -a

-a

Procesar la animación completa usando todas las opciones guardadas en el archivo .blend.

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

-E CYCLES

Usar el motor de procesamiento «Cycles». Para una lista de los motores de procesamiento disponibles, ejecutar blender -E help.

-s 10 -e 500

Define el fotograma inicial en 10 y el fotograma final en 500.

-t 2

Usar sólo dos hilos de cómputo.

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

Nota

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.