bpy.ops.font.unlink

解除字体绑定

解除一个 Text 对象中绑定的字体。

参数

• filepath: 文件路径，选择解除绑定的字体文件的路径。
• check_existing: 是否检查文件是否存在，类型为布尔值，可选参数，默认为 True。

返回值

• {'FINISHED'}: 如果操作成功完成，则返回完成标识。

示例

import bpy

# 获取当前文件中选择的 Text 对象
text = bpy.context.selected_objects[0]

# 解除字体绑定
bpy.ops.font.unlink(filepath="path/to/font.ttf", check_existing=False)

异常

• FileNotFoundError: 如果指定的文件路径不存在，则会抛出此异常。
• TypeError: 如果未选择 Text 对象，则会抛出此异常。

注意事项

• 如果 Text 对象未绑定字体，则不会执行任何操作。
• 如果指定的字体文件路径不存在，则操作将失败并抛出异常。
• 如果未选择 Text 对象，则会抛出异常提示用户选择一个 Text 对象。