bpy.ops.font.textbox_add

该命令用于向当前选中的文本对象添加一个新的文本框。

参数

• align_mode (枚举): 对齐模式("LEFT", "CENTER", "RIGHT")，默认为'LEFT'。
• location (浮点数元组): 新文本框的位置，默认值为(0.0, 0.0, 0.0)。
• size (浮点数元组): 新文本框的大小，默认值为(1.0, 1.0, 1.0)。
• rotation (浮点数): 新文本框绕其自身 Z 轴的旋转角度(以弧度为单位)，默认值为0.0。
• blend (布尔值): 是否进行混合，默认值为False。
• merge_text (布尔值): 是否合并文本，将文本对象的所有字符连接起来放入新文本框中，默认值为False。

返回值

• 返回类型: {'FINISHED'}

示例

添加默认文本框到当前选择的文本对象

import bpy

# 选择文本对象
bpy.ops.object.select_all(action='DESELECT')
bpy.context.view_layer.objects.active = bpy.data.objects['Text']
bpy.data.objects['Text'].select_set(True)

# 添加默认文本框
bpy.ops.font.textbox_add()

添加位置、大小和旋转设置的文本框到当前选择的文本对象

import bpy

# 选择文本对象
bpy.ops.object.select_all(action='DESELECT')
bpy.context.view_layer.objects.active = bpy.data.objects['Text']
bpy.data.objects['Text'].select_set(True)

# 添加新文本框，设置位置、大小和旋转
bpy.ops.font.textbox_add(location=(1.0, 1.0, 0.0), size=(2.0, 2.0, 2.0), rotation=1.57)

添加一个合并所有文本的文本框到当前选择的文本对象

import bpy

# 选择文本对象
bpy.ops.object.select_all(action='DESELECT')
bpy.context.view_layer.objects.active = bpy.data.objects['Text']
bpy.data.objects['Text'].select_set(True)

# 添加新文本框，合并所有文本
bpy.ops.font.textbox_add(merge_text=True)

异常

可能会抛出以下异常：

• RuntimeError: 当未选择任何文本对象时。
• RuntimeError：当选择多个文本对象时。