Plugin DICOM

Lihat gambar medis dengan DicomPlugin

Plugin DICOM menambahkan tampilan gambar medis ke Doconut: file DICOM multi-frame dirender sebagai ikhtisar animasi, frame individu, atau keduanya. DICOM adalah format hanya plugin — tanpa plugin ini (dan kemampuan lisensinya), file .dcm tidak dapat dibuka sama sekali.

Pada .NET Framework 4.7.2, file DICOM dirender sepenuhnya — halaman, frame, dan animasi — tetapi metadata teknis (tag DICOM) tidak tersedia. Viewer.GetDicomMetadataAsync selalu mengembalikan null, dan permintaan metadata penampil (?token=…&meta=1 pada DocImage.axd) menjawab 404, sehingga penampil tidak menampilkan panel properti DICOM. Gunakan Doconut.NET8 jika aplikasi Anda membutuhkan tag tersebut.

PermukaanGunakan ketika
Viewer with DicomConfig (C#)Anda membuka file DICOM di server dan memilih bagaimana frame mereka disajikan
Penampil (docViewer) pada DocImage.axdAnda menampilkan studi di halaman Anda: animasi dan frame

Plugin ini tidak memiliki widget sendiri: file DICOM dibuka di penampil reguler. Dengan plugin Converter juga terdaftar, file .dcm dan .ima dapat dikonversi menjadi Pdf, Png, Jpeg, Bmp, Tiff atau Gif; konversi tersebut juga memerlukan kemampuan Dicom.

Instal paket

powershell
Install-Package Doconut.NETFramework.Dicom

Untuk menempelkan plugin ke rilis yang dijelaskan dalam dokumentasi ini:

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

Pertahankan paket DICOM pada versi yang sama dengan Doconut.NETFramework.

File lisensi plugin, Doconut.Viewer.Dicom.lic, diletakkan di folder yang sama dengan Doconut.Viewer.lic; file tersebut dibaca bersama lisensi penampil.

Daftarkan plugin

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

Plugin (Name: "Doconut DICOM Viewer") mendaftarkan penampil untuk ekstensi .dcm dan .ima, dibatasi oleh kemampuan Dicom. Jika lisensi tidak memberikannya, DoconutHost.Initialize melempar dari 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.

Di System.Web itu berarti setiap permintaan menjawab 500 kosong, dan alasannya hanya ada di log peristiwa Windows (sumber ASP.NET). Ini melempar karena tidak ada lisensi, file legacy TRIAL, lisensi tanpa Dicom, dan lisensi berbayar yang digunakan di luar jendela versinya. Lisensi Demo/NFR sementara diterima. Lihat Pengaturan Lisensi.

Karena tidak ada penampil bawaan yang menangani format ini, membuka satu akan gagal total jika kemampuan tersebut kemudian tidak tersedia:

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

Lisensi & watermark

Status lisensiMulaiOutput DICOM
Lisensi berbayar yang memberikan Dicom, dalam jendela versinyaMulaiDihasilkan sesuai aturan watermark halaman normal
Lisensi Sementara Aktif (Demo/NFR)MulaiDihasilkan dengan watermark evaluasi
Tidak ada lisensi, file legacy TRIAL, lisensi tanpa Dicom, atau lisensi berbayar di luar jendela versinyaApplication_Start melempar; setiap permintaan menjawab 500 kosong—

Keputusan watermark halaman normal juga berlaku untuk output DICOM. Untuk output animasi, setiap frame GIF diberi cap, sehingga tanda tetap terlihat selama pemutaran. DocOptions.Watermark khusus hanya digunakan ketika lisensi mengizinkan watermark khusus; ia tidak dapat menggantikan watermark evaluasi.

Penggunaan dari C#

csharp
var token = await viewer.OpenDocumentAsync(path, new DicomConfig
{
    DisplayMode = DicomDisplayMode.AnimationAndFrames
});
csharp
var metadata = await viewer.GetDicomMetadataAsync(token);
// Pada .NET Framework ini selalu null: pembaca metadata DICOM tidak tersedia untuk ini
// target. Halaman, bingkai, dan animasi dirender secara normal.

Metode ini ada pada paket ini sehingga kode yang dibagikan dengan paket .NET 8 dapat dikompilasi, tetapi membaca tag DICOM membutuhkan komponen yang tidak memiliki build .NET Framework. Rencanakan antarmuka pengguna Anda tanpa mereka — misalnya, sembunyikan panel metadata ketika hasilnya adalah null.

Mode tampilan dan resolusi

Mode tampilan

File DICOM multi-frame dapat ditampilkan dalam tiga cara (DicomDisplayMode):

ModeHalaman yang dihasilkanUntuk
AnimationOnlyHalaman 1 = GIF animasi yang mengulang semua frameTinjauan sinematik cepat
FramesOnlyHalaman 1..N = satu PNG statis per frameNavigasi diagnostik frame demi frame
AnimationAndFrames (bawaan)Halaman 1 = GIF animasi, halaman 2..N+1 = satu PNG statis per frame (N = jumlah frame)Ikhtisar dan detail dalam satu dokumen

Timing animasi dikendalikan oleh AnimationFrameDelayMs (bawaan 100 ms = 10 FPS; timing GIF menggunakan satuan 10 ms) dan LoopCount (0 = loop selamanya).

Penampil mengetahui bahwa halaman 1 beranimasi dengan mengirimkan permintaan HEAD untuknya. Penangan DocImage.axd harus menerima HEAD dalam Web.config (verb="GET,HEAD,POST", lihat Instalasi); tanpa itu, IIS menjawab 404 sebelum Doconut berjalan dan deteksi animasi tidak pernah berhasil.

Resolusi

DicomConfig merender pada 100 DPI per sumbu secara bawaan. Jika Anda tidak mengatur HorizontalResolution/VerticalResolution secara eksplisit, mereka mengikuti BaseConfig.ImageResolution ketika itu diatur, dan hanya kemudian kembali ke 100.

csharp
// Penambahan seragam melalui properti dasar…
new DicomConfig { ImageResolution = 150 };

// …atau kontrol per‑sumbu
new DicomConfig { HorizontalResolution = 200, VerticalResolution = 150 };

Bangun antarmuka depan Anda sendiri

Gambar halaman, termasuk halaman pertama yang beranimasi, menggunakan rute gambar standar DocImage.axd. Permintaan metadata, GET /DocImage.axd?token=<token>&meta=1, menjawab 404 pada paket ini untuk setiap dokumen, termasuk file DICOM, karena pembaca metadata tidak tersedia.

Dalam produksi

Studi multi-frame dapat menghasilkan baik animasi maupun satu halaman statis per frame. AnimationAndFrames memberikan navigasi paling kaya tetapi juga biaya rendering dan memori tertinggi — dan pada satu server memori tersebut milik proses pekerja IIS. Untuk studi besar:

  • gunakan FramesOnly ketika inspeksi frame lebih penting daripada pemutaran;
  • hindari meningkatkan kedua sumbu resolusi tanpa mengukur memori;
  • tutup sesi secara eksplisit ketika studi tidak lagi terbuka;
  • pertahankan CachePages aktif hanya ketika akses berulang layak untuk gambar yang dipertahankan.

Letakkan Doconut.Viewer.Dicom.lic di sebelah Doconut.Viewer.lic pada setiap server, dan pertahankan HEAD dalam daftar verb penangan.

Referensi API

DicomConfig, DicomDisplayMode dan DicomMetadata berada di namespace Doconut. DicomPlugin berada di Doconut.Plugins.Dicom. Tabel properti lengkap DicomConfig ada di Konfigurasi Format.

DicomConfig

csharp
public sealed class DicomConfig : BaseConfig
{
    public int HorizontalResolution { get; set; }   // default: ImageResolution ketika disetel, jika tidak 100
    public int VerticalResolution { get; set; }     // default: ImageResolution ketika disetel, jika tidak 100
    public int AnimationFrameDelayMs { get; set; } = 100;
    public ushort LoopCount { get; set; } = 0;      // 0 = loop selamanya
    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);

Selalu mengembalikan null pada paket ini. Melempar InvalidOperationException ketika token tidak dikenal atau kedaluwarsa. DicomMetadata didefinisikan sehingga kode yang dibagikan dengan paket .NET 8 dapat dikompilasi.

Pemecahan Masalah

GejalaPenyebabPerbaikan
Setiap permintaan menjawab 500 kosong setelah menambahkan plugin; log peristiwa Windows (sumber ASP.NET) menunjukkan The Dicom plugin is registered via AddPlugin but no active license grants Dicom.Tidak ada lisensi, file TRIAL, lisensi tanpa Dicom, atau lisensi berbayar di luar jendela versinyaPasang lisensi yang memberikan Dicom, atau hapus AddPlugin<DicomPlugin>()
Membuka file .dcm melempar Document format '.dcm' is not supported.DicomPlugin tidak terdaftar, atau paketnya tidak dideployTambahkan AddPlugin<DicomPlugin>() di DoconutHost.Initialize dan deploy paketnya
Membuka file .dcm melempar LicenseException: This document type requires the 'Dicom' plugin license.Lisensi yang dimuat tidak lagi memberikan DicomPasang lisensi yang memberikan Dicom
Hanya satu halaman yang munculSumbernya single-frame, atau DisplayMode adalah AnimationOnlyGunakan FramesOnly atau AnimationAndFrames untuk sumber multi-frame
Halaman 1 tidak beranimasiHandler di Web.config tidak menerima HEADGunakan verb="GET,HEAD,POST"
Animasi terlalu cepat atau lambatAnimationFrameDelayMs dimatikan; timing GIF menggunakan satuan 10 msSesuaikan AnimationFrameDelayMs
Memori bertambah pada file multi-frame besarMode tampilan, resolusi, dan cache halaman semuanya menambah gambar yang dipertahankanLihat Dalam produksi; tutup sesi secara eksplisit
Metadata selalu nullDiharapkan pada paket iniGunakan paket .NET 8 ketika Anda membutuhkan tag
GetDicomMetadataAsync melempar Document session not found. Please re-open document.Token kedaluwarsa atau tidak pernah dibukaBuka dokumen lagi

Catatan kerangka kerja

Dibandingkan dengan paket ASP.NET Core, paket ini berbeda dalam hosting dan dalam metadata DICOM:

  • Registrasi berada di Application_Start, melalui DoconutHost.Initialize, alih-alih builder.Services.AddDoconut.
  • Kegagalan startup muncul sebagai 500 kosong pada setiap permintaan, dengan alasannya tercatat di log peristiwa Windows.
  • Deteksi animasi memerlukan HEAD dalam daftar verb milik handler DocImage.axd.
  • Tidak ada metadata DICOM. Viewer.GetDicomMetadataAsync selalu mengembalikan null dan mencatat peringatan satu kali untuk sesi DICOM; permintaan metadata DocImage.axd menjawab 404, bukan 501 pada paket .NET 6 dan .NET Standard.
  • Hanya Windows, seperti paket .NET Framework lainnya.

Apakah halaman ini membantu?