OHIF cornerstone-dicom-seg 扩展深度解析DICOM SEG 读取、渲染与演进路线【免费下载链接】ViewersOHIF zero-footprint DICOM viewer and oncology specific Lesion Tracker, plus shared extension packages项目地址: https://gitcode.com/GitHub_Trending/vi/Viewers本技术指南以 OHIF Viewers 仓库中extensions/cornerstone-dicom-seg扩展及其 CHANGELOG.md 为主体系统梳理该扩展在 DICOM SEG分割对象读取、体积标签图Labelmap渲染、SEG 视口、水合Hydration机制与定制化配置方面的完整实现与多年演进脉络。读者将掌握 SEG 扩展的模块组成与加载调用链、labelmap/bitmap 双解析器与存储配置、多帧 SEG 的性能优化策略以及如何借助segmentation.*系列定制化项调整默认行为。扩展定位与模块组成cornerstone-dicom-seg是 OHIF 提供 DICOM SEG 读取工作流read workflow的官方扩展。根据其 README 的说明该扩展允许在 OHIF 中加载 DICOM SEG 图像并显示当前分割以体积标签图volumetric labelmap的形式加载并作为 3D 体积渲染。扩展还提供一个 SEG 视口用于渲染和审查 DICOM SEG 图像如需完整加载所有分割段segments需要点击视口操作栏viewport action bar上的 SEG Pill 按钮以触发完整加载。从扩展入口 index.tsx 可以看到该扩展向 OHIF 注册了以下模块getViewportModule注册名为dicom-seg的视口组件底层通过React.lazy按需加载 OHIFCornerstoneSEGViewport.tsx并注入servicesManager、extensionManager、commandsManagergetSopClassHandlerModule为 SEG 系列提供 SopClassHandler将系列转换为 DisplaySetgetHangingProtocolModule提供 SEG 相关的挂片协议getCommandsModule/getCustomizationModule/getToolbarModule提供命令、定制化默认值与工具栏按钮。SopClassHandler从 DICOM SEG 系列到 DisplaySetSEG 扩展的核心入口是 getSopClassHandlerModule.ts。该模块声明了两个 DICOM SOP Class UIDconst sopClassUids [1.2.840.10008.5.1.4.1.1.66.4, 1.2.840.10008.5.1.4.1.1.66.7]; const LABELMAP_SEG_SOP_CLASS_UID 1.2.840.10008.5.1.4.1.1.66.7;其中1.2.840.10008.5.1.4.1.1.66.7是 Segmentation StorageLabel Map Segmentation即标签图分割SOP Class1.2.840.10008.5.1.4.1.1.66.4是 Bitmap Segmentation位图分割SOP Class。二者均在本扩展的 segmentationConfig.ts 中被命名导出export const LABELMAP_SEG_SOP_CLASS_UID 1.2.840.10008.5.1.4.1.1.66.7; export const BITMAP_SEG_SOP_CLASS_UID 1.2.840.10008.5.1.4.1.1.66.4;_getDisplaySetsFromSeries负责把 SEG 实例构造成 OHIF 的 DisplaySet关键处理逻辑包括选择实例列表中最后一个实例最近创建的作为当前实例通过utils.getLatestInstanceDateTime取实例日期时间作为 DisplaySet 日期时间构造标记isDerivedDisplaySet: true、isOverlayDisplaySet: true、isLoaded: false、isHydrated: false的派生 DisplaySet从instance.ReferencedSeriesSequence中解析被引用系列referencedSeriesInstanceUID与被引用图像referencedImages通过displaySetService.getDisplaySetsForReferences找到被引用的 DisplaySet即分割所叠加的灰度系列若引用多个系列则默认取第一个并给出警告当被引用 DisplaySet 尚不存在时订阅DISPLAY_SETS_ADDED事件待被引用系列加入后回填referencedDisplaySetInstanceUID与FrameOfReferenceUID处理 SEG 元数据中不含引用 UID 的常见情况返回的 DisplaySet 携带load函数供上层按需调用。加载链路从网络字节到 Cornerstone3D 分割状态DisplaySet 的load函数最终指向 getSopClassHandlerModule.ts 中的_load其内部通过_loadSegments完成真正的解析调用链可概括为去重_load维护loadPromises[SOPInstanceUID]若该 SEG 已在加载或已加载且分割已存在直接返回同一个 Promise避免重复网络请求。解析器类型判定getSegmentationParserType(sopClassUID, customizationService)依据 SOP Class UID 返回labelmap或bitmap详见 segmentationConfig.ts未知类型时回退到存储默认模式。被引用系列 imageId 解析优先使用被引用 DisplaySet 缓存的imageIds其次通过 dataSource 的getImageIdsForDisplaySet扩展最后回退到images.map(img img.imageId)。调用适配器解析核心解析由cornerstonejs/adapters的adaptersSEG.Cornerstone3D.Segmentation.createFromDicomSegImageId完成传入 metadataProvider、容差tolerance 0.001、解析器类型、帧 imageId 列表与帧解码并发数。颜色归一化解析得到的每个分割段的RecommendedDisplayCIELabValueDICOM 标准推荐的 CIELab 显示色通过dicomlabToRGB转为 RGBA若缺失则回退到CONSTANTS.COLOR_LUT调色板索引色并通过uiNotificationService提示用户使用了默认颜色。结果合并Object.assign(segDisplaySet, results)把解析出的segments、labelMapImageIds 等写回 DisplaySet随后由segmentationService.createSegmentationForSEGDisplaySet创建 Cornerstone3D 分割状态。整个加载过程通过eventTarget.addEventListener(Enums.Events.SEGMENTATION_LOAD_PROGRESS, onProgress)广播SEGMENT_LOADING_COMPLETE进度事件供视口 UI 展示加载百分比finally中移除监听并取消预取。SEG 视口与加载 / 水合机制OHIFCornerstoneSEGViewport.tsx 是 SEG 专属视口。其源码对加载loading与水合hydration做了明确区分loadingSEG 数据经网络加载并对像素位进行解包bit unpacking即把 DICOM SEG 像素数据转换为可用 labelmaphydrationSEG 被打开且所有分割段载入分割面板并叠加渲染到所有与被引用系列处于同一FrameOfReferenceUID的视口上。视口通过useViewportGrid感知当前视口网格为每个视口生成独立工具组SEGToolGroup-${viewportId}见 initSEGToolGroup.ts并将底层渲染委托给OHIFCornerstoneViewport传入displaySets{[referencedDisplaySet, segDisplaySet]}——即底层堆栈使用被引用系列SEG 作为叠加层overlay显示。这与扩展 README 中SEG 作为体积 labelmap 加载并以 3D 体积显示的描述一致基础层是原始灰度系列分割层是渲染在上的彩色 labelmap。视口对被引用 DisplaySet 缺失的场景做了健壮性处理当referencedDisplaySetInstanceUID不存在例如直接以SeriesInstanceUID方式单独启动 SEG 系列视口会尝试调用定制化项missingReferenceDisplaySetHandler若未注册该处理器则跳过 SEG 渲染并打印日志避免视口崩溃。该能力在 3.12.0-beta.1012025-12的seg-viewport: add guard for missing reference display set handler to prevent viewport crash修复中被进一步加固。多帧 SEG 与加载性能优化多帧 SEGmultiframe SEG支持是本扩展演进中的重要主题。源码中围绕多帧做了三处关键设计帧 imageId 展开。getFrameImageIds会把形如…/frames/1的 WADO-RS 帧 URL 展开为每帧一个 imageId_resolveFrameImageIds在帧 URL 展开不适用时则逐帧调用dataSource.getImageIdsForInstance({ instance, frame })获取各帧 imageId。受控并发解码。源码中硬编码了帧解码并发上限// Max number of SEG frames fetched/decoded concurrently by the segmentation // loader. Hard-coded to 16 for now; intended to become configurable (and to // pair with the full-instance prefetch capability) in a follow-up. const SEG_FRAME_DECODE_CONCURRENCY 16;该值作为concurrency参数传给createFromDicomSegImageId避免成百上千个微小帧请求同时并发拖垮浏览器。Part 10 整体预取。针对SEG 帧太小太多、逐帧请求效率低下的问题加载器默认开启loadMultiframeAsPart10预取将整个 SEG 实例作为单个 Part 10 DICOM 对象批量拉取并把各帧压缩像素注册进 Cornerstone3D 的帧注册表使后续逐帧加载直接命中本地而不再发起网络请求。该开关的取值优先级为数据源配置dataSource.getConfig()?.loadMultiframeAsPart10 定制化项cornerstone.segmentation.loadMultiframeAsPart10 默认值true。预取被等待到完成或失败刻意不加超时失败的实例抓取会快速回退到逐帧加载而慢速的大体积抓取仍是到达全部帧的最快路径。与多帧相关的 CHANGELOG 记录包括3.10.0-beta.139 的seg: multiframe SEG#4890、3.10.0-beta.11 的multiframe: metadata handling of NM studies and loading order#4554、3.10.0-beta.60 的Having sop instance in a per-frame or shared attribute breaks load#4560修复 SOP 实例位于 per-frame 或 shared 属性导致加载失败的问题以及 3.11.0-beta.80 引入的WebGLContextPool for parallel rendering#5196与 3.11.0-beta.77 引入的SequentialRenderingEngine#5195解决高分辨率显示器上 canvas 尺寸限制与性能退化、增强多显示器支持——后者虽属于渲染引擎层面但直接影响 SEG 与 MPR 等多视口场景的渲染稳定性。颜色处理CIELab 推荐色与调色板回退DICOM SEG 标准允许每个分割段携带RecommendedDisplayCIELabValue推荐显示 CIELab 颜色。本扩展的加载逻辑getSopClassHandlerModule.ts会对每个分割段取RecommendedDisplayCIELabValue通过 dicomlabToRGB.ts 将其转换为 RGB 存入rgba若某段缺失该值则标记usedRecommendedDisplayCIELabValue false改用CONSTANTS.COLOR_LUT[i % CONSTANTS.COLOR_LUT.length]默认调色板颜色并弹出 5 秒的警告通知说明未找到推荐 CIELab 值使用了默认颜色。与颜色相关的演进修复包括3.13.0-beta.23 的palette color 8 encoded 16#5823修复 8 位调色板被按 16 位编码导致的上色错误、3.10.0-beta.9 的colorlut: use the correct colorlut index and update vtk#4544修正调色板索引并升级 vtk、3.13.0-beta.11 的colors: Replaces legacy colors with ui-next colors#5351以 ui-next 颜色体系替换遗留颜色、3.12.0-beta.87 的SegmentationStyle: Fix inactive contour visibility and styling#5563修复非活动轮廓的可见性与样式、3.9.0-beta.54#4181升级 CS3D 解决超声着色问题等。定制化配置从存储格式到交互行为本扩展通过 getCustomizationModule.ts 注册了默认定制化项见 segmentationCustomization.tsconst segmentationCustomization { segmentation.store.defaultMode: DEFAULT_SEG_STORE_MODE, // labelmap segmentation.store.transferSyntaxUID: DEFAULT_SEG_STORE_TRANSFER_SYNTAX_UID, // RLE Lossless (1.2.840.10008.1.2.5) segmentation.segmentLabel: { enabledByDefault: false, hoverTimeout: 1, } satisfies SegmentLabelCustomization, };各定制化项的作用域与默认值如下定制化项类型默认值作用segmentation.store.defaultModelabelmap \| bitmaplabelmapSEG 导出/存储时使用的 SOP Class 模式labelmap1.2.840.10008.5.1.4.1.1.66.7或 bitmap1.2.840.10008.5.1.4.1.1.66.4segmentation.store.transferSyntaxUIDstring1.2.840.10008.1.2.5RLE LosslessSEG 导出/存储时使用的传输语法segmentation.segmentLabel对象关闭、悬停超时 1s段标签工具segment label tool的默认行为cornerstone.segmentation.loadMultiframeAsPart10booleantrue多帧 SEG 是否以单个 Part 10 对象整体预取missingReferenceDisplaySetHandlerfunction无被引用 DisplaySet 缺失时的自定义处理存储优先级根据 segmentationConfig.ts 的说明数据源可在configuration.segmentation.store下设置defaultMode与transferSyntaxUID覆盖全局定制化项——因为不同后端支持不同的 SEG 编码方式数据源级配置优先于应用级定制化默认值。getSegmentationSaveOptions汇总这些规则供cornerstonejs/adapters的generateSegmentation在导出/存储 SEG 时使用默认即Label Map RLE Lossless只有在需要位图模式或非压缩 Explicit VR Little Endian 时才需要额外定制。与定制化相关的演进记录还包括3.11.0-beta.96 的segmentation: Add customization for handling missing referencedDisplaySetInstanceUID for the SEG/RTSTRUCT#4983为 SEG/RTSTRUCT 缺失引用 UID 增加定制化处理、3.10.0-beta.71 的customization: new customization service api#4688、3.10.0-beta.85 的Add customization support for more UI components#4634以及 3.12.0-beta.68 的segmentation: Lock all rehydrated segmentation segments when panelSegmentation.disableEditing is true#5503当面板配置panelSegmentation.disableEditing为真时锁定所有重新水合的分割段。标签图分割与分割工具演进本扩展在 3.11.0-beta.642025-06随labelmap: Add labelmap segmentation in OHIF#5158正式支持 OHIF 内新建 labelmap 分割。围绕分割创建与编辑的能力在 CHANGELOG 中持续增强3.10.0-beta.144segmentation: Enhance Segmentation with New AI and Once Click Tools#4910新增 AI 与单击式工具3.10.0-beta.131segmentation: Enhance Segmentation Tools with Preview and Selection Features#4870预览与选择功能3.10.0-beta.126segmentation: segment statistics, labelmap interpolation and segment bidirectional#4865段统计、labelmap 插值与分段双向测量3.10.0-beta.129overlapping segments#4849重叠分割段渲染支持3.11.0-beta.75add segment label tool#5164与 3.11.0-beta.113improve segment label#5217段标签工具与标签显示优化3.9.0-beta.58#3632segmentation mode: Add create, and export SEG with Brushes分割模式下用刷子Brushes创建并导出 SEG3.9.0-beta.75#3692Segmentation: download RTSS from Labelmap从 labelmap 下载 RTSS3.9.0-beta.70#4203seg: maintain algorithm name and algorithm type when DICOM seg is exported or downloaded导出/下载 DICOM SEG 时保留算法名称与算法类型。工具与交互类修复贯穿多个版本3.12.0-beta.95 的sculptor tool fixes#5595、3.12.0-beta.85 的interpolation: Auto accept interpolation when the interpolation process is completed#5555插值完成后自动接受、3.12.0-beta.81 的SegmentationTools: Changes of brush/eraser radius with hotkey do not reflect on segmentation tool#5535修复热键调整笔刷/橡皮半径不生效、3.10.0-beta.33 的tools: enable additional tools in volume viewport#4620等。渲染稳定性、水合导航与视口状态SEG 的渲染与水合hydrated SEG 叠加显示是涉及视口状态、挂片协议与帧引用准确性的系统性工程CHANGELOG 中可梳理出以下几条主线水合前后导航状态保持3.9.0-beta.34hydration: Maintain the same slice that the user was on pre hydration in post hydration for SR and SEG#42003.10.0-beta.145Pass the correct sop uid frame for rehydration to prevent associating rehydrated measurements with the wrong data#55063.12.0-beta.133jump-to-label-map: Use undefined for viewportId for arrow navigation#5774。水合后切片定位3.10.0-beta.23seg: jump to the first slice in SEG and RT that has data#4605跳到 SEG/RT 首个含数据切片、3.10.0-beta.152segmentation: Add segment jump for new segments and make panels scrollable#4928新分割段跳转与面板滚动。未水合 SEG 的跨挂片协议可见性3.11.0-beta.67segmentation: Changes to fix problems with non hydrated/loaded segmentations to be viewable when switching hanging protocols (e.g. MPR)#51393.13.0-beta.49segmentation: restrict overlay segmentation menu to same frame of reference as viewport background display set#5900将叠加分割菜单限制在视口背景 DisplaySet 同一帧参考系内3.12.0-beta.110prevent annotation from appearing in active viewport when switching series with different Frame of Reference UID#5630。视口状态重置与布局切换3.9.0-beta.85segmentation creation and segmentation mode viewport rendering#4193、3.9.0-beta.92segmentation: Address issue where segmentation creation failed on layout change#4153修复布局切换时分割创建失败、3.12.0-beta.773DSegmentation: The viewports become blank when loading the seg file in advanced layout after closing the seg file from any other advanced layout#5505、3.9.0-beta.121viewport: Reset viewport state and fix CINE looping, thumbnail resolution, and dynamic tool settings#4037、3.9.0-beta.128resize: Optimize resizing process and maintain zoom level#3889。与 TMTV 的协同3.12.0-beta.128TMTV: Consider blend mode when adding segmentation representations#5735、3.9.0-beta.108tmtv-mode: Add Brush tools and move SUV peak calculation to web worker#4053、3.9.0-beta.60#3988segmentation: Enhanced segmentation panel design for TMTVTMTV 专用分割面板设计。3D 表现3.12.0-beta.122segmentation: List surface representations in the segmentation table for 3D views#5700在 3D 视图分割表中列出 surface 表现、3.9.0-beta.76#4762core: Address 3D reconstruction and Android compatibility issues3D 重建与 Android 兼容性、3.9.0-beta.54#4008new layout: address black screen bugs。帧引用与元数据准确性3.12.0-beta.69#5506与 3.13.0-beta.53rename DisplaySet.frameOfReferenceUID back to FrameOfReferenceUID#5943保留框架参考系 UID 字段命名一致性。测试与质量保障仓库在 tests 目录下提供了覆盖该扩展主要行为的 Playwright 端到端测试与 CHANGELOG 中的功能记录相互印证例如SEGHydration.spec.ts验证 SEG 水合后叠加渲染、删除与重载SEGNoHydrationThenMPR.spec.ts 与 SEGHydrationThenMPR.spec.ts验证未水合/水合 SEG 切换到 MPR 挂片协议后的可见性对应 #5139 修复SEGHydrationFromMPR.spec.ts、SEGHydrationFrom3DFourUp.spec.ts从 MPR / 3D 布局触发水合OverlappingSegmentationRendering.spec.ts重叠分割段渲染对应 #4849SegmentationPanel.spec.ts 与 SegmentationSeriesNavigation.spec.ts分割面板与系列导航LabelMapSegLocking.spec.ts、LabelMapSegmentationColorChange.spec.tslabelmap 锁定与颜色修改。此外测试辅助工具 visitStudyAndHydrate.ts 封装了访问研究并水合的公共流程供多个 SEG/RT/SR 测试复用。底层依赖的持续升级CHANGELOG 显示该扩展的稳定性高度依赖 Cornerstone3D 生态的演进频繁出现update cs3d / cornerstone dependencies类条目例如3.13.0-beta.89#6043测试适配 Cornerstone3D 5.0、3.13.0-beta.25#5837CS3D 4.18.2、3.12.0-beta.121#5701修复截图后分割异常、3.12.0-beta.111#5664修复分割段可见性、3.12.0-beta.59#5494依赖精确版本锁定以提升供应链安全、3.10.0-beta.114#4816Cornerstone3D 3.0 适配、3.9.0-beta.72#3892、3.9.0-beta.73#3885、3.9.0-beta.64#3806新增 HTJ2K TSUIDS 支持等。可见 SEG 渲染的正确性、性能与安全性高度依赖底层渲染内核与适配器版本的匹配。版本演进时间线速览结合 CHANGELOG 中的版本节点以版本号为纵轴可梳理出该扩展近年来的能力里程碑时间版本节点代表性能力2024-063.9.0-beta.58分割模式创建并导出 SEGBrushes2024-073.9.0-beta.72~75CS3D 升级修复分割 bug、labelmap 下载 RTSS2024-093.9.0-beta.90 起4D 动态体积渲染、新布局选择器含 3D 体积渲染2025-033.10.0-beta.126~144段统计、labelmap 插值、重叠分割段、AI 与单击式工具、多帧 SEG 修复2025-063.11.0-beta.64OHIF 内 labelmap 分割2025-073.11.0-beta.80WebGLContextPool 并行渲染、SequentialRenderingEngine2025-10~123.12.0-beta.68~122水合段锁定、分割表 surface 表现、视图防崩溃守卫2026-02~043.13.0-beta.11~53ui-next 颜色、palette 8/16 修复、叠加分割菜单同帧参考系限制2026-063.13.0-beta.89适配 Cornerstone3D 5.0 测试链需要说明的是CHANGELOG 中约三分之二的版本节点属于 Version bump only仅版本号提升、无独立变更上述时间线仅摘录包含实际 Features / Bug Fixes 的节点反映该扩展真实的能力演进。小结如何在 OHIF 中落地 SEG 工作流综合 README、源码与 CHANGELOG在 OHIF 中使用 DICOM SEG 的完整工作流可归纳为识别与建组SopClassHandler 依据两个 SEG SOP Class UID 将系列转成派生 DisplaySet并关联被引用系列同一帧参考系加载与解析点击 SEG 视口操作栏的 SEG Pill或由模式/挂片协议触发load经createFromDicomSegImageId解析为 labelmap/bitmap 分割颜色遵循RecommendedDisplayCIELabValue并以 COLOR_LUT 兜底水合与叠加SEG 加载完成后可水合叠加渲染到同一帧参考系的所有视口水合前后保持用户所在切片位置定制化通过segmentation.store.*、cornerstone.segmentation.loadMultiframeAsPart10、missingReferenceDisplaySetHandler、panelSegmentation.disableEditing等定制化项调整存储格式、预取策略与交互行为验证参照 tests 下的 SEGHydration、SEGNoHydrationThenMPR、OverlappingSegmentationRendering 等端到端用例回归验证。如需深入实现细节可继续阅读 getSopClassHandlerModule.ts加载调用链、OHIFCornerstoneSEGViewport.tsx视口与水合、segmentationConfig.ts解析器与存储配置以及完整的 CHANGELOG.md。【免费下载链接】ViewersOHIF zero-footprint DICOM viewer and oncology specific Lesion Tracker, plus shared extension packages项目地址: https://gitcode.com/GitHub_Trending/vi/Viewers创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 OHIF cornerstone-dicom-seg 扩展深度解析：DICOM SEG 读取、渲染与演进路线
OHIF cornerstone-dicom-seg 扩展深度解析DICOM SEG 读取、渲染与演进路线【免费下载链接】ViewersOHIF zero-footprint DICOM viewer and oncology specific Lesion Tracker, plus shared extension packages项目地址: https://gitcode.com/GitHub_Trending/vi/Viewers本技术指南以 OHIF Viewers 仓库中extensions/cornerstone-dicom-seg扩展及其 CHANGELOG.md 为主体系统梳理该扩展在 DICOM SEG分割对象读取、体积标签图Labelmap渲染、SEG 视口、水合Hydration机制与定制化配置方面的完整实现与多年演进脉络。读者将掌握 SEG 扩展的模块组成与加载调用链、labelmap/bitmap 双解析器与存储配置、多帧 SEG 的性能优化策略以及如何借助segmentation.*系列定制化项调整默认行为。扩展定位与模块组成cornerstone-dicom-seg是 OHIF 提供 DICOM SEG 读取工作流read workflow的官方扩展。根据其 README 的说明该扩展允许在 OHIF 中加载 DICOM SEG 图像并显示当前分割以体积标签图volumetric labelmap的形式加载并作为 3D 体积渲染。扩展还提供一个 SEG 视口用于渲染和审查 DICOM SEG 图像如需完整加载所有分割段segments需要点击视口操作栏viewport action bar上的 SEG Pill 按钮以触发完整加载。从扩展入口 index.tsx 可以看到该扩展向 OHIF 注册了以下模块getViewportModule注册名为dicom-seg的视口组件底层通过React.lazy按需加载 OHIFCornerstoneSEGViewport.tsx并注入servicesManager、extensionManager、commandsManagergetSopClassHandlerModule为 SEG 系列提供 SopClassHandler将系列转换为 DisplaySetgetHangingProtocolModule提供 SEG 相关的挂片协议getCommandsModule/getCustomizationModule/getToolbarModule提供命令、定制化默认值与工具栏按钮。SopClassHandler从 DICOM SEG 系列到 DisplaySetSEG 扩展的核心入口是 getSopClassHandlerModule.ts。该模块声明了两个 DICOM SOP Class UIDconst sopClassUids [1.2.840.10008.5.1.4.1.1.66.4, 1.2.840.10008.5.1.4.1.1.66.7]; const LABELMAP_SEG_SOP_CLASS_UID 1.2.840.10008.5.1.4.1.1.66.7;其中1.2.840.10008.5.1.4.1.1.66.7是 Segmentation StorageLabel Map Segmentation即标签图分割SOP Class1.2.840.10008.5.1.4.1.1.66.4是 Bitmap Segmentation位图分割SOP Class。二者均在本扩展的 segmentationConfig.ts 中被命名导出export const LABELMAP_SEG_SOP_CLASS_UID 1.2.840.10008.5.1.4.1.1.66.7; export const BITMAP_SEG_SOP_CLASS_UID 1.2.840.10008.5.1.4.1.1.66.4;_getDisplaySetsFromSeries负责把 SEG 实例构造成 OHIF 的 DisplaySet关键处理逻辑包括选择实例列表中最后一个实例最近创建的作为当前实例通过utils.getLatestInstanceDateTime取实例日期时间作为 DisplaySet 日期时间构造标记isDerivedDisplaySet: true、isOverlayDisplaySet: true、isLoaded: false、isHydrated: false的派生 DisplaySet从instance.ReferencedSeriesSequence中解析被引用系列referencedSeriesInstanceUID与被引用图像referencedImages通过displaySetService.getDisplaySetsForReferences找到被引用的 DisplaySet即分割所叠加的灰度系列若引用多个系列则默认取第一个并给出警告当被引用 DisplaySet 尚不存在时订阅DISPLAY_SETS_ADDED事件待被引用系列加入后回填referencedDisplaySetInstanceUID与FrameOfReferenceUID处理 SEG 元数据中不含引用 UID 的常见情况返回的 DisplaySet 携带load函数供上层按需调用。加载链路从网络字节到 Cornerstone3D 分割状态DisplaySet 的load函数最终指向 getSopClassHandlerModule.ts 中的_load其内部通过_loadSegments完成真正的解析调用链可概括为去重_load维护loadPromises[SOPInstanceUID]若该 SEG 已在加载或已加载且分割已存在直接返回同一个 Promise避免重复网络请求。解析器类型判定getSegmentationParserType(sopClassUID, customizationService)依据 SOP Class UID 返回labelmap或bitmap详见 segmentationConfig.ts未知类型时回退到存储默认模式。被引用系列 imageId 解析优先使用被引用 DisplaySet 缓存的imageIds其次通过 dataSource 的getImageIdsForDisplaySet扩展最后回退到images.map(img img.imageId)。调用适配器解析核心解析由cornerstonejs/adapters的adaptersSEG.Cornerstone3D.Segmentation.createFromDicomSegImageId完成传入 metadataProvider、容差tolerance 0.001、解析器类型、帧 imageId 列表与帧解码并发数。颜色归一化解析得到的每个分割段的RecommendedDisplayCIELabValueDICOM 标准推荐的 CIELab 显示色通过dicomlabToRGB转为 RGBA若缺失则回退到CONSTANTS.COLOR_LUT调色板索引色并通过uiNotificationService提示用户使用了默认颜色。结果合并Object.assign(segDisplaySet, results)把解析出的segments、labelMapImageIds 等写回 DisplaySet随后由segmentationService.createSegmentationForSEGDisplaySet创建 Cornerstone3D 分割状态。整个加载过程通过eventTarget.addEventListener(Enums.Events.SEGMENTATION_LOAD_PROGRESS, onProgress)广播SEGMENT_LOADING_COMPLETE进度事件供视口 UI 展示加载百分比finally中移除监听并取消预取。SEG 视口与加载 / 水合机制OHIFCornerstoneSEGViewport.tsx 是 SEG 专属视口。其源码对加载loading与水合hydration做了明确区分loadingSEG 数据经网络加载并对像素位进行解包bit unpacking即把 DICOM SEG 像素数据转换为可用 labelmaphydrationSEG 被打开且所有分割段载入分割面板并叠加渲染到所有与被引用系列处于同一FrameOfReferenceUID的视口上。视口通过useViewportGrid感知当前视口网格为每个视口生成独立工具组SEGToolGroup-${viewportId}见 initSEGToolGroup.ts并将底层渲染委托给OHIFCornerstoneViewport传入displaySets{[referencedDisplaySet, segDisplaySet]}——即底层堆栈使用被引用系列SEG 作为叠加层overlay显示。这与扩展 README 中SEG 作为体积 labelmap 加载并以 3D 体积显示的描述一致基础层是原始灰度系列分割层是渲染在上的彩色 labelmap。视口对被引用 DisplaySet 缺失的场景做了健壮性处理当referencedDisplaySetInstanceUID不存在例如直接以SeriesInstanceUID方式单独启动 SEG 系列视口会尝试调用定制化项missingReferenceDisplaySetHandler若未注册该处理器则跳过 SEG 渲染并打印日志避免视口崩溃。该能力在 3.12.0-beta.1012025-12的seg-viewport: add guard for missing reference display set handler to prevent viewport crash修复中被进一步加固。多帧 SEG 与加载性能优化多帧 SEGmultiframe SEG支持是本扩展演进中的重要主题。源码中围绕多帧做了三处关键设计帧 imageId 展开。getFrameImageIds会把形如…/frames/1的 WADO-RS 帧 URL 展开为每帧一个 imageId_resolveFrameImageIds在帧 URL 展开不适用时则逐帧调用dataSource.getImageIdsForInstance({ instance, frame })获取各帧 imageId。受控并发解码。源码中硬编码了帧解码并发上限// Max number of SEG frames fetched/decoded concurrently by the segmentation // loader. Hard-coded to 16 for now; intended to become configurable (and to // pair with the full-instance prefetch capability) in a follow-up. const SEG_FRAME_DECODE_CONCURRENCY 16;该值作为concurrency参数传给createFromDicomSegImageId避免成百上千个微小帧请求同时并发拖垮浏览器。Part 10 整体预取。针对SEG 帧太小太多、逐帧请求效率低下的问题加载器默认开启loadMultiframeAsPart10预取将整个 SEG 实例作为单个 Part 10 DICOM 对象批量拉取并把各帧压缩像素注册进 Cornerstone3D 的帧注册表使后续逐帧加载直接命中本地而不再发起网络请求。该开关的取值优先级为数据源配置dataSource.getConfig()?.loadMultiframeAsPart10 定制化项cornerstone.segmentation.loadMultiframeAsPart10 默认值true。预取被等待到完成或失败刻意不加超时失败的实例抓取会快速回退到逐帧加载而慢速的大体积抓取仍是到达全部帧的最快路径。与多帧相关的 CHANGELOG 记录包括3.10.0-beta.139 的seg: multiframe SEG#4890、3.10.0-beta.11 的multiframe: metadata handling of NM studies and loading order#4554、3.10.0-beta.60 的Having sop instance in a per-frame or shared attribute breaks load#4560修复 SOP 实例位于 per-frame 或 shared 属性导致加载失败的问题以及 3.11.0-beta.80 引入的WebGLContextPool for parallel rendering#5196与 3.11.0-beta.77 引入的SequentialRenderingEngine#5195解决高分辨率显示器上 canvas 尺寸限制与性能退化、增强多显示器支持——后者虽属于渲染引擎层面但直接影响 SEG 与 MPR 等多视口场景的渲染稳定性。颜色处理CIELab 推荐色与调色板回退DICOM SEG 标准允许每个分割段携带RecommendedDisplayCIELabValue推荐显示 CIELab 颜色。本扩展的加载逻辑getSopClassHandlerModule.ts会对每个分割段取RecommendedDisplayCIELabValue通过 dicomlabToRGB.ts 将其转换为 RGB 存入rgba若某段缺失该值则标记usedRecommendedDisplayCIELabValue false改用CONSTANTS.COLOR_LUT[i % CONSTANTS.COLOR_LUT.length]默认调色板颜色并弹出 5 秒的警告通知说明未找到推荐 CIELab 值使用了默认颜色。与颜色相关的演进修复包括3.13.0-beta.23 的palette color 8 encoded 16#5823修复 8 位调色板被按 16 位编码导致的上色错误、3.10.0-beta.9 的colorlut: use the correct colorlut index and update vtk#4544修正调色板索引并升级 vtk、3.13.0-beta.11 的colors: Replaces legacy colors with ui-next colors#5351以 ui-next 颜色体系替换遗留颜色、3.12.0-beta.87 的SegmentationStyle: Fix inactive contour visibility and styling#5563修复非活动轮廓的可见性与样式、3.9.0-beta.54#4181升级 CS3D 解决超声着色问题等。定制化配置从存储格式到交互行为本扩展通过 getCustomizationModule.ts 注册了默认定制化项见 segmentationCustomization.tsconst segmentationCustomization { segmentation.store.defaultMode: DEFAULT_SEG_STORE_MODE, // labelmap segmentation.store.transferSyntaxUID: DEFAULT_SEG_STORE_TRANSFER_SYNTAX_UID, // RLE Lossless (1.2.840.10008.1.2.5) segmentation.segmentLabel: { enabledByDefault: false, hoverTimeout: 1, } satisfies SegmentLabelCustomization, };各定制化项的作用域与默认值如下定制化项类型默认值作用segmentation.store.defaultModelabelmap \| bitmaplabelmapSEG 导出/存储时使用的 SOP Class 模式labelmap1.2.840.10008.5.1.4.1.1.66.7或 bitmap1.2.840.10008.5.1.4.1.1.66.4segmentation.store.transferSyntaxUIDstring1.2.840.10008.1.2.5RLE LosslessSEG 导出/存储时使用的传输语法segmentation.segmentLabel对象关闭、悬停超时 1s段标签工具segment label tool的默认行为cornerstone.segmentation.loadMultiframeAsPart10booleantrue多帧 SEG 是否以单个 Part 10 对象整体预取missingReferenceDisplaySetHandlerfunction无被引用 DisplaySet 缺失时的自定义处理存储优先级根据 segmentationConfig.ts 的说明数据源可在configuration.segmentation.store下设置defaultMode与transferSyntaxUID覆盖全局定制化项——因为不同后端支持不同的 SEG 编码方式数据源级配置优先于应用级定制化默认值。getSegmentationSaveOptions汇总这些规则供cornerstonejs/adapters的generateSegmentation在导出/存储 SEG 时使用默认即Label Map RLE Lossless只有在需要位图模式或非压缩 Explicit VR Little Endian 时才需要额外定制。与定制化相关的演进记录还包括3.11.0-beta.96 的segmentation: Add customization for handling missing referencedDisplaySetInstanceUID for the SEG/RTSTRUCT#4983为 SEG/RTSTRUCT 缺失引用 UID 增加定制化处理、3.10.0-beta.71 的customization: new customization service api#4688、3.10.0-beta.85 的Add customization support for more UI components#4634以及 3.12.0-beta.68 的segmentation: Lock all rehydrated segmentation segments when panelSegmentation.disableEditing is true#5503当面板配置panelSegmentation.disableEditing为真时锁定所有重新水合的分割段。标签图分割与分割工具演进本扩展在 3.11.0-beta.642025-06随labelmap: Add labelmap segmentation in OHIF#5158正式支持 OHIF 内新建 labelmap 分割。围绕分割创建与编辑的能力在 CHANGELOG 中持续增强3.10.0-beta.144segmentation: Enhance Segmentation with New AI and Once Click Tools#4910新增 AI 与单击式工具3.10.0-beta.131segmentation: Enhance Segmentation Tools with Preview and Selection Features#4870预览与选择功能3.10.0-beta.126segmentation: segment statistics, labelmap interpolation and segment bidirectional#4865段统计、labelmap 插值与分段双向测量3.10.0-beta.129overlapping segments#4849重叠分割段渲染支持3.11.0-beta.75add segment label tool#5164与 3.11.0-beta.113improve segment label#5217段标签工具与标签显示优化3.9.0-beta.58#3632segmentation mode: Add create, and export SEG with Brushes分割模式下用刷子Brushes创建并导出 SEG3.9.0-beta.75#3692Segmentation: download RTSS from Labelmap从 labelmap 下载 RTSS3.9.0-beta.70#4203seg: maintain algorithm name and algorithm type when DICOM seg is exported or downloaded导出/下载 DICOM SEG 时保留算法名称与算法类型。工具与交互类修复贯穿多个版本3.12.0-beta.95 的sculptor tool fixes#5595、3.12.0-beta.85 的interpolation: Auto accept interpolation when the interpolation process is completed#5555插值完成后自动接受、3.12.0-beta.81 的SegmentationTools: Changes of brush/eraser radius with hotkey do not reflect on segmentation tool#5535修复热键调整笔刷/橡皮半径不生效、3.10.0-beta.33 的tools: enable additional tools in volume viewport#4620等。渲染稳定性、水合导航与视口状态SEG 的渲染与水合hydrated SEG 叠加显示是涉及视口状态、挂片协议与帧引用准确性的系统性工程CHANGELOG 中可梳理出以下几条主线水合前后导航状态保持3.9.0-beta.34hydration: Maintain the same slice that the user was on pre hydration in post hydration for SR and SEG#42003.10.0-beta.145Pass the correct sop uid frame for rehydration to prevent associating rehydrated measurements with the wrong data#55063.12.0-beta.133jump-to-label-map: Use undefined for viewportId for arrow navigation#5774。水合后切片定位3.10.0-beta.23seg: jump to the first slice in SEG and RT that has data#4605跳到 SEG/RT 首个含数据切片、3.10.0-beta.152segmentation: Add segment jump for new segments and make panels scrollable#4928新分割段跳转与面板滚动。未水合 SEG 的跨挂片协议可见性3.11.0-beta.67segmentation: Changes to fix problems with non hydrated/loaded segmentations to be viewable when switching hanging protocols (e.g. MPR)#51393.13.0-beta.49segmentation: restrict overlay segmentation menu to same frame of reference as viewport background display set#5900将叠加分割菜单限制在视口背景 DisplaySet 同一帧参考系内3.12.0-beta.110prevent annotation from appearing in active viewport when switching series with different Frame of Reference UID#5630。视口状态重置与布局切换3.9.0-beta.85segmentation creation and segmentation mode viewport rendering#4193、3.9.0-beta.92segmentation: Address issue where segmentation creation failed on layout change#4153修复布局切换时分割创建失败、3.12.0-beta.773DSegmentation: The viewports become blank when loading the seg file in advanced layout after closing the seg file from any other advanced layout#5505、3.9.0-beta.121viewport: Reset viewport state and fix CINE looping, thumbnail resolution, and dynamic tool settings#4037、3.9.0-beta.128resize: Optimize resizing process and maintain zoom level#3889。与 TMTV 的协同3.12.0-beta.128TMTV: Consider blend mode when adding segmentation representations#5735、3.9.0-beta.108tmtv-mode: Add Brush tools and move SUV peak calculation to web worker#4053、3.9.0-beta.60#3988segmentation: Enhanced segmentation panel design for TMTVTMTV 专用分割面板设计。3D 表现3.12.0-beta.122segmentation: List surface representations in the segmentation table for 3D views#5700在 3D 视图分割表中列出 surface 表现、3.9.0-beta.76#4762core: Address 3D reconstruction and Android compatibility issues3D 重建与 Android 兼容性、3.9.0-beta.54#4008new layout: address black screen bugs。帧引用与元数据准确性3.12.0-beta.69#5506与 3.13.0-beta.53rename DisplaySet.frameOfReferenceUID back to FrameOfReferenceUID#5943保留框架参考系 UID 字段命名一致性。测试与质量保障仓库在 tests 目录下提供了覆盖该扩展主要行为的 Playwright 端到端测试与 CHANGELOG 中的功能记录相互印证例如SEGHydration.spec.ts验证 SEG 水合后叠加渲染、删除与重载SEGNoHydrationThenMPR.spec.ts 与 SEGHydrationThenMPR.spec.ts验证未水合/水合 SEG 切换到 MPR 挂片协议后的可见性对应 #5139 修复SEGHydrationFromMPR.spec.ts、SEGHydrationFrom3DFourUp.spec.ts从 MPR / 3D 布局触发水合OverlappingSegmentationRendering.spec.ts重叠分割段渲染对应 #4849SegmentationPanel.spec.ts 与 SegmentationSeriesNavigation.spec.ts分割面板与系列导航LabelMapSegLocking.spec.ts、LabelMapSegmentationColorChange.spec.tslabelmap 锁定与颜色修改。此外测试辅助工具 visitStudyAndHydrate.ts 封装了访问研究并水合的公共流程供多个 SEG/RT/SR 测试复用。底层依赖的持续升级CHANGELOG 显示该扩展的稳定性高度依赖 Cornerstone3D 生态的演进频繁出现update cs3d / cornerstone dependencies类条目例如3.13.0-beta.89#6043测试适配 Cornerstone3D 5.0、3.13.0-beta.25#5837CS3D 4.18.2、3.12.0-beta.121#5701修复截图后分割异常、3.12.0-beta.111#5664修复分割段可见性、3.12.0-beta.59#5494依赖精确版本锁定以提升供应链安全、3.10.0-beta.114#4816Cornerstone3D 3.0 适配、3.9.0-beta.72#3892、3.9.0-beta.73#3885、3.9.0-beta.64#3806新增 HTJ2K TSUIDS 支持等。可见 SEG 渲染的正确性、性能与安全性高度依赖底层渲染内核与适配器版本的匹配。版本演进时间线速览结合 CHANGELOG 中的版本节点以版本号为纵轴可梳理出该扩展近年来的能力里程碑时间版本节点代表性能力2024-063.9.0-beta.58分割模式创建并导出 SEGBrushes2024-073.9.0-beta.72~75CS3D 升级修复分割 bug、labelmap 下载 RTSS2024-093.9.0-beta.90 起4D 动态体积渲染、新布局选择器含 3D 体积渲染2025-033.10.0-beta.126~144段统计、labelmap 插值、重叠分割段、AI 与单击式工具、多帧 SEG 修复2025-063.11.0-beta.64OHIF 内 labelmap 分割2025-073.11.0-beta.80WebGLContextPool 并行渲染、SequentialRenderingEngine2025-10~123.12.0-beta.68~122水合段锁定、分割表 surface 表现、视图防崩溃守卫2026-02~043.13.0-beta.11~53ui-next 颜色、palette 8/16 修复、叠加分割菜单同帧参考系限制2026-063.13.0-beta.89适配 Cornerstone3D 5.0 测试链需要说明的是CHANGELOG 中约三分之二的版本节点属于 Version bump only仅版本号提升、无独立变更上述时间线仅摘录包含实际 Features / Bug Fixes 的节点反映该扩展真实的能力演进。小结如何在 OHIF 中落地 SEG 工作流综合 README、源码与 CHANGELOG在 OHIF 中使用 DICOM SEG 的完整工作流可归纳为识别与建组SopClassHandler 依据两个 SEG SOP Class UID 将系列转成派生 DisplaySet并关联被引用系列同一帧参考系加载与解析点击 SEG 视口操作栏的 SEG Pill或由模式/挂片协议触发load经createFromDicomSegImageId解析为 labelmap/bitmap 分割颜色遵循RecommendedDisplayCIELabValue并以 COLOR_LUT 兜底水合与叠加SEG 加载完成后可水合叠加渲染到同一帧参考系的所有视口水合前后保持用户所在切片位置定制化通过segmentation.store.*、cornerstone.segmentation.loadMultiframeAsPart10、missingReferenceDisplaySetHandler、panelSegmentation.disableEditing等定制化项调整存储格式、预取策略与交互行为验证参照 tests 下的 SEGHydration、SEGNoHydrationThenMPR、OverlappingSegmentationRendering 等端到端用例回归验证。如需深入实现细节可继续阅读 getSopClassHandlerModule.ts加载调用链、OHIFCornerstoneSEGViewport.tsx视口与水合、segmentationConfig.ts解析器与存储配置以及完整的 CHANGELOG.md。【免费下载链接】ViewersOHIF zero-footprint DICOM viewer and oncology specific Lesion Tracker, plus shared extension packages项目地址: https://gitcode.com/GitHub_Trending/vi/Viewers创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考