文件路径

路径模板

当使用路径时,路径模板会在文件路径中替换 模板表达式(写成 {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_xresolution_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.png

  • dance_{fps:.###}.png -> dance_29.970.png

  • dance_{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 未正确关闭,将导致错误。

当路径中出现模板错误时,用户界面中的路径字段将以红色高亮显示:

../_images/files_file_paths-invalid_path_template.png

将鼠标悬停在路径字段上会弹出一个工具提示,其中包含在该路径中遇到的模板错误列表:

../_images/files_file_paths-invalid_path_template_tooltip.png

Note

根据路径的不同,模板错误可能会阻止某些操作。例如,如果渲染输出路径出现错误,那么渲染动画就会失败,同时会出现错误信息,说明路径错误。