文件路径¶
路径模板¶
当使用路径时,路径模板会在文件路径中替换 模板表达式(写成 {abcd},其中 "abcd" 是 变量 名)。
例如,如果当前打开的 blend 文件是 dance.blend,且渲染输出路径设置为该文件:
//my_render_dir/{blend_name}.png
然后在渲染时,Blender 就会将路径视为:
//my_render_dir/dance.png
{blend_name} 会被 dance.blend 中的 dance 替换。
这种替换是在使用时(如渲染时)在内部进行的,因此路径字段中的模板语法将保持不变。
Note
目前,路径模板仅支持场景属性中的 渲染输出路径 与合成器 文件输出节点 中的输出路径。未来版本中将有更多文件路径支持模板。
可用的变量¶
模板表达式中目前可用的变量如下:
blend_name:当前 blend 文件的名称(不含 .blend)。
fps:当前场景的每秒帧数。
resolution_x / resolution_y:渲染图像的 x 和 y 分辨率。如果场景分辨率为 1000x600,缩放比例为 50%,那么
resolution_x和resolution_y将分别为 500 和 300.
可用变量集将随着时间的推移而不断扩大。
语法¶
一个基本的模板表达式只需用大括号将变量名包起来:
dance_{fps}.png
格式指定符¶
模板表达式还可以包含格式指定符。格式指定符指示 Blender 如何对替换值进行格式化。它们写在分隔冒号之后,就像下面这样:
dance_{fps:FORMAT}.png
格式指定符目前只能用于表示数值的变量,而不能用于字符串值。可用的格式指定符有:
dance_{fps:###}.png:格式为至少三位数的整数。dance_{fps:.###}.png:格式为浮点数,小数点后正好是三位数。dance_{fps:###.##}.png:格式为浮点数,整数部分至少有三位数,小数部分正好有二位数。
在所有情况下,井号 (#) 的数量表示所需的位数。
例如,如果 fps 为 29.97,那么:
dance_{fps:###}.png->dance_030.pngdance_{fps:.###}.png->dance_29.970.pngdance_{fps:###.##}.png-> ->dance_029.97.png
请注意,数值已按给定位数四舍五入。
如果未给出格式说明,则将使用命名变量的默认格式(例如,浮点表示 fps,整数表示分辨率)。
转义序列¶
由于 { 和 } 在支持模板表达式的路径中用于模板表达式,因此当需要在这样的路径中使用字面的 { 或 } 时,必须通过将它们书写两次来转义:
{{会在最终路径中转换为单个{。}}会在最终路径中转换为单个}。
例如:
my_weird}}_{{path.png->my_weird}_{path.png//my_render_{{dir}}/{blend_name}.png->//my_render_{dir}/dance.png//my_render_dir/{{{blend_name}}}.png->//my_render_dir/{dance}.png
错误¶
支持模板的路径可能会出现模板错误,导致路径无法被处理。
例如,在以下路径中:
//my_render_dir/{blend_name.png
表达式 {blend_name 未正确关闭,将导致错误。
当路径中出现模板错误时,用户界面中的路径字段将以红色高亮显示:
将鼠标悬停在路径字段上会弹出一个工具提示,其中包含在该路径中遇到的模板错误列表:
Note
根据路径的不同,模板错误可能会阻止某些操作。例如,如果渲染输出路径出现错误,那么渲染动画就会失败,同时会出现错误信息,说明路径错误。