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.GetDicomMetadataAsyncselalu mengembalikannull, dan permintaan metadata penampil (?token=…&meta=1padaDocImage.axd) menjawab404, sehingga penampil tidak menampilkan panel properti DICOM. GunakanDoconut.NET8jika aplikasi Anda membutuhkan tag tersebut.
| Permukaan | Gunakan ketika |
|---|---|
Viewer with DicomConfig (C#) | Anda membuka file DICOM di server dan memilih bagaimana frame mereka disajikan |
Penampil (docViewer) pada DocImage.axd | Anda 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
Install-Package Doconut.NETFramework.DicomUntuk menempelkan plugin ke rilis yang dijelaskan dalam dokumentasi ini:
Install-Package Doconut.NETFramework.Dicom -Version 26.10.0Pertahankan 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
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:
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:
LicenseException: This document type requires the 'Dicom' plugin license.Lisensi & watermark
| Status lisensi | Mulai | Output DICOM |
|---|---|---|
Lisensi berbayar yang memberikan Dicom, dalam jendela versinya | Mulai | Dihasilkan sesuai aturan watermark halaman normal |
| Lisensi Sementara Aktif (Demo/NFR) | Mulai | Dihasilkan dengan watermark evaluasi |
Tidak ada lisensi, file legacy TRIAL, lisensi tanpa Dicom, atau lisensi berbayar di luar jendela versinya | Application_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#
var token = await viewer.OpenDocumentAsync(path, new DicomConfig
{
DisplayMode = DicomDisplayMode.AnimationAndFrames
});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):
| Mode | Halaman yang dihasilkan | Untuk |
|---|---|---|
AnimationOnly | Halaman 1 = GIF animasi yang mengulang semua frame | Tinjauan sinematik cepat |
FramesOnly | Halaman 1..N = satu PNG statis per frame | Navigasi 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.
// 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
FramesOnlyketika inspeksi frame lebih penting daripada pemutaran; - hindari meningkatkan kedua sumbu resolusi tanpa mengukur memori;
- tutup sesi secara eksplisit ketika studi tidak lagi terbuka;
- pertahankan
CachePagesaktif 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
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
public enum DicomDisplayMode { AnimationOnly, FramesOnly, AnimationAndFrames }Viewer.GetDicomMetadataAsync
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
| Gejala | Penyebab | Perbaikan |
|---|---|---|
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 versinya | Pasang lisensi yang memberikan Dicom, atau hapus AddPlugin<DicomPlugin>() |
Membuka file .dcm melempar Document format '.dcm' is not supported. | DicomPlugin tidak terdaftar, atau paketnya tidak dideploy | Tambahkan 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 Dicom | Pasang lisensi yang memberikan Dicom |
| Hanya satu halaman yang muncul | Sumbernya single-frame, atau DisplayMode adalah AnimationOnly | Gunakan FramesOnly atau AnimationAndFrames untuk sumber multi-frame |
| Halaman 1 tidak beranimasi | Handler di Web.config tidak menerima HEAD | Gunakan verb="GET,HEAD,POST" |
| Animasi terlalu cepat atau lambat | AnimationFrameDelayMs dimatikan; timing GIF menggunakan satuan 10 ms | Sesuaikan AnimationFrameDelayMs |
| Memori bertambah pada file multi-frame besar | Mode tampilan, resolusi, dan cache halaman semuanya menambah gambar yang dipertahankan | Lihat Dalam produksi; tutup sesi secara eksplisit |
Metadata selalu null | Diharapkan pada paket ini | Gunakan paket .NET 8 ketika Anda membutuhkan tag |
GetDicomMetadataAsync melempar Document session not found. Please re-open document. | Token kedaluwarsa atau tidak pernah dibuka | Buka 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, melaluiDoconutHost.Initialize, alih-alihbuilder.Services.AddDoconut. - Kegagalan startup muncul sebagai
500kosong pada setiap permintaan, dengan alasannya tercatat di log peristiwa Windows. - Deteksi animasi memerlukan
HEADdalam daftarverbmilik handlerDocImage.axd. - Tidak ada metadata DICOM.
Viewer.GetDicomMetadataAsyncselalu mengembalikannulldan mencatat peringatan satu kali untuk sesi DICOM; permintaan metadataDocImage.axdmenjawab404, bukan501pada paket .NET 6 dan .NET Standard. - Hanya Windows, seperti paket .NET Framework lainnya.
Apakah halaman ini membantu?