DICOM プラグイン
DicomPluginで医療画像を表示
DICOM プラグインは Doconut に医療画像ビュー機能を追加します:マルチフレーム DICOM ファイルはアニメーションの概要、個別フレーム、またはその両方としてレンダリングされます。DICOM は プラグイン専用フォーマット です — このプラグイン(およびそのライセンス機能)がなければ、.dcm ファイルは全く開くことができません。
.NET Framework 4.7.2 上では、DICOM ファイルはページ、フレーム、アニメーションすべてが完全にレンダリングされますが、技術メタデータ(DICOM タグ)は利用できません。
Viewer.GetDicomMetadataAsyncは常にnullを返し、ビューアのメタデータ要求(?token=…&meta=1onDocImage.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 機能も必要です。
パッケージのインストール
Install-Package Doconut.NETFramework.Dicomこのドキュメントで説明しているリリースにプラグインを固定するには:
Install-Package Doconut.NETFramework.Dicom -Version 26.10.0Doconut.NETFramework と同じバージョンの DICOM パッケージを維持してください。
プラグインのライセンスファイル Doconut.Viewer.Dicom.lic は Doconut.Viewer.lic と同じフォルダーに配置します;ビューアのライセンスと共に読み込まれます。
プラグインの登録
Doconut.DoconutHost.Initialize(options =>
{
options.AddPlugin<Doconut.Plugins.Dicom.DicomPlugin>();
});プラグイン(Name: "Doconut DICOM Viewer")は .dcm と .ima 拡張子用のビューアを登録しますが、Dicom 機能で制御されます。ライセンスがそれを許可しない場合、DoconutHost.Initialize は Application_Start から例外をスローします:
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 ライセンスは受け入れられます。ライセンス設定 を参照してください。
組み込みのビューアがこれらの形式を処理できないため、後で機能が利用できなくなると、開く際に即座に失敗します:
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# からの使用
var token = await viewer.OpenDocumentAsync(path, new DicomConfig
{
DisplayMode = DicomDisplayMode.AnimationAndFrames
});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 にフォールバックします。
// ベースプロパティによる均一バンプ…
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
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
public enum DicomDisplayMode { AnimationOnly, FramesOnly, AnimationAndFrames }Viewer.GetDicomMetadataAsync
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 パッケージ全体と同様です。
このページは役に立ちましたか?