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
Bearbeiten- -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
Bearbeiten- -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
Bearbeiten- -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
Bearbeiten- -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
Bearbeiten- -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
Bearbeiten- -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
BearbeitenArguments 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
BearbeitenArguments 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
Bearbeiten- $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.