DICOM プラグイン

DicomPluginで医療画像を表示

DICOM プラグインは Doconut に医療画像ビュー機能を追加します:マルチフレーム DICOM ファイルはアニメーションの概要、個別フレーム、またはその両方としてレンダリングされます。DICOM は プラグイン専用フォーマット です — このプラグイン(およびそのライセンス機能)がなければ、.dcm ファイルは全く開くことができません。

.NET Framework 4.7.2 上では、DICOM ファイルはページ、フレーム、アニメーションすべてが完全にレンダリングされますが、技術メタデータ(DICOM タグ)は利用できません。 Viewer.GetDicomMetadataAsync は常に null を返し、ビューアのメタデータ要求(?token=…&meta=1 on DocImage.axd)は 404 と答えるため、ビューアには DICOM プロパティパネルが表示されません。タグが必要な場合は Doconut.NET8 を使用してください。

対象使用シーン
Viewer with DicomConfig (C#)サーバー上で DICOM ファイルを開き、フレームの表示方法を選択します
The viewer (docViewer) on DocImage.axdページにスタディを表示します:アニメーションとフレーム

プラグインは独自のウィジェットを持ちません:DICOM ファイルは通常のビューアで開かれます。コンバータプラグイン も登録されている場合、.dcm と .ima ファイルは Pdf、Png、Jpeg、Bmp、Tiff、または Gif に変換できます;この変換には Dicom 機能も必要です。

パッケージのインストール

powershell
Install-Package Doconut.NETFramework.Dicom

このドキュメントで説明しているリリースにプラグインを固定するには:

powershell
Install-Package Doconut.NETFramework.Dicom -Version 26.10.0

Doconut.NETFramework と同じバージョンの DICOM パッケージを維持してください。

プラグインのライセンスファイル Doconut.Viewer.Dicom.lic は Doconut.Viewer.lic と同じフォルダーに配置します;ビューアのライセンスと共に読み込まれます。

プラグインの登録

csharp
Doconut.DoconutHost.Initialize(options =>
{
    options.AddPlugin<Doconut.Plugins.Dicom.DicomPlugin>();
});

プラグイン(Name: "Doconut DICOM Viewer")は .dcm と .ima 拡張子用のビューアを登録しますが、Dicom 機能で制御されます。ライセンスがそれを許可しない場合、DoconutHost.Initialize は Application_Start から例外をスローします:

text
The Dicom plugin is registered via AddPlugin but no active license grants Dicom. Remove the AddPlugin<...>() call or install a license (or trial/demo) that includes Dicom.

System.Web では、すべてのリクエストが空の 500 を返すことを意味し、理由は Windows のイベントログ(ソース ASP.NET)にのみ記録されます。ライセンスがない場合、レガシー TRIAL ファイル、Dicom が欠けたライセンス、バージョンウィンドウ外で使用された有料ライセンスの場合に例外がスローされます。一時的なデモ/NFR ライセンスは受け入れられます。ライセンス設定 を参照してください。

組み込みのビューアがこれらの形式を処理できないため、後で機能が利用できなくなると、開く際に即座に失敗します:

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

ライセンスと透かし

ライセンス状態起動時DICOM 出力
バージョンウィンドウ内で Dicom を付与する有料ライセンス開始時通常のページ透かしルールに従ってレンダリングされます
有効な一時(デモ/NFR)ライセンス開始時評価用透かしでレンダリングされます
ライセンスなし、レガシー TRIAL ファイル、Dicom がないライセンス、またはバージョンウィンドウ外の有料ライセンスApplication_Start throws; every request answers an empty 500—

通常のページ透かしの判断は DICOM 出力にも適用されます。アニメーション出力の場合、各 GIF フレームに透かしが付与されるため、再生中ずっとマークが表示されます。カスタム DocOptions.Watermark は、ライセンスがカスタム透かしを許可する場合にのみ使用され、評価用透かしの代わりにはなりません。

C# からの使用

csharp
var token = await viewer.OpenDocumentAsync(path, new DicomConfig
{
    DisplayMode = DicomDisplayMode.AnimationAndFrames
});
csharp
var metadata = await viewer.GetDicomMetadataAsync(token);
// .NET Framework 上では常に null です: DICOM メタデータリーダーは利用できません
// target. ページ、フレーム、アニメーションは通常どおりレンダリングされます。

このパッケージには、.NET 8 パッケージと共有されたコードがコンパイルできるようにメソッドが存在しますが、DICOM タグを読み取るには .NET Framework 用のビルドがないコンポーネントが必要です。これらがないことを前提にユーザーインターフェイスを設計してください — 例えば、結果が null の場合はメタデータパネルを非表示にします。

表示モードと解像度

表示モード

マルチフレーム DICOM ファイルは、DicomDisplayMode によって3つの方法で表示できます:

モード生成されるページ用途
AnimationOnlyページ1 = すべてのフレームをループするアニメーション GIF迅速なシネマティックレビュー
FramesOnlyページ1..N = フレームごとに1枚の静的 PNGフレーム単位の診断ナビゲーション
AnimationAndFrames (default)ページ1 = アニメーション GIF、ページ2..N+1 = フレームごとに1枚の静的 PNG (N = フレーム数)1つのドキュメントで概要と詳細を提供

アニメーションのタイミングは AnimationFrameDelayMs で制御されます(デフォルトは 100 ms = 10 FPS;GIF のタイミングは 10 ms 単位)および LoopCount(0 = 無限ループ)。

ビューアは、ページ1がアニメーションであることを HEAD リクエストを送信して判定します。したがって、DocImage.axd ハンドラは Web.config 内で HEAD を受け入れる必要があります(verb="GET,HEAD,POST"、インストール を参照)。これがないと、IIS は Doconut が実行される前に 404 で応答し、アニメーション検出が機能しません。

解像度

DicomConfig はデフォルトで軸ごとに 100 DPI でレンダリングします。HorizontalResolution/VerticalResolution を明示的に設定しない場合、設定されている場合は BaseConfig.ImageResolution に従い、そうでなければ 100 にフォールバックします。

csharp
// ベースプロパティによる均一バンプ…
new DicomConfig { ImageResolution = 150 };

// …または軸ごとの制御
new DicomConfig { HorizontalResolution = 200, VerticalResolution = 150 };

独自フロントエンドの構築

アニメーション化された最初のページを含むページ画像は、標準の DocImage.axd 画像ルートを使用します。メタデータリクエストである GET /DocImage.axd?token=<token>&meta=1 は、このパッケージ内のすべてのドキュメント(DICOM ファイルを含む)に対して 404 を返しますが、メタデータリーダーが利用できないためです。

本番環境での使用

マルチフレームのスタディは、アニメーションとフレームごとの静的ページの両方を生成できます。AnimationAndFrames は最もリッチなナビゲーションを提供しますが、同時に最高のレンダリングとメモリコストがかかります — しかも単一サーバー上ではそのメモリは IIS ワーカープロセスに属します。大規模なスタディの場合:

  • 再生よりフレーム検査が重要な場合は FramesOnly を使用してください;
  • メモリを測定せずに解像度の両軸を上げることは避けてください;
  • スタディが開かれていなくなったらセッションを明示的に閉じてください;
  • 再アクセスが保持された画像に見合う場合にのみ CachePages をオンにしてください。

すべてのサーバーで Doconut.Viewer.Dicom.lic を Doconut.Viewer.lic の隣に配置し、ハンドラの verb リストに HEAD を保持してください。

API リファレンス

DicomConfig、DicomDisplayMode、DicomMetadata は Doconut 名前空間にあります。DicomPlugin は Doconut.Plugins.Dicom にあります。完全な DicomConfig プロパティテーブルは フォーマット設定 にあります。

DicomConfig

csharp
public sealed class DicomConfig : BaseConfig
{
    public int HorizontalResolution { get; set; }   // デフォルト: 設定されている場合は ImageResolution、そうでなければ 100
    public int VerticalResolution { get; set; }     // デフォルト: 設定されている場合は ImageResolution、そうでなければ 100
    public int AnimationFrameDelayMs { get; set; } = 100;
    public ushort LoopCount { get; set; } = 0;      // 0 = 無限ループ
    public DicomDisplayMode DisplayMode { get; set; } = DicomDisplayMode.AnimationAndFrames;
}

DicomDisplayMode

csharp
public enum DicomDisplayMode { AnimationOnly, FramesOnly, AnimationAndFrames }

Viewer.GetDicomMetadataAsync

csharp
public Task<DicomMetadata?> GetDicomMetadataAsync(string token, CancellationToken ct = default);

このパッケージでは常に null を返します。トークンが不明または期限切れの場合は InvalidOperationException がスローされます。DicomMetadata は .NET 8 パッケージと共有されるコードがコンパイルできるように定義されています。

Troubleshooting

症状原因対策
プラグインを追加した後、すべてのリクエストが空の 500 を返します;Windows イベントログ(ソース ASP.NET)には The Dicom plugin is registered via AddPlugin but no active license grants Dicom. が表示されますライセンスがない、TRIAL ファイル、Dicom が含まれないライセンス、またはバージョン期間外の有料ライセンスDicom を付与するライセンスをインストールするか、AddPlugin<DicomPlugin>() を削除してください
.dcm ファイルを開くと Document format '.dcm' is not supported. がスローされますDicomPlugin が登録されていないか、パッケージがデプロイされていませんDoconutHost.Initialize に AddPlugin<DicomPlugin>() を追加し、パッケージをデプロイしてください
.dcm ファイルを開くと LicenseException: This document type requires the 'Dicom' plugin license. がスローされますロードされたライセンスはもはや Dicom を付与しませんDicom を付与するライセンスをインストールしてください
1 ページしか表示されませんソースが単一フレームであるか、DisplayMode が AnimationOnly ですマルチフレームソースには FramesOnly または AnimationAndFrames を使用してください
ページ 1 がアニメーションしませんWeb.config のハンドラが HEAD を受け付けませんverb="GET,HEAD,POST" を使用してください
アニメーションが速すぎるまたは遅すぎるAnimationFrameDelayMs がオフになっています;GIF のタイミングは 10 ms 単位ですAnimationFrameDelayMs を調整してください
大きなマルチフレームファイルでメモリが増大します表示モード、解像度、ページキャッシュがすべて保持画像を増やします参照してください 本番環境; セッションを明示的に閉じてください
メタデータは常に null ですこのパッケージでは想定された動作ですタグが必要な場合は .NET 8 パッケージを使用してください
GetDicomMetadataAsync が Document session not found. Please re-open document. をスローしますトークンが期限切れか、開かれていませんでしたドキュメントを再度開いてください

Framework notes

ASP.NET Core パッケージと比較して、このパッケージはホスティングと DICOM メタデータで異なります:

  • 登録 は Application_Start にあり、DoconutHost.Initialize を通じて行われ、builder.Services.AddDoconut ではありません。
  • 起動時の失敗 はすべてのリクエストで空の 500 として現れ、理由は Windows イベントログに記録されます。
  • アニメーション検出 には DocImage.axd ハンドラの verb リストに HEAD が必要です。
  • DICOM メタデータなし。 Viewer.GetDicomMetadataAsync は常に null を返し、DICOM セッションに対して一度だけ警告をログに記録します;DocImage.axd メタデータ要求は 404 を返し、.NET 6 および .NET Standard パッケージの 501 ではありません。
  • Windows のみ、.NET Framework パッケージ全体と同様です。

このページは役に立ちましたか?