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.GetDicomMetadataAsync her zaman null döndürür ve görüntüleyicinin meta veri isteği (?token=…&meta=1 üzerinde DocImage.axd) 404 yanıtını verir, bu yüzden görüntüleyici DICOM özellik paneli göstermez. Etiketlere ihtiyacınız varsa Doconut.NET8 kullanın.

YüzeyNe 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

powershell
Install-Package Doconut.NETFramework.Dicom

Bu belgenin açıkladığı sürüme eklentiyi sabitlemek için:

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

DICOM 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

csharp
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:

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 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:

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

Lisanslama ve Filigran

Lisans durumuBaşlangıçDICOM çıktısı
Ücretli lisans, Dicom sağlar, sürüm penceresi içindeBaşlarNormal sayfa filigran kurallarına göre işlenir
Aktif Geçici (Demo/NFR) lisansBaşlarDeğ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 lisansApplication_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

csharp
var token = await viewer.OpenDocumentAsync(path, new DicomConfig
{
    DisplayMode = DicomDisplayMode.AnimationAndFrames
});
csharp
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):

ModOluşturulan SayfalarKullanım Amacı
AnimationOnlySayfa 1 = tüm çerçeveleri döngüleyen animasyonlu GIFHızlı sinematik inceleme
FramesOnlySayfalar 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.

csharp
// 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 FramesOnly kullanı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 CachePages açı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

csharp
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

csharp
public enum DicomDisplayMode { AnimationOnly, FramesOnly, AnimationAndFrames }

Viewer.GetDicomMetadataAsync

csharp
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

BelirtiNedenDü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österirLisans yok, bir TRIAL dosyası, Dicom içermeyen bir lisans veya sürüm penceresinin dışında bir ücretli lisansDicom 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ırDicomPlugin 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ırYüklenen lisans artık Dicom sağlamıyorDicom sağlayan bir lisans kurun
Yalnızca bir sayfa görünürKaynak tek kareli, veya DisplayMode AnimationOnlyÇok kareli bir kaynak için FramesOnly veya AnimationAndFrames kullanın
Sayfa 1 animasyon yapmıyorWeb.config içindeki işleyici HEAD kabul etmiyorverb="GET,HEAD,POST" kullanın
Animasyon çok hızlı ya da yavaşAnimationFrameDelayMs kapalı; GIF zamanlaması 10 ms birimlerini kullanırAnimationFrameDelayMs ayarlayın
Büyük çok kareli dosyalarda bellek artarGö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 nullBu paket için beklenirEtiketlere ihtiyacınız olduğunda .NET 8 paketini kullanın
GetDicomMetadataAsync Document session not found. Please re-open document. fırlatırToken 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_Start içinde, DoconutHost.Initialize aracılığıyla yapılır, builder.Services.AddDoconut yerine.
  • Başlangıç hataları her istekte boş bir 500 olarak ortaya çıkar, neden Windows olay günlüğünde bulunur.
  • Animasyon algılama DocImage.axd işleyicisinin verb listesinde HEAD gerektirir.
  • DICOM meta verisi yok. Viewer.GetDicomMetadataAsync her zaman null döndürür ve bir DICOM oturumu için tek seferlik bir uyarı kaydeder; DocImage.axd meta veri isteği 404 yanıt verir, .NET 6 ve .NET Standard paketlerinin 501'sı değil.
  • Yalnızca Windows, .NET Framework paketinin geri kalanı gibi.

Bu sayfa yardımcı oldu mu?