为了使新工具的开发快速、简单且相对无样板，所有工具都扩展了一个基类，该基类提供了无缝集成到 cornerstoneTools 框架中所需的功能。

基类有两种类型的方法可供工具开发人员使用：

• @abstract methods: 这些方法必须由子类实现。
• @virtual methods: 这些方法具有默认功能，但可能会被子类覆盖以更改功能。

虚拟方法

BaseTool 是 Cornerstone Tools 中所有工具的顶级父项。它负责初始化工具的配置、应用混合以及为活动工具Active tools的鼠标/触摸交互提供 @virtual functions。

Virtual Methods:

• preMouseDownCallback
• postMouseDownCallback
• preTouchStartCallback
• postTouchStartCallback

Cursors (可选)

任何工具都可以定义光标，以便在活动时替换鼠标光标。此功能是可选的。你必须将 globalConfigurationModule 选项 showSVGCursors 设置为 true 才能使用它们。这可以在 cornerstoneTools 初始化时完成：

cornerstoneTools.init({ showSVGCursors: true });

工具可以通过将 svgCursor 设置为 MouseCursor 对象，或者通过为每个策略标签设置一组游标来实现单个游标：

// ...
cursors: {
  FILL_INSIDE: segCircleFillInsideCursor,
  FILL_OUTSIDE: segCircleFillOutsideCursor,
  ERASE_OUTSIDE: segCircleEraseOutsideCursor,
  ERASE_INSIDE: segCircleEraseInsideCursor,
},
// or
svgCursor: segCircleFillInsideCursor,
// ...

如果你使用的是由游标实现的 cursor-by-strategy 方法，则无需设置默认的 svgCursor，因为 BaseTool 将为你执行此操作。

Base Annotation Tool

BaseAnnotationTool 是 BaseTool 的扩展，用于创建和操作注释数据。

Abstract Methods:

• createNewMeasurement
• pointNearTool
• distanceFromPoint
• renderToolData

Virtual Methods:

• mouseMoveCallback
• handleSelectedCallback
• toolSelectedCallback
• updateCachedStats

Base Brush Tool

BaseBrushTool 是BaseTool 的扩展，它通过在画布上绘画来编辑分割模块的 Labelmap3D 数据，用于创建和编辑分段。与 BaseAnnotationTool的子类不同，BaseBrushTool 的子类不管理其自身数据的呈现。分割掩模的渲染集中在 src/eventListeners/onImageRenderedBrushEventHandler.js。分割模块的 renderFill 或 renderOutline 配置选项为 true，Labelmap2D 对象存在于显示的基石图像上。

• Abstract Methods:renderBrush_paint
• Virtual Methods:mouseDragCallbackpreMouseDownCallback_startPainting_endPainting

Segmentation Tools

“分割工具”是 BaseTool 的衍生工具，它们以某种方式与标签映射图层交互，而不是通过手动刷新，为此，你可以选择从 BaseBrushTool派生。

1. 解析

Segmentation Tools 更像是一种模块化设计模式，而不是一种工具类型，因此是通过组合而不是继承构建的。SegmentationTools 由几个组件组成：

• Segmentation Mixin - 分段混合的作用是提供一种描述机制，该机制会生成一个 operationData 对象，该对象将与基石事件一起传递给活动策略。
• segmentation mixin 调用this.applyActiveStrategy(evt, operationData)的时候，一个或多个strategies 会被调用
• strategies的一个鼠标的可选设置

1. 举例

下面是一个 Segementation Tool:

/**
 * @public
 * @class CircleScissorsTool
 * @memberof Tools
 * @classdesc Tool for manipulating labelmap data using a circle.
 * @extends Tools.Base.BaseTool
 */
export default class CircleScissorsTool extends BaseTool {
  /** @inheritdoc */
  constructor(props = {}) {
    const defaultProps = {
      name: 'CircleScissors',
      strategies: {
        FILL_INSIDE: fillInsideCircle,
        FILL_OUTSIDE: fillOutsideCircle,
        ERASE_OUTSIDE: eraseOutsideCircle,
        ERASE_INSIDE: eraseInsideCircle,
      },
      cursors: {
        FILL_INSIDE: segCircleFillInsideCursor,
        FILL_OUTSIDE: segCircleFillOutsideCursor,
        ERASE_OUTSIDE: segCircleEraseOutsideCursor,
        ERASE_INSIDE: segCircleEraseInsideCursor,
      },
      defaultStrategy: 'FILL_INSIDE',
      supportedInteractionTypes: ['Mouse', 'Touch'],
      svgCursor: segCircleFillInsideCursor,
      mixins: ['circleSegmentationMixin'],
    };

    super(props, defaultProps);
  }
}

让我们分析一下segmentation tools:

1. Segmentation Mixins

// ...
mixins: ['circleSegmentationMixin'];
// ...

该 mixins 属性可以像与 BaseTool 一样使用，但必须至少使用一个segmentation mixin。分段混音的工作是通过某种方式获取用户输入，实施_applyStrategy，并使用适当的输入调用策略。

1. Mixin-aware Strategies

// ...
strategies: {
  FILL_INSIDE: fillInsideCircle,
  FILL_OUTSIDE: fillOutsideCircle,
  ERASE_OUTSIDE: eraseOutsideCircle,
  ERASE_INSIDE: eraseInsideCircle,
},
// ...
defaultStrategy: 'FILL_INSIDE',
// ...

strategies prop 定义了一组可以在描述结束时执行的操作。Strategies需要工具的segmentation mixin来提供operationData 。

本系列文章持续更新中，如果你觉得有帮助到你，请点赞收藏分享，感谢！