输出本参数说明的命令:blender –help
Blender 2.73 (sub 5)
Usage: blender [args …] [file] [args …]
渲染选项
Render Options:
-b or –background ,在后台运行,通常用于无界面渲染。
Run in background (often used for UI-less rendering)
-a or –render-anim ,渲染动画的全部帧。
Render frames from start to end (inclusive)
-S or –scene <name>,设置渲染的当前活动场景。
Set the active scene <name> for rendering
-f or –render-frame <frame>,渲染一帧并保存。
Render frame <frame> and save it.
+<frame> start frame relative, -<frame> end frame relative.
-s or –frame-start <frame>,指定将渲染动画的开始帧。
Set start to frame <frame> (use before the -a argument)
-e or –frame-end <frame>,指定将渲染动画的结束帧。
Set end to frame <frame> (use before the -a argument)
-j or –frame-jump <frames>,指定每一帧渲染后的步进的帧数。
Set number of frames to step forward after each rendered 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>,指定渲染引擎,-E列出可用的渲染引擎。
Specify the render engine
use -E help to list available engines
-t or –threads <threads>,指定渲染的线程数。
Use amount of <threads> for rendering and other operations
[1-64], 0 for systems processor count.
格式选项
Format Options:
-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
动画回放选项
Animation Playback Options:
-a or –render-anim
Render frames from start to end (inclusive)
窗口选项
Window Options:
-w or –window-border,窗口边框。
Force opening with borders (default)
-W or –window-borderless,窗口无边框。
Force opening without borders
-p or –window-geometry <sx> <sy> <w> <h>,窗口大小。
Open with lower left corner at <sx>, <sy> and width and height as <w>, <h>
-con or –start-console ,打开控制台。
Start with the console window open (ignored if -b is set), (Windows only)
–no-native-pixels ,不使用原生分辨率(适合高分屏,如MacBook Retina)
Do not use native pixel size, for high resolution displays (MacBook ‘Retina’)
游戏引擎选项
Game Engine Specific Options:
-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)
Python脚本引擎选项
Python Options:
-y or –enable-autoexec ,启用自动执行。
Enable automatic python script execution
-Y or –disable-autoexec ,关闭自动执行。
Disable automatic python script execution (pydrivers & startup scripts), (compiled as non-standard default)
-P or –python <filename>,运行指定的脚本文件。
Run the given Python script file
–python-text <name>,运行指定的文本块。
Run the given Python script text block
–python-console ,启动交互控制台。
Run blender with an interactive console
–addons ,加载“,”分隔的插件项。
Comma separated list of addons (no spaces)
跟踪调试选项
Debug Options:
-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 than setting it to None
–debug-value <value>,调试的debug的值。
Set debug value of <value> on startup
–debug-events ,启用事件系统的调试消息。
Enable debug messages for the event system
–debug-handlers ,启用事件处理的调试消息。
Enable debug messages for event handling
–debug-libmv ,启用libmv的调试消息。
Enable debug messages from libmv library
–debug-cycles ,启用Cycles的调试消息。
Enable debug messages from Cycles
–debug-memory ,启用内存的分配和调试。
Enable fully guarded memory allocation and debugging
–debug-jobs ,启用后台任务的时间分析。
Enable time profiling for background jobs.
–debug-python ,启用Python的调试消息。
Enable debug messages for python
–debug-depsgraph ,启用依赖树的调试消息。
Enable debug messages from dependency graph
–debug-wm ,启用窗口管理器的调试消息。
Enable debug messages for the window manager
–debug-all ,启用所有调试消息(除libmv外)。
Enable all debug messages (excludes libmv)
–debug-fpe ,启用浮点例外。
Enable floating point exceptions
–disable-crash-handler ,禁用崩溃处理器。
Disable the crash handler
综合选项
Misc Options:
–factory-startup ,跳过startup.blend的读取。
Skip reading the “startup.blend” in the users home directory
–env-system-datafiles ,设置BLENDER_SYSTEM_DATAFILES环境变量。
Set the BLENDER_SYSTEM_DATAFILES environment variable
–env-system-scripts,设置BLENDER_SYSTEM_SCRIPTS环境变量。
Set the BLENDER_SYSTEM_SCRIPTS environment variable
–env-system-python,设置BLENDER_SYSTEM_PYTHON环境变量。
Set the BLENDER_SYSTEM_PYTHON environment variable
-nojoystick,禁用游戏杆的支持。
Disable joystick support
-noglsl,禁用GLSL渲染支持。
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
-v or –version,打印版本信息,然后退出。
Print Blender version and exit
— ,结束选项的处理。
Ends option processing, following arguments passed unchanged. Access via python’s sys.argv
其它选项
Other Options:
/? ,打印帮助信息,然后退出(只在Windows有效)。
Print this help text and exit (windows only)
-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>
-s <frame> Play from <frame>
-e <frame> Play until <frame>
–debug-freestyle,启用Freestyle渲染的调试分析。
Enable debug/profiling messages from Freestyle rendering
–verbose <verbose>,设定日志信息的级别。
Set logging verbosity level.
-R,注册.blend扩展名(Windows系统有效)
Register .blend extension, then exit (Windows only)
-r,注册.blend扩展名(Windows系统有效)
Silently register .blend extension, then exit (Windows only)
Argument Parsing: 参数的解析。
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
Argument Order: 参数的顺序。
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.
环境变量
Environment Variables:
$BLENDER_USER_CONFIG 用户配置文件目录,Directory for user 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 系统python库目录,Directory for system python libraries.
$TMP or $TMPDIR 临时文件存储目录,Store temporary files here.
$PYTHONHOME Python的主目录,Path to the python directory, eg. /usr/lib/python.