bpy.context.annotation_data

注解数据内容的上下文

bpy.context.annotation_data 表示当前场景中注解数据的上下文。注解数据是Blender中一个涉及注释的系统，它允许用户在3D场景中创建注释和说明信息，并且可以控制注释的外观和位置等属性。

示例

以下示例展示了如何获取注解数据的上下文，并打印注解数据的名称：

import bpy

# 获取当前注解数据的上下文
annotation_data = bpy.context.annotation_data

# 打印注解数据的名称
print("Annotation data name:", annotation_data.name)

属性

bpy.context.annotation_data 有以下属性：

bpy.context.annotation_data.name

当前注解数据的名称。默认为“Annotations”。

import bpy

# 获取当前注解数据的上下文
annotation_data = bpy.context.annotation_data

# 打印注解数据的名称
print("Annotation data name:", annotation_data.name)

bpy.context.annotation_data.color

当前注解数据的颜色。默认为白色（1.0, 1.0, 1.0）。

import bpy

# 获取当前注解数据的上下文
annotation_data = bpy.context.annotation_data

# 打印注解数据的颜色
print("Annotation data color:", annotation_data.color)

方法

bpy.context.annotation_data 有以下方法：

bpy.context.annotation_data.draw_handler_add(callback, args, *kwargs)

添加一个回调函数，用于在注解上下文内绘制数据。

import bpy
from bpy.types import SpaceView3D

def draw_callback_px(self, context):
    # 绘制圆形
    bgl.glColor3f(1.0, 0.0, 0.0)
    draw_circle_2d(20, 20, 50)

# 获取3D视图区域的引用
area = bpy.context.area
space = bpy.context.space_data
if isinstance(space, SpaceView3D) and area.type == 'VIEW_3D':
    # 获取当前注解数据的上下文
    annotation_data = bpy.context.annotation_data
    
    # 添加绘制回调
    annotation_data.draw_handler_add(draw_callback_px, (self, bpy.context), 'WINDOW', 'POST_PIXEL')

bpy.context.annotation_data.draw_handler_remove(handle, *args)

移除一个回调函数，在注解上下文中停止绘制数据。

import bpy
from bpy.types import SpaceView3D

def draw_callback_px(self, context):
    # 绘制圆形
    bgl.glColor3f(1.0, 0.0, 0.0)
    draw_circle_2d(20, 20, 50)

# 获取3D视图区域的引用
area = bpy.context.area
space = bpy.context.space_data
if isinstance(space, SpaceView3D) and area.type == 'VIEW_3D':
    # 获取当前注解数据的上下文
    annotation_data = bpy.context.annotation_data
    
    # 添加绘制回调
    handle = annotation_data.draw_handler_add(draw_callback_px, (self, bpy.context), 'WINDOW', 'POST_PIXEL')

    # 移除绘制回调
    annotation_data.draw_handler_remove(handle, 'WINDOW')

异常

如果未找到注解数据的上下文，则会引发 bpy.context.annotation_data.DoesNotExist 异常。

import bpy

try:
    # 获取当前注解数据的上下文
    annotation_data = bpy.context.annotation_data
except bpy.context.annotation_data.DoesNotExist:
    print("Annotation data does not exists!")