bpy.ops.geometry.attribute_add

该操作将添加一个新的几何属性到对象的几何数据中。

参数

• attribute_type (枚举值): 新几何属性的类型。包括 FLOAT、INT、STRING。
• name (字符串): 新几何属性的名称。属性名称必须是唯一的。
• value (浮点数，整数，字符串): 新几何属性的值。

返回值

该操作不返回任何值。

示例

import bpy

obj = bpy.context.object  # 获取当前对象

# 添加一个新的浮点数属性
bpy.ops.geometry.attribute_add(attribute_type='FLOAT', name='MyFloat', value=3.14)

# 添加一个新的字符串属性
bpy.ops.geometry.attribute_add(attribute_type='STRING', name='MyString', value='Hello World!')

# 添加一个新的整数属性
bpy.ops.geometry.attribute_add(attribute_type='INT', name='MyInt', value=42)

# 输出属性列表
for attr in obj.data.attributes:
    print("Attribute '{}' of type '{}' and value '{}'".format(attr.name, attr.type, attr.data[0]))

异常

• ValueError: 如果属性名称不是唯一的，则会引发此异常。
• TypeError: 如果传递的属性值与属性类型不匹配，则会引发此异常。例如，如果指定了整数类型，但传递了浮点数的属性值，则会引发此异常。