DICOM Eklentisi
DicomPlugin ile tıbbi görüntüleri görüntüleyin
DICOM eklentisi, Doconut'a tıbbi görüntü görüntüleme özelliği ekler: çok çerçeveli DICOM dosyaları animasyonlu bir genel bakış, tek tek çerçeveler veya her ikisi olarak işlenir. DICOM, yalnızca eklenti formatıdır — bu eklenti (ve lisans yeteneği) olmadan, .dcm dosyaları hiç açılamaz.
.NET Framework 4.7.2'de, DICOM dosyaları tam olarak işlenir — sayfalar, çerçeveler ve animasyon — ancak teknik meta veriler (DICOM etiketleri) mevcut değildir.
Viewer.GetDicomMetadataAsyncher zamannulldöndürür ve görüntüleyicinin meta veri isteği (?token=…&meta=1üzerindeDocImage.axd)404yanıtını verir, bu yüzden görüntüleyici DICOM özellik paneli göstermez. Etiketlere ihtiyacınız varsaDoconut.NET8kullanın.
| Yüzey | Ne zaman kullanılmalı |
|---|---|
Viewer with DicomConfig (C#) | DICOM dosyalarını sunucuda açar ve çerçevelerinin nasıl sunulacağını seçersiniz |
Görüntüleyici (docViewer) DocImage.axd üzerinde | Çalışmayı sayfanızda gösterirsiniz: animasyon ve çerçeveler |
Eklentinin kendi widget'ı yoktur: DICOM dosyaları normal görüntüleyicide açılır. Dönüştürücü eklentisi de kaydedildiğinde, .dcm ve .ima dosyaları Pdf, Png, Jpeg, Bmp, Tiff veya Gif formatına dönüştürülebilir; bu dönüşüm ayrıca Dicom yeteneğini gerektirir.
Paketi Yükleyin
Install-Package Doconut.NETFramework.DicomBu belgenin açıkladığı sürüme eklentiyi sabitlemek için:
Install-Package Doconut.NETFramework.Dicom -Version 26.10.0DICOM paketini Doconut.NETFramework ile aynı sürümde tutun.
Eklentinin lisans dosyası, Doconut.Viewer.Dicom.lic, Doconut.Viewer.lic ile aynı klasöre konur; görüntüleyici lisansı ile birlikte okunur.
Eklentiyi Kaydedin
Doconut.DoconutHost.Initialize(options =>
{
options.AddPlugin<Doconut.Plugins.Dicom.DicomPlugin>();
});Eklenti (Name: "Doconut DICOM Viewer"), .dcm ve .ima uzantıları için görüntüleyicileri, Dicom yeteneğiyle sınırlayarak kaydeder. Lisans bunu sağlamıyorsa, DoconutHost.Initialize, Application_Start içinde bir hata fırlatır:
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 içinde bu, her isteğin boş bir 500 yanıtı verdiği ve sebebin yalnızca Windows olay günlüğünde (kaynak ASP.NET) olduğu anlamına gelir. Lisans olmadığında, eski bir TRIAL dosyası, Dicom içermeyen bir lisans ve sürüm penceresi dışındaki bir ücretli lisans için hata fırlatır. Geçici Demo/NFR lisansları kabul edilir. Lisans Kurulumu bölümüne bakın.
Bu formatları işleyen yerleşik bir görüntüleyici olmadığı için, yetenek daha sonra kullanılamaz hale gelirse bir dosya açmak doğrudan başarısız olur:
LicenseException: This document type requires the 'Dicom' plugin license.Lisanslama ve Filigran
| Lisans durumu | Başlangıç | DICOM çıktısı |
|---|---|---|
Ücretli lisans, Dicom sağlar, sürüm penceresi içinde | Başlar | Normal sayfa filigran kurallarına göre işlenir |
| Aktif Geçici (Demo/NFR) lisans | Başlar | Değerlendirme filigranı ile işlenir |
Lisans yok, eski bir TRIAL dosyası, Dicom içermeyen bir lisans veya sürüm penceresi dışındaki bir ücretli lisans | Application_Start hata fırlatır; her istek boş bir 500 yanıtı verir | — |
Normal sayfa filigran kararı DICOM çıktısına da uygulanır. Animasyonlu çıktı için, her GIF çerçevesi damgalanır, böylece işaret oynatma sırasında görünür kalır. Özelleştirilmiş bir DocOptions.Watermark yalnızca lisans özel filigranlara izin verdiğinde kullanılır; bir değerlendirme filigranını değiştiremez.
C#'dan Kullanım
var token = await viewer.OpenDocumentAsync(path, new DicomConfig
{
DisplayMode = DicomDisplayMode.AnimationAndFrames
});var metadata = await viewer.GetDicomMetadataAsync(token);
// .NET Framework'te bu her zaman null'dur: DICOM metadata okuyucusu bu için mevcut değildir
// target. Sayfalar, çerçeveler ve animasyon normal olarak işlenir.Bu yöntem, .NET 8 paketiyle paylaşılan kodun derlenebilmesi için bu pakette bulunur, ancak DICOM etiketlerini okumak .NET Framework derlemesi olmayan bir bileşen gerektirir. Kullanıcı arayüzünüzü bunlar olmadan planlayın — örneğin, sonuç null olduğunda bir meta veri panelini gizleyin.
Görüntüleme modları ve çözünürlük
Görüntüleme modları
Çok çerçeveli DICOM dosyaları üç şekilde sunulabilir (DicomDisplayMode):
| Mod | Oluşturulan Sayfalar | Kullanım Amacı |
|---|---|---|
AnimationOnly | Sayfa 1 = tüm çerçeveleri döngüleyen animasyonlu GIF | Hızlı sinematik inceleme |
FramesOnly | Sayfalar 1..N = her çerçeve için bir sabit PNG | Çerçeve‑çerçeve tanısal gezinme |
AnimationAndFrames (default) | Sayfa 1 = animasyonlu GIF, sayfalar 2..N+1 = her çerçeve için bir sabit PNG (N = çerçeve sayısı) | Tek bir belgede genel bakış ve detay |
Animasyon zamanlaması AnimationFrameDelayMs tarafından kontrol edilir (varsayılan 100 ms = 10 FPS; GIF zamanlaması 10 ms birimlerini kullanır) ve LoopCount (0 = sonsuza kadar döngü).
Görüntüleyici, sayfa 1'in animasyonlu olduğunu HEAD isteği göndererek belirler. DocImage.axd işleyicisi bu nedenle HEAD'ı Web.config içinde kabul etmelidir (verb="GET,HEAD,POST", bakınız Kurulum); olmadan IIS, Doconut çalışmadan önce 404 yanıt verir ve animasyon algılaması asla çalışmaz.
Çözünürlük
DicomConfig varsayılan olarak eksen başına 100 DPI'de işler. HorizontalResolution/VerticalResolution'ı açıkça ayarlamazsanız, BaseConfig.ImageResolution ayarlandığında onu izler ve ancak o zaman 100'e geri döner.
// Temel özellik üzerinden tekdüze bump…
new DicomConfig { ImageResolution = 150 };
// …veya eksen‑başına kontrol
new DicomConfig { HorizontalResolution = 200, VerticalResolution = 150 };Kendi ön ucunuzu oluşturun
Sayfa görüntüleri, animasyonlu ilk sayfa dahil, standart DocImage.axd görüntü yolunu kullanır. Meta veri isteği, GET /DocImage.axd?token=<token>&meta=1, bu paketteki her belge için, DICOM dosyaları dahil, 404 yanıtını verir, çünkü meta veri okuyucu mevcut değildir.
Üretimde
Çok çerçeveli çalışmalarda hem bir animasyon hem de her çerçeve için bir sabit sayfa üretilebilir. AnimationAndFrames en kapsamlı gezinmeyi sağlar ancak en yüksek işleme ve bellek maliyetini de getirir — ve tek bir sunucuda bu bellek IIS işçi sürecine aittir. Büyük çalışmalar için:
- çerçeve incelemesi oynatmadan daha önemli olduğunda
FramesOnlykullanın; - her iki çözünürlük eksenini bellek ölçmeden artırmaktan kaçının;
- çalışma artık açık olmadığında oturumu açıkça kapatın;
- sadece tekrar erişimin saklanan görüntülere değer olduğu durumlarda
CachePagesaçık tutun;
Doconut.Viewer.Dicom.lic'ı her sunucuda Doconut.Viewer.lic'ın yanına koyun ve HEAD'ı işleyicinin verb listesinde tutun.
API referansı
DicomConfig, DicomDisplayMode ve DicomMetadata Doconut ad alanındadır. DicomPlugin, Doconut.Plugins.Dicom içinde bulunur. Tam DicomConfig özellik tablosu Format Yapılandırmaları içinde yer alır.
DicomConfig
public sealed class DicomConfig : BaseConfig
{
public int HorizontalResolution { get; set; } // varsayılan: ImageResolution ayarlandığında, aksi takdirde 100
public int VerticalResolution { get; set; } // varsayılan: ImageResolution ayarlandığında, aksi takdirde 100
public int AnimationFrameDelayMs { get; set; } = 100;
public ushort LoopCount { get; set; } = 0; // 0 = sonsuza kadar döngü
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);Bu paket için her zaman null döndürür. Token bilinmiyorsa veya süresi dolmuşsa InvalidOperationException fırlatır. DicomMetadata, .NET 8 paketiyle paylaşılan kodun derlenebilmesi için tanımlanmıştır.
Sorun Giderme
| Belirti | Neden | Düzeltme |
|---|---|---|
Eklentiyi ekledikten sonra her istek boş bir 500 yanıt verir; Windows olay günlüğü (kaynak ASP.NET) The Dicom plugin is registered via AddPlugin but no active license grants Dicom. gösterir | Lisans yok, bir TRIAL dosyası, Dicom içermeyen bir lisans veya sürüm penceresinin dışında bir ücretli lisans | Dicom sağlayan bir lisans kurun veya AddPlugin<DicomPlugin>() kaldırın |
.dcm dosyasını açarken Document format '.dcm' is not supported. fırlatılır | DicomPlugin kayıtlı değil veya paketi dağıtılmamış | DoconutHost.Initialize içinde AddPlugin<DicomPlugin>() ekleyin ve paketi dağıtın |
.dcm dosyasını açarken LicenseException: This document type requires the 'Dicom' plugin license. fırlatılır | Yüklenen lisans artık Dicom sağlamıyor | Dicom sağlayan bir lisans kurun |
| Yalnızca bir sayfa görünür | Kaynak tek kareli, veya DisplayMode AnimationOnly | Çok kareli bir kaynak için FramesOnly veya AnimationAndFrames kullanın |
| Sayfa 1 animasyon yapmıyor | Web.config içindeki işleyici HEAD kabul etmiyor | verb="GET,HEAD,POST" kullanın |
| Animasyon çok hızlı ya da yavaş | AnimationFrameDelayMs kapalı; GIF zamanlaması 10 ms birimlerini kullanır | AnimationFrameDelayMs ayarlayın |
| Büyük çok kareli dosyalarda bellek artar | Görüntüleme modu, çözünürlük ve sayfa önbelleği tümü saklanan görüntüleri ekler | Üretimde bölümüne bakın; oturumları açıkça kapatın |
Meta veriler her zaman null | Bu paket için beklenir | Etiketlere ihtiyacınız olduğunda .NET 8 paketini kullanın |
GetDicomMetadataAsync Document session not found. Please re-open document. fırlatır | Token süresi doldu veya hiç açılmadı | Belgeyi tekrar açın |
Çerçeve Notları
ASP.NET Core paketleriyle karşılaştırıldığında, bu paket barındırma ve DICOM meta verileri açısından farklılık gösterir:
- Kayıt
Application_Startiçinde,DoconutHost.Initializearacılığıyla yapılır,builder.Services.AddDoconutyerine. - Başlangıç hataları her istekte boş bir
500olarak ortaya çıkar, neden Windows olay günlüğünde bulunur. - Animasyon algılama
DocImage.axdişleyicisininverblistesindeHEADgerektirir. - DICOM meta verisi yok.
Viewer.GetDicomMetadataAsyncher zamannulldöndürür ve bir DICOM oturumu için tek seferlik bir uyarı kaydeder;DocImage.axdmeta veri isteği404yanıt verir, .NET 6 ve .NET Standard paketlerinin501'sı değil. - Yalnızca Windows, .NET Framework paketinin geri kalanı gibi.
Bu sayfa yardımcı oldu mu?