命令行参数#
blender [args ...] [file] [args ...]
渲染选项#
-b
,--background
在后台运行渲染(通常用于无需UI的渲染)。
音频设备默认在后台模式下处于禁用状态,之后可以通过输入
-setaudo Default
重新启用。-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
如果文件名不包含
#
,默认为文件名添加后缀####
。那么渲染器保存文件名的时候,就会把帧号添加到文件的结尾,如:
blender -b animation.blend -o //render_ -F PNG -x 1 -a
//render_
会变成//render_####
, 帧会写成//render_0001.png
-E
,--engine
<engine>
指定渲染引擎,使用
-E help
查看所有可用渲染引擎列表。-t
,--threads
<threads>
Use amount of
<threads>
for rendering and other operations [1-1024], 0 to use the systems processor count.
Cycles 渲染选项#
Cycles 附加选项必须在双破折号后指定。
--cycles-device
<device>
设置用于渲染的设备。有效选项为:
CPU
CUDA
OPTIX
HIP
ONEAPI
METAL
。Append +CPU to a GPU device to render on both CPU and GPU.
示例:
blender -b file.blend -f 20 -- --cycles-device OPTIX
--cycles-print-stats
有关渲染内存和时间使用情况的日志统计。
格式选项#
-F
,--render-format
<format>
设置渲染格式。有效选项有:
TGA
RAWTGA
JPEG
IRIS
AVIRAW
AVIJPEG
PNG
BMP
HDR
TIFF
。可以编译到 Blender 中的格式(并非在所有系统上都可用):
OPEN_EXR
OPEN_EXR_MULTILAYER
FFMPEG
CINEON
DPX
JP2
WEBP
。-x
,--use-extension
<bool>
设置选项,将文件扩展名添加到文件的结尾。
动画播放选项#
-a
<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>
帧。-c
<cache_memory>
在播放期间允许缓存图像的内存量(以兆字节为单位)。零禁用(取而代之的是钳制到固定数量的帧)。
窗口选项#
-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
在其他窗户后面打开,无需获得焦点。
Python 选项#
-y
,--enable-autoexec
启用自动执行 Python 脚本。
-Y
,--disable-autoexec
禁用自动执行 Python 脚本(Python 驱动与启动脚本)(默认)。
-P
,--python
<filepath>
运行指定的 Python 脚本文件。
--python-text
<name>
运行指定的 Python 脚本文本块。
--python-expr
<expression>
将给定表达式作为 Python 脚本运行。
--python-console
使用交互式控制台运行 Blender。
--python-exit-code
<code>
设置抛出 Python 异常时的结束代码 [0..255],(仅用于从命令行执行的脚本),0表示禁用。
--python-use-system-env
允许 Python 使用系统环境变量,如``PYTHONPATH`` 和用户站点包目录。
--addons
<addon(s)>
逗号分隔的加载项列表(无空格),以启用任何默认加载项。
网络选项#
--online-mode
允许互联网访问,覆盖偏好设置。
--offline-mode
禁止互联网访问,覆盖偏好设置。
日志选项#
--log
<match>
启用日志记录类别,采用单个逗号分隔的参数。可以使用
.*
后缀匹配多个类别,则--log "wm.*"
会记录所有类型的窗口管理器消息。子字符串可以使用*
前缀和后缀进行匹配,则--log "*undo*"
会记录各种与撤消相关的消息。使用 "^" 前缀以忽略,则--log "*,^wm.operator.*"
将记录除wm.operators.*
之外的所有日志。使用 "*" 以记录所有内容。--log-level
<level>
设置日志冗余等级(等级越高细节越多)默认为 1,使用 -1 以启用所有等级。
--log-show-basename
只显示文件名称于输出中(不显示加载路径)。
--log-show-backtrace
显示日志信息回溯(仅限于 debug 模式)。
--log-show-timestamp
从启动后开始为每个日志信息添加以秒为单位的时间戳显示。
--log-file
<filepath>
设定日志输出文件。
调试选项#
-d
,--debug
开启调试。
启用内存错误侦测
禁用鼠标抓取(在某些情况下与调试器进行交互)
保留 Python 的
sys.stdin
而不是将其设置为 None
--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-depsgraph-uid
验证分配给 ID 数据块的会话范围标识符的有效性。
--debug-ghost
启用 Ghost 的调试消息(仅限 Linux)。
--debug-wintab
启用 Wintab 的调试消息。
--debug-gpu
对 OpenGL 4.3+ 启用 GPU 调试上下文和信息。
--debug-gpu-force-workarounds
启用典型 GPU 问题的解决方案并禁用所有 GPU 扩展。
--debug-gpu-compile-shaders
编译所有静态定义的着色器,以测试平台兼容性。
--debug-gpu-renderdoc
启用 Renderdoc 集成,以获取 GPU 帧并进行调试。
--debug-wm
启用窗口管理器的调试消息,同时逐个打印操作符调用,打印键位映射错误。
--debug-xr
为虚拟现实上下文启用调试消息。启用 OpenXR API 验证层、(OpenXR)调试消息和常规信息打印。
--debug-xr-time
为虚拟现实帧渲染时间启用调试消息。
--debug-all
启用全部调试消息。
--debug-io
启用来自 I/O(Collada 等)的调试消息。
--debug-fpe
启用浮点异常。
--debug-exit-on-error
检测到内部错误时立即退出。
--debug-freestyle
启用 Freestyle 调试信息。
--disable-crash-handler
禁用崩溃处理程序。
--disable-abort-handler
禁用中止处理程序。
--verbose
<verbose>
为支持该级别的调试消息设置日志记录详细程度级别。
GPU 选项#
--gpu-backend
强制使用特定 GPU 后端。有效选项:
vulkan
(试验性)、metal
、opengl
。--gpu-compilation-subprocesses
覆盖最大编译子进程设置(仅限 OpenGL)。
综合选项#
--open-last
打开近期打开过的 blend 文档,而不是默认的启动文档。
--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-extensions
设置
BLENDER_SYSTEM_EXTENSIONS
环境变量。--env-system-python
设置
BLENDER_SYSTEM_PYTHON
环境变量。-noaudio
禁用声音系统。
-setaudio
将音响系统强制到特定设备。
None
Default
SDL
OpenAL
CoreAudio
JACK
PulseAudio
WASAPI
。-c
,--command
<command>
Run a command which consumes all remaining arguments. Use
-c help
to list all other commands. Pass--help
after the command to see its help text.This implies
--background
mode.-h
,--help
打印帮助信息,并退出。
/?
打印帮助信息,并退出。
-r
,--register
对当前用户注册 .blend 扩展名,然后退出(仅适用于 Windows 和 Linux )。
--register-allusers
对所有用户注册 .blend 扩展名,然后退出(仅适用于 Windows 和 Linux )。
--unregister
对当前用户注销 .blend 扩展名,然后退出(仅适用于 Windows 和 Linux )。
--unregister-allusers
对所有用户注销 .blend 扩展名,然后退出(仅适用于 Windows 和 Linux )。
-v
,--version
打印 Blender 版本信息然后退出。
--
结束选项处理,传递的参数不变。通过 Python 的
sys.argv
访问。
参数解析#
参数必须用空格隔开,例如:
blender -ba test.blend
...将退出,因为 -ba
是未知参数。
参数顺序#
参数是按从左到右的顺序执行的,例如:
blender --background test.blend --render-frame 1 --render-output "/tmp"
...不会渲染到 /tmp
,因为不能在渲染路径(output)之前设置 --render-frame 1
参数。
blender --background --render-output /tmp test.blend --render-frame 1
...不会渲染到 /tmp
,因为加载 blend 文件会覆盖渲染输出设置。
blender --background test.blend --render-output /tmp --render-frame 1
以上命令行正确,可得到预期结果。
环境变量#
- BLENDER_USER_RESOURCES:
替换所有用户文件的默认目录。其他
BLENDER_USER_*
变量设置后会覆盖。- BLENDER_USER_CONFIG:
用户配置文件目录。
- BLENDER_USER_SCRIPTS:
用户脚本目录。
- BLENDER_USER_EXTENSIONS:
用户扩展目录。
- BLENDER_USER_DATAFILES:
用户数据文件目录(图标、翻译……)。
- BLENDER_SYSTEM_RESOURCES:
替换所有捆绑资源文件的默认目录。
- BLENDER_SYSTEM_SCRIPTS:
用以添加更多捆绑脚本的目录。
- BLENDER_SYSTEM_EXTENSIONS:
系统扩展存储库的目录。
- BLENDER_SYSTEM_DATAFILES:
替换捆绑数据文件的目录。
- BLENDER_SYSTEM_PYTHON:
用于替换捆绑的 Python 库的目录。
- OCIO:
覆盖 OpenColorIO 配置文件的路径。
- TEMP:
在此存储临时文件(MS-Windows)。
- TMPDIR:
在此存储临时文件(UNIX 系统)。路径必须引用现有目录,否则将被忽略。