DICOM 插件

DICOM 插件为 Doconut 添加了医学图像查看功能：多帧 DICOM 文件可以渲染为动画概览、单独帧或两者兼有。DICOM 是一种 仅插件格式 —— 没有此插件（及其许可证功能），.dcm 文件根本无法打开。

安装包

dotnet add package Doconut.NET8.Dicom

未指定版本的命令会安装最新的稳定版。要将插件固定在当前的 26.7.0 版本，请单独传递版本号：

dotnet add package Doconut.NET8.Dicom --version 26.7.0

保持 DICOM 包与 Doconut.NET8 的版本一致。包 ID 为 Doconut.NET8.Dicom；.26.7.0 仅出现在下载的 .nupkg 文件名中。

注册插件

builder.Services.AddDoconut(options =>
{
    options.AddPlugin<Doconut.Plugins.Dicom.DicomPlugin>();
});

该插件（Name："Doconut DICOM Viewer"）为 .dcm 和 .ima 扩展名注册查看器，并受 Dicom 能力的限制。缺少或不足的非临时授权通常会在 AddDoconut() 期间失败。由于没有内置查看器能够处理这些格式，如果该能力随后不可用，运行时门也会硬性失败：

LicenseException: This document type requires the 'Dicom' plugin license.

打开 DICOM 文件

var token = await viewer.OpenDocumentAsync(path, new DicomConfig
{
    DisplayMode = DicomDisplayMode.AnimationAndFrames
});

显示模式

多帧 DICOM 文件可以通过三种方式呈现（DicomDisplayMode）：

动画时长由 AnimationFrameDelayMs 控制（默认 100 毫秒 = 10 FPS；GIF 的粒度为 10 毫秒单位），以及 LoopCount（0 = 无限循环）。

分辨率

DicomConfig 默认在每个轴上以 100 DPI 渲染。分辨率属性有一个值得了解的回退链：如果未显式设置 HorizontalResolution/VerticalResolution，它们会遵循已配置的 BaseConfig.ImageResolution，若仍未设置，则回退到 100。

// Uniform bump via the base property…
new DicomConfig { ImageResolution = 150 };

// …or per-axis control
new DicomConfig { HorizontalResolution = 200, VerticalResolution = 150 };

读取 DICOM 元数据

对于通过此插件打开的会话，Viewer 会公开标签元数据：

var metadata = await viewer.GetDicomMetadataAsync(token);
// null when the session isn't a DICOM document

完整配置参考

DicomConfig 完整属性表位于 API Reference → Format Configs 中。以下是参考应用中针对每种扩展的生产示例：

".DCM" or ".IMA" => new DicomConfig { DisplayMode = DicomDisplayMode.AnimationAndFrames },

水印和内存行为

普通页面水印的决策同样适用于 DICOM 输出。对于动画输出，每个 GIF 帧都会加上水印，以确保在播放期间水印始终可见。仅当许可证路径允许自定义水印时，才会使用自定义的 DocOptions.Watermark；它不能替代评估版水印。

多帧研究可以生成动画以及每帧的静态页面。AnimationAndFrames 提供最丰富的导航，但也带来最高的渲染和缓存成本。针对大型研究：

• 当帧检查比电影式播放更重要时，使用 FramesOnly；
• 在未测量内存的情况下，避免同时提升两个分辨率轴；
• 当研究不再打开时，显式关闭会话；
• 仅在重复访问的收益大于保留图像的成本时，才保持 CachePages 启用。

故障排除