Blender-Handbuch: Kommandozeilenparameter

Diese Seite bezieht sich auf Blender v2.5

 ... diese Seite ist in Bearbeitung ...

Dem Programm Blender können beim Starten zahlreiche Kommandozeilenparameter übergeben werden, außerdem existieren einige Umgebungsvariablen, die das Programm ausliest. Für eine vollständige Übersicht rufen Sie Blender mit dem Parameter --help auf.

blender --help

Usage: blender [args ...] [file] [args ...]

Verwendung: blender [Parameter] [Datei] [Parameter]

Render Optionen

-b or --background <file>

Load <file> in background (often used for UI-less rendering)

Lädt die Datei im Hintergrund (wird häufig für Renderings verwendet, wenn die Oberfläche nicht benötigt wird).

-a or --render-anim

Render frames from start to end (inclusive)

Rendert alle Frames

-S or --scene <name>

Set the active scene <name> for rendering

Setzt die aktive Szene, die gerendert werden soll.

-f or --render-frame <frame>

Render frame <frame> and save it.

Rendert den Frame mit der entsprechenden Nummer und speichert ihn.

+<frame> start frame relative, -<frame> end frame relative.

Relativer Anfangsframe, relativer Endframe.

-s or --frame-start <frame>

Set start to frame <frame> (use before the -a argument)

Setzt den Startframe auf die entsprechende Nummer. Verwenden Sie dieses Argument vor -a.

-e or --frame-end <frame>

Set end to frame <frame> (use before the -a argument)

Setzt den Endframe auf die entsprechende Nummer. Verwenden Sie dieses Argument vor -a.

-j or --frame-jump <frames>

Set number of frames to step forward after each rendered frame

Rendert nur jeden j. Frame.

-o or --render-output <path>

Set the render path and file name.

Use // at the start of the path to render relative to the blend file.

The # characters are replaced by the frame number, and used to define zero padding.

ani_##_test.png becomes ani_01_test.png

test-######.png becomes test-000001.png

When the filename does not contain #, The suffix #### is added to the filename. The frame number will be added at the end of the filename.

eg: blender -b foobar.blend -o //render_ -F PNG -x 1 -a

//render_ becomes //render_####, writing frames as //render_0001.png//

-E or --engine <engine>

Specify the render engine. Use -E help to list available engines

Format Optionen

-F or --render-format <format>

Set the render format, Valid options are...

TGA IRIS JPEG MOVIE IRIZ RAWTGA AVIRAW AVIJPEG PNG BMP FRAMESERVER

(formats that can be compiled into blender, not available on all systems)

HDR TIFF EXR MULTILAYER MPEG AVICODEC QUICKTIME CINEON DPX DDS

-x or --use-extension <bool>

Set option to add the file extension to the end of the file

-t or --threads <threads>

Use amount of <threads> for rendering in background [1-BLENDER_MAX_THREADS], 0 for systems processor count.

Animation Playback Optionen

-a <options> <file(s)>

Playback <file(s)>, only operates this way when not running in background.

-p <sx> <sy> Open with lower left corner at <sx>, <sy>

-m Read from disk (Don't buffer)

-f <fps> <fps-base> Specify FPS to start with

-j <frame> Set frame step to <frame>

Fenster Optionen

-w or --window-border

Force opening with borders (default)

-W or --window-borderless

Force opening with without borders

-p oder --window-geometry <sx> <sy> <w> <h>

Öffnet das Programm mit der unteren linken Ecke bei <sx>, <sy> und der Breite und Höhe <w> und <h>. Beispiel: blender -p 0 0 1024 800

Optionen für die Game Engine

-g Game Engine specific options

-g fixedtime Run on 50 hertz without dropping frames

-g vertexarrays Use Vertex Arrays for rendering (usually faster)

-g nomipmap No Texture Mipmapping

-g linearmipmap Linear Texture Mipmapping instead of Nearest (default)

Andere Optionen

-d or --debug

Turn debugging on

* Prints every operator call and their arguments

* Disables mouse grab (to interact with a debugger in some cases)

* Keeps python sys.stdin rather then setting it to None

--debug-fpe

Enable floating point exceptions

-nojoystick

Disable joystick support

-noglsl

Disable GLSL shading

-noaudio

Force sound system to None

-setaudio

Force sound system to a specific device

NULL SDL OPENAL JACK

-h or --help

Print this help text and exit

-y or --enable-autoexec

Enable automatic python script execution (default)

-Y or --disable-autoexec

Disable automatic python script execution (pydrivers, pyconstraints, pynodes)

-P or --python <filename>

Run the given Python script (filename or Blender Text)

--python-console

Run blender with an interactive console

-v or --version

Print Blender version and exit

--

Ends option processing, following arguments passed unchanged. Access via python's sys.argv

/?

Print this help text and exit (windows only)

-R

Register .blend extension (windows only)

Verarbeitung der Kommandozeile

Arguments must be separated by white space. eg

"blender -ba test.blend"

...will ignore the 'a'

"blender -b test.blend -f8"

...will ignore 8 because there is no space between the -f and the frame value

Reihenfolge der Kommandozeilenparameter

Arguments are executed in the order they are given. eg

"blender --background test.blend --render-frame 1 --render-output /tmp"

...will not render to /tmp because '--render-frame 1' renders before the output path is set

"blender --background --render-output /tmp test.blend --render-frame 1"

...will not render to /tmp because loading the blend file overwrites the render output that was set

"blender --background test.blend --render-output /tmp --render-frame 1" works as expected.

Umgebungsvariablen

$BLENDER_USER_CONFIG Directory for user configuration files.

$BLENDER_SYSTEM_CONFIG Directory for system wide configuration files.

$BLENDER_USER_SCRIPTS Directory for user scripts.

$BLENDER_SYSTEM_SCRIPTS Directory for system wide scripts.

$BLENDER_USER_DATAFILES Directory for user data files (icons, translations, ..).

$BLENDER_SYSTEM_DATAFILES Directory for system wide data files.

$BLENDER_SYSTEM_PYTHON Directory for system python libraries.

$TMP or $TMPDIR Store temporary files here.

$SDL_AUDIODRIVER LibSDL audio driver - alsa, esd, dma.

$PYTHONHOME Path to the python directory, eg. /usr/lib/python.