将旧版本的Grease Pencil文件转换为当前版本。
此操作将在场景中创建一个新的Grease Pencil对象,其中包含旧版本中的数据。
filepath
(string) - 要转换的旧文件路径。directory
(string) - 旧文件所在的目录。如果未提供,则使用filepath
中的目录。filter_glob
(string) - 根据文件名过滤文件,例如*.txt
。如果没有提供,则默认为*
。{"FINISHED"}
- 转换成功。以下示例将转换名为old_file.gpencil
的旧版Grease Pencil文件:
import bpy
filepath = "/path/to/old_file.gpencil"
bpy.ops.gpencil.convert_old_files(filepath=filepath)
此操作创建的Grease Pencil对象名称将基于旧文件的名称,如果会导致名称冲突,则新对象名称将使用数字后缀进行标记。
该操作不会自动将全局Grease Pencil设置中的旧版本自动更新为新版本,需要手动更改。