命令行参数

    , --background

    在后台运行渲染(通常用于无需UI的渲染)。

    -a, --render-anim

    渲染从开始到结束帧(包含最后帧)。

    -S, --scene <name>

    设置要渲染场景 <name>。

    -f, --render-frame <frame>

    渲染某一 <frame> 并保存。

    • +<frame> 相对起始帧， -<frame> 相对结束帧。

    • 在首末帧之间加 .. 隔开，表示包含首尾的帧范围。

    -s, --frame-start <frame>

    设置起始帧为 <frame>, 支持 +/- 设置相对帧。

    -e, --frame-end <frame>

    设置结束帧为 <frame>, 支持 +/- 设置相对帧。

    -j, --frame-jump <frames>

    设置帧步长。

    -o, --render-output <path>

    设置渲染路径和文件名。在路径起始位置使用 // 设置渲染路径为当前blend文件的相对路径。

    # 会被替代为帧序号，不足位补零。

    • animation_##_test.png 变成 animation_01_test.png

    • test-######.png 变成 test-000001.png

    如果文件名不包含 # , 默认为文件名添加后缀 #### 。

    那么渲染器保存文件名的时候,就会把帧号添加到文件的结尾,如:

    //render_ 会变成 //render_####, 帧会写成 //render_0001.png

    -E, --engine <engine>

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

    -t, --threads <threads>

    渲染或其他操作使用线程数量， <threads> 填写1-64就是线程，0表示使用CPU全部线程。

    格式选项

    -F, --render-format <format>

    设置渲染格式。有效选项有: TGA RAWTGA JPEG IRIS IRIZ AVIRAW AVIJPEG PNG BMP

    可以编译到Blender中的格式如下，但并非在所有系统可用: HDR TIFF OPEN_EXR OPEN_EXR_MULTILAYER MPEG CINEON DPX DDS JP2

    -x, --use-extension <bool>

    设置选项，将文件扩展名添加到文件的结尾。

    动画播放选项

    <options> <file(s)>

    该操作将Blender作为动画播放器运行，以查看Blender渲染的影片和图像序列帧(如果 -b 被设定则忽略此参数)，不显示Blender的用户界面.

    回放参数:

    • -p <sx> <sy>

      打开，左下角位于 <sx>, <sy> 。

      -m

      从磁盘读取(不进行缓冲)。

      -f <fps> <fps-base>

      指定开始播放的FPS。

      -j <frame>

      设置帧步长为 <frame> 。

      -s <frame>

      从 <frame> 帧开始播放。

      -e <frame>

      播放到 <frame> 帧。

    窗口选项

    -w, --window-border

    打开有边框窗口。

    -W, --window-fullscreen

    强制以全屏模式打开。

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

    以左下角位于 <sx>, <sy> ，宽度和高度分别为 <w>, <h> 打开。

    -M, --window-maximized

    强制最大化打开。

    -con, --start-console

    从控制台打开(忽略 -b 选项)，(仅适用Windows)。

    --no-native-pixels

    对于高分辨显示器(MacBook Retina)，不使用本地分辨率。

    --no-window-focus

    在其他窗户后面打开，无需获得焦点。

    -y, --enable-autoexec

    启用自动执行Python脚本(默认)。

    -Y, --disable-autoexec

    禁用自动执行Python脚本(py驱动与启动脚本)。

    -P, --python <filename>

    运行指定的Python脚本文件。

    --python-text <name>

    运行指定的Python脚本文本块。

    将给定表达式作为Python脚本运行。

    --python-console

    使用交互式控制台运行Blender。

    --python-exit-code <code>

    设置抛出Python异常时的结束代码( [0..255])，(仅用于从命令行执行的脚本)，0表示禁用。

    --python-use-system-env

    允许 Python 使用系统环境变量，如``PYTHONPATH`` 和用户站点包目录。

    --addons <addon(s)>

    逗号分隔的插件列表(无空格)。

    日志选项

    --log <match>

    启用日志分类，使用单个逗号分隔的参数。多个类别可使用 .* 后缀进行匹配，所以 --log "wm.*" 记录窗口管理器所有类型的日志。使用 “^” 前缀以忽略，所以 --log "*,^wm.operator.*" 记录所有类型的日志但是除了 wm.operators.* 使用 “*“ 以记录所有日志。

    --log-level <level>

    设置日志冗余等级(等级越高细节越多)默认为1，使用-1以启用所有等级。

    --log-show-basename

    只显示文件名称于输出中(不显示加载路径)。

    --log-show-backtrace

    显示日志信息回溯(仅限于debug模式)。

    --log-show-timestamp

    从启动后开始为每个日志信息添加以秒为单位的时间戳显示。

    <filename>

    设定日志输出文件。

    调试选项

    -d, --debug

    开启调试。

    • 启用内存错误侦测

    • 禁用鼠标抓取(在某些情况下与调试器进行交互)

    --debug-value <value>

    在启动时设置调试值 <value> 。

    --debug-events

    启用事件系统的调试消息。

    --debug-ffmpeg

    启用来自ffmpeg库的调试消息。

    --debug-handlers

    启用事件处理的调试消息。

    --debug-libmv

    启用来自libmv库的调试消息。

    --debug-cycles

    启用来自Cycles的调试消息。

    --debug-memory

    启用完全保护的内存分配和调试。

    --debug-jobs

    启用后台任务的时间分析。

    --debug-python

    启用Python的调试消息。

    --debug-depsgraph

    启用依赖树的全部调试消息。

    --debug-depsgraph-eval

    启用依赖树的调试消息(分析相关)。

    --debug-depsgraph-build

    启用依赖树的调试消息(树构造)。

    --debug-depsgraph-tag

    启用依赖树的调试消息(标记相关)。

    --debug-depsgraph-no-threads

    切换依赖图到单线程运算。

    --debug-depsgraph-time

    启用依赖树的调试消息(时间相关)。

    --debug-depsgraph-pretty

    启用调试信息颜色。

    --debug-gpu

    对OpenGL 4.3+启用GPU调试上下文和信息。

    --debug-gpumem

    启用在状态栏显示GPU内存状态。

    --debug-gpu-shaders

    启用在状态栏显示GPU内存状态。

    --debug-gpu-force-workarounds

    启用在状态栏显示GPU内存状态。

    --debug-wm

    启用窗口管理器的调试消息，同时逐个打印operator调用，打印键位映射错误。

    --debug-xr

    为虚拟现实上下文启用调试消息。启用 OpenXR API 验证层、(OpenXR)调试消息和常规信息打印。

    --debug-xr-time

    --debug-all

    启用全部调试消息。

    --debug-io

    启用来自I/O (collada, …)的调试消息。

    --debug-fpe

    启用浮点异常。

    --disable-crash-handler

    禁用崩溃处理程序。

    --disable-abort-handler

    禁用中止处理程序。

    综合选项

    --app-template <template>

    设置应用模板(匹配目录名称)， default 表示参数为空。

    --factory-startup

    跳过读取用户家目录中的startup.blend。

    --enable-event-simulate

    启用事件模拟测试特性 bpy.types.Window.event_simulate。

    --env-system-datafiles

    设置 BLENDER_SYSTEM_DATAFILES 环境变量。

    --env-system-scripts

    设置 BLENDER_SYSTEM_SCRIPTS 环境变量。

    --env-system-python

    设置 BLENDER_SYSTEM_PYTHON 环境变量。

    -noaudio

    禁用声音系统。

    -setaudio

    设置声音系统到指定设备: NULL SDL OPENAL JACK。

    -h, --help

    打印帮助信息，并退出。

    -R

    注册 .blend 扩展名，然后退出 (仅适用于Windows)

    -r

    悄悄注册 .blend 扩展名(不弹出提示对话框)，然后退出 (仅适用于Windows)

    -v, --version

    打印Blender版本信息并退出。

    --

    结束选项处理，传递的参数不变。通过Python的 sys.argv 访问。

    /?

    打印帮助文本，并退出 (仅适用于Windows)。

    --debug-depsgraph-uuid

    启用依赖树的调试消息(树构造)。

    --debug-exit-on-error

    Immediately exit when internal errors are detected.

    --debug-freestyle

    启用FreeStyle调试信息。

    --debug-ghost

    启用事件处理的调试消息。

    --verbose <verbose>

    为支持该级别的调试消息设置日志记录详细程度级别。

    参数解析

    参数必须用空格隔开,例如：

    …将退出，因为 -ba 是未知参数。

    参数顺序

    参数是按从左到右的循序执行的，例如:

    …不会渲染到 /tmp ，因为不能在渲染路径(output)之前设置 --render-frame 1 参数。

    不会渲染到 /tmp ，由于加载混合文件会覆盖渲染输出设置。

    以上命令行正确，可得到预期结果。

    环境变量

    BLENDER_USER_CONFIG

    用户配置文件目录。

    BLENDER_USER_SCRIPTS

    用户脚本目录。

    BLENDER_SYSTEM_SCRIPTS

    系统脚本目录。

    BLENDER_USER_DATAFILES

    用户数据文件目录 (icons, translations, ..).

    BLENDER_SYSTEM_DATAFILES

    系统数据文件目录。

    BLENDER_SYSTEM_PYTHON

    系统Python库目录.

    TEMP

    临时文件目录。

    TMP

    或 $TMPDIR 临时文件目录.

    SDL_AUDIODRIVER