DWV项目中的矢量标注更新机制解析

在医学影像处理领域，矢量标注（如矩形框、多边形ROI等）是常见的辅助诊断工具。本文深入解析DWV（DICOM Web Viewer）项目中矢量标注的更新机制，帮助开发者更好地理解和使用相关API。

核心API解析

DWV提供了DrawController.updateDraw方法用于更新矢量标注，该方法需要接收一个DrawDetails对象作为参数。常见的误区包括：

1. 参数类型混淆：开发者容易将getDrawStoreDetails()或getDrawDisplayDetails()的返回值直接作为参数传入，但前者返回的是存储格式的元数据，后者返回的是DrawDetails[]数组。

2. 数据结构要求：updateDraw要求传入单个DrawDetails对象，而非数组。正确的使用方式应该是：

const dc = app.getActiveLayerGroup().getActiveDrawLayer().getDrawController();
const detailsArray = dc.getDrawDisplayDetails();
// 取第一个标注详情进行更新
dc.updateDraw(detailsArray[0]);

标注数据结构详解

典型的矢量标注数据包含以下关键信息：

• 几何信息：包括宽度、高度等尺寸数据
• 量化数据：如面积、最小值、最大值等统计信息
• 元数据：如文本表达式等附加信息

示例数据结构：

{
  "id": {
    "meta": {
      "textExpr": "{surface}",
      "quantification": {
        "width": {"value": 50.72, "unit": "mm"},
        "height": {"value": 52.11, "unit": "mm"},
        "surface": {"value": 26.43, "unit": "cm²"}
      }
    }
  }
}

未来发展方向

DWV正在向DICOM结构化报告(SR)标准迁移，这将带来以下改进：

1. 标准化格式：解决当前标注格式不统一的问题
2. 三维支持：增强对三维标注数据的处理能力
3. 互操作性：提升与其他医学影像工具的兼容性

最佳实践建议

对于需要处理矢量标注的开发者：

1. 明确区分存储详情(getDrawStoreDetails)和显示详情(getDrawDisplayDetails)
2. 处理数组类型的返回结果时，注意提取单个标注对象
3. 关注项目向DICOM SR标准的迁移计划，提前做好兼容性设计

通过正确理解这些机制，开发者可以更高效地在DWV项目中实现矢量标注的创建、更新和管理功能。