cornerstoneTools测量工具指南：LengthTool、AngleTool与BidirectionalTool三步上手完整用法

cornerstoneTools测量工具指南LengthTool、AngleTool与BidirectionalTool三步上手完整用法【免费下载链接】cornerstoneToolsA framework for tools built on top of Cornerstone.项目地址: https://gitcode.com/gh_mirrors/co/cornerstoneToolscornerstoneTools 是构建在 Cornerstone 之上的医学影像工具框架本文带你快速掌握它最实用的三类测量工具LengthTool 直线测距、AngleTool 角度测量和 BidirectionalTool 病灶双向径测量无需任何医学影像开发经验即可看懂。一、测量工具能帮你做什么在 CT / MRI 影像阅片中医生常常需要量距离测量病灶大小、器官间距LengthTool量角度脊柱侧弯、骨骼关节角度AngleTool量双向径肿瘤的长轴与短轴径BidirectionalTool这三个工具都继承自BaseAnnotationTool源码见src/tools/base/BaseAnnotationTool.js因此交互方式高度一致点击放置控制点 → 拖拽微调 → 实时显示数值文本框同时支持鼠标和触控两种交互方式。二、三步启用测量工具所有测量工具的启用流程完全相同三步搞定初始化框架调用cornerstoneTools.init()注册工具通过addTool()把工具加入系统激活工具通过setToolActive()指定鼠标按钮即可开始测量const LengthTool cornerstoneTools.LengthTool; cornerstoneTools.addTool(LengthTool); cornerstoneTools.setToolActive(Length, { mouseButtonMask: 1 });把工具名换成Angle或Bidirectional即可切换到另外两种测量模式官方示例位于examples/tools/length.md、examples/tools/angle.md和examples/tools/bidirectional.md。三、LengthTool两点测距毫米级读数适用场景测量任意两点间的直线距离是最常用的基础测量工具。操作步骤点击图像放置起点拖动并点击放置终点文本框自动显示测量值拖动任意端点可实时调整关键细节源码src/tools/annotation/LengthTool.js 单位智能切换图像带有像素间距信息时显示mm否则回退为pixels 小数位数可通过digits配置默认保留 2 位️ 点击距直线 25 像素以内即可选中该测量线方便二次编辑四、AngleTool三点定角余弦定理精确计算适用场景脊柱侧弯 Cobb 角、关节角等角度测量。操作步骤第一击放置角的顶点middle 控制点第二击沿第一条边放置起点start第三击沿第二条边放置终点end关键细节源码src/tools/annotation/AngleTool.js 内部使用余弦定理计算角度结果存入rAngle显示为带 ° 符号的度数保留 2 位小数⚠️ 任一击取消如点击空白处失败整条角度标注会自动删除 缺少像素间距信息时会在度数后附加(isotropic)提示五、BidirectionalTool病灶长短轴一次测完适用场景肿瘤、结节等病灶的标准双向径测量长轴 × 短轴。操作步骤点击病灶边缘放置第一个端点拖动跨过病灶中心点击放置第二个端点自动形成长轴系统自动生成与长轴垂直的短轴线拖动垂直手柄即可完成双向径测量关键细节源码src/tools/annotation/BidirectionalTool.js逻辑分布在src/tools/annotation/bidirectionalTool/目录 自动计算longestDiameter长径与shortestDiameter短径两个测量值 支持textBox配置自定义文本前缀additionalData追加自定义数据行 默认开启drawHandlesOnHover鼠标悬停即显示控制点微调更顺手六、三大工具配置项速查表配置项LengthToolAngleToolBidirectionalTool说明drawHandles✅ 默认开✅ 默认开✅ 默认开是否绘制控制点drawHandlesOnHover默认关默认关✅ 默认开悬停时是否显示控制点renderDashed✅✅✅是否用虚线渲染hideHandlesIfMoving✅✅✅拖动时隐藏控制点digits✅ 默认 2——数值小数位数additionalData——✅文本框附加数据行七、想深入了解去这里 标注工具基类说明docs/latest/tool-types/base-annotation-tool.md️ 工具结构与测量数据章节docs/latest/anatomy-of-a-tool/measurement-data.md 角度工具计算逻辑src/tools/annotation/AngleTool.jsupdateCachedStats方法 长短轴计算算法src/tools/annotation/bidirectionalTool/utils/calculateLongestAndShortestDiameters.js小结三个工具覆盖了 90% 的日常测量需求——量距离选 LengthTool、量角度选 AngleTool、量病灶选 BidirectionalTool。掌握addTool setToolActive的三步启用套路你就能在自己的影像应用中快速落地专业的测量功能。【免费下载链接】cornerstoneToolsA framework for tools built on top of Cornerstone.项目地址: https://gitcode.com/gh_mirrors/co/cornerstoneTools创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考