【从0上手Cornerstone3D】如何使用CornerstoneTools中的工具之工具介绍

简单介绍一下在Cornerstone中什么是工具,工具是一个未实例化的类,它至少实现了BaseTool接口。

如果我们想要在我们的代码中使用一个工具,则必须实现以下两个步骤:

  1. 使用Cornerstone的顶层addTool函数添加未实例化的工具

  2. 将工具添加到工具组中

支持的工具类型

我们在使用工具时,主要会涉及到对图像的原始操作(缩放、平移等等)、注释操作(在图像的上层圈定一定的区域查看信息)、分割操作等等。

所以介绍的工具主要分为以下三大类:

  • 操作类工具

  • 注释类工具

  • 分割类工具

操作类工具

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. 工具既不渲染,也不会响应交互

总结回顾

【从0上手Cornerstone3D】如何使用CornerstoneTools中的工具之工具介绍_第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);

总结回顾

【从0上手Cornerstone3D】如何使用CornerstoneTools中的工具之工具介绍_第2张图片

你可能感兴趣的:(CornerStone3D,cornerstone3D,医学影像,cornerstone)