bpy.ops.file.filenum

在文件名中添加序号。例如，如果文件名是"example.jpg"，则添加序号后变为"example_001.jpg"，序号可以自定义起始编号和填充位数。

参数

• start: 序号起始值，默认为1。
• padding: 填充数字宽度（位数），默认为3。
• use_directory: 如果为True，则在目录路径和文件名之间添加序号。
• use_extension: 如果为True，则在文件名和扩展名之间添加序号。

返回值

• 返回处理后的文件名。如果文件名不符合要求，将引发TypeError。

示例

import bpy

file_path = "//example.jpg"
new_file_path = bpy.ops.file.filenum(filepath=file_path, start=5, padding=4, use_directory=False, use_extension=True)

此示例将文件名"example.jpg"变为"example_0005.jpg"。

异常

如果文件路径为空或不是字符串类型，则引发TypeError。如果文件名不包含扩展名，则引发ValueError。