命令行参数¶
Blender 2.93 命令行用法: Blender [args ...] [file] [args ...]
渲染选项¶
-b
,--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
如果文件名不包含
#
, 默认为文件名添加后缀####
。那么渲染器保存文件名的时候,就会把帧号添加到文件的结尾,如:
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-64], 0 for systems processor count.
格式选项¶
-F
,--render-format
<format>
设置渲染格式。有效选项有:
TGA
RAWTGA
JPEG
IRIS
IRIZ
AVIRAW
AVIJPEG
PNG
BMP
Formats that can be compiled into Blender, not available on all systems:
HDR
TIFF
OPEN_EXR
OPEN_EXR_MULTILAYER
MPEG
CINEON
DPX
DDS
JP2
-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脚本(py驱动与启动脚本)。
-P
,--python
<filename>
运行指定的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)>
Comma separated list of add-ons (no spaces).
日志选项¶
--log
<match>
启用日志记录类别,采用单个逗号分隔的参数。可以使用 "" .* "后缀匹配多个类别,因此"--log "wm.* 会记录所有类型的窗口管理器消息。子字符串可以使用 * 前缀和后缀进行匹配,因此 "--log"undo "会记录各种与撤消相关的消息。使用 "^"前缀忽略,因此 "--log",^wm.operator. "" 将记录除 "wm.operator.* 之外的所有日志。
--log-level
<level>
设置日志冗余等级(等级越高细节越多)默认为1,使用-1以启用所有等级。
--log-show-basename
只显示文件名称于输出中(不显示加载路径)。
--log-show-backtrace
显示日志信息回溯(仅限于debug模式)。
--log-show-timestamp
从启动后开始为每个日志信息添加以秒为单位的时间戳显示。
--log-file
<filename>
设定日志输出文件。
调试选项¶
-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-uuid
启用依赖树的调试消息(树构造)。
--debug-ghost
启用事件处理的调试消息。
--debug-gpu
对OpenGL 4.3+启用GPU调试上下文和信息。
--debug-gpu-force-workarounds
启用典型GPU问题的解决方案并禁用所有GPU扩展。
--debug-wm
启用窗口管理器的调试消息,同时逐个打印operator调用,打印键位映射错误。
--debug-xr
为虚拟现实上下文启用调试消息。启用 OpenXR API 验证层、(OpenXR)调试消息和常规信息打印。
--debug-xr-time
为虚拟现实帧渲染时间启用调试消息。
--debug-all
启用全部调试消息。
--debug-io
启用来自I/O (collada, ...)的调试消息。
--debug-fpe
浮点和十进制的整数。
--debug-exit-on-error
检测到内部错误时立即退出。
--disable-crash-handler
禁用崩溃处理程序。
--disable-abort-handler
禁用中止处理程序。
--verbose
<verbose>
为支持该级别的调试消息设置日志记录详细程度级别。
综合选项¶
--open-last
打开最近打开的混合文档,而不是默认的启动文档。
--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
将音响系统强制到特定设备。 "无" "SDL" "开放" "核心音频" "杰克" "脉冲音频" "WASAPI"。
-h
,--help
打印帮助信息,并退出。
/?
打印帮助信息,并退出。
-R
注册 .blend 扩展名,然后退出 (仅适用于Windows)
-r
悄悄注册 .blend 扩展名(不弹出提示对话框),然后退出 (仅适用于Windows)
-v
,--version
打印Blender版本信息并退出。
--
结束选项处理,传递的参数不变。通过Python的
sys.argv
访问。
其他选项¶
--debug-freestyle
启用FreeStyle调试信息。
参数顺序¶
参数是按从左到右的循序执行的,例如:
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
,由于加载混合文件会覆盖渲染输出设置。
blender --background test.blend --render-output /tmp --render-frame 1
以上命令行正确,可得到预期结果。
环境变量¶
- BLENDER_USER_CONFIG
用户配置文件目录。
- BLENDER_USER_SCRIPTS
用户脚本目录。
- BLENDER_SYSTEM_SCRIPTS
系统脚本目录。
- BLENDER_USER_DATAFILES
用户数据文件目录 (icons, translations, ..).
- BLENDER_SYSTEM_DATAFILES
系统数据文件目录。
- BLENDER_SYSTEM_PYTHON
系统Python库目录.
- TEMP
临时文件目录。
- TMP
或 $TMPDIR 临时文件目录.