【从0上手Cornerstone3D】如何使用CornerstoneTools中的工具之工具介绍
简单介绍一下在Cornerstone中什么是工具，工具是一个未实例化的类，它至少实现了BaseTool接口。
如果我们想要在我们的代码中使用一个工具，则必须实现以下两个步骤：
-
使用Cornerstone的顶层addTool函数添加未实例化的工具
-
将工具添加到工具组中
支持的工具类型
我们在使用工具时，主要会涉及到对图像的原始操作(缩放、平移等等)、注释操作(在图像的上层圈定一定的区域查看信息)、分割操作等等。
所以介绍的工具主要分为以下三大类：
-
操作类工具
-
注释类工具
-
分割类工具
操作类工具
Cornerstone3DTools提供了一组工具，可用于在视口中操作图像。主要包括
-
放大和缩小图像(ZoomTool)
-
平移图像(PanTool)
-
滚动图像的instance(StackScrollMouseWheelTool)
-
操作图像的windowLevel (WindowLevelTool)
注释类工具
Cornerstone3DTools提供了一套注释工具。可以用来创建和编辑注释
-
测量两点距离(Length Tool)
-
测量宽度和长度(Bidirectional Tool)
-
矩形面积的测量和统计(RectangleRoi Tool)
-
测量椭球体的体积和统计信息(EllipseRoi Tool)
-
获取体素的底层值(Probe Tool)
分割类工具
Cornerstone3D还提供了分割工具。这包括3D SegmentationDisplay和3D分割编辑工具，如画笔，矩形和圆形剪刀，以及3D球体工具。
工具的模式
我们注册的工具(在对应的toolGroup中)可以处于以下四种模式之一，每种模式都会影响工具对交互的响应方式。📢 注意：在同一种绑定方式下有且仅有一种工具被激活，不会有两个工具被激活
| 模式 | 对应的交互效果 |
|---|---|
| Active（激活模式） | 1. Active模式下的工具将响应交互 2. 如果该工具是注释工具，则单击未覆盖现有注释的事件将创建新注释，覆盖现在注释将选中注释 |
| Passive (default)（消极模式） | 1. 如果工具是注释工具，如果它可以被选中，它可以被移动和重新定位。2. 不响应交互 |
| Enabled（可用模式） | 1. 工具可以呈现，但不能进行交互响应 |
| Disabled（禁用模式） | 1. 工具既不渲染，也不会响应交互 |
总结回顾
工具组
ToolGroup是Cornerstone3D中的一个新概念。
ToolGroup的目标是定义一种简单的方法，以每个视口方式定义工具的行为。 除此之外，绑定了同一个TooGroup的Viewport可以共享工具组相同的配置、模式及组内的工具。
Viewport 和 ToolGroup 的关系
Viewport 和 ToolGroup 是一对一的关系，同一个ToolGroup可以绑定多个Viewport，但是一个Viewport只能绑定一个ToolGroup
创建及使用工具组
toolGroup由ToolGroupManager管理。ToolGroupManager用于创建、搜索和销毁工具组
初始化工具组
import { ToolGroupManager } from '@cornerstonejs/tools';const toolGroupId = 'ctToolGroup';
const ctToolGroup = ToolGroupManager.createToolGroup(toolGroupId);
工具组添加工具
ctToolGroup.addTool(PanTool.toolName);
ctToolGroup.addTool(ZoomTool.toolName);
ctToolGroup.addTool(ProbeTool.toolName);
工具组与视图进行绑定
ctToolGroup.addViewport(viewportId, renderingEngineId);
激活一个工具
ctToolGroup.setToolActive(LengthTool.toolName, {bindings: [{ mouseButton: MouseBindings.Primary }],
});
ctToolGroup.setToolActive(PanTool.toolName, {bindings: [{ mouseButton: MouseBindings.Auxiliary }],
});
ctToolGroup.setToolActive(ZoomTool.toolName, {bindings: [{ mouseButton: MouseBindings.Secondary }],
});
ctToolGroup.setToolActive(StackScrollMouseWheelTool.toolName);
总结回顾
