bpy.ops.geometry.attribute_remove

在几何体对象中删除指定属性的操作。

参数

• type (str): 要删除的属性的类型。仅限 VERTEX, EDGE, FACE, CORNER, LOOP, HOOK, SHAPE_KEY 或 META.
• name (str): 要删除的属性的名称。

返回值

• ({'FINISHED'}): 删除成功。

描述

该操作从指定的几何体对象中删除具有给定名称的属性。

该操作只能用于具有相应属性的对象。例如，如果要从“面”对象中删除一个属性，则它必须具有已指定名称的属性。

因此，在运行此操作之前，应始终先检查指定的对象是否具有要删除的属性。

此外，还应注意其它操作如，bpy.ops.transform.translate 和 bpy.ops.mesh.extrude_region_shrink_fatten，它们也可能会添加或删除某些属性。因此，应谨慎处理这些操作。

示例

import bpy

obj = bpy.context.object.data

# 检查是否具有要删除的属性
if 'my_custom_vertex_attribute' in obj.vertices.layers.int:
    bpy.ops.geometry.attribute_remove(type='VERTEX', name='my_custom_vertex_attribute')
    print('自定义顶点属性已成功删除!')
else:
    print('找不到自定义顶点属性!')

异常

• RuntimeError: 当指定的属性不存在时，抛出此异常。