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.
| Yüzey | Ne zaman kullanılır |
|---|---|
Viewer with DicomConfig (C#) | Sunucuda DICOM dosyalarını açar ve çerçevelerinin nasıl sunulacağını seçersiniz |
Görüntüleyici (docViewer) | Ç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 kurun
dotnet add package Doconut.NETStandard.DicomSürüm belirtilmemiş komut, en son kararlı sürümü kurar. Bu belgede açıklanan sürüme eklentiyi sabitlemek için, sürümü ayrı olarak geçirin:
dotnet add package Doconut.NETStandard.Dicom --version 26.10.0Doconut.NETStandard ile aynı sürümde DICOM paketini tutun. Paket kimliği Doconut.NETStandard.Dicom; .<version> yalnızca indirilen .nupkg dosya adında görünür.
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
builder.Services.AddDoconut(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. Bunu sağlayan bir lisans olmadan, AddDoconut() başlangıçta bir InvalidOperationException fırlatır, uygulama bir istek hizmet etmeden önce:
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.Bu, lisans olmaması, eski bir TRIAL dosyası, Dicom içermeyen bir lisans ve sürüm penceresi dışında kullanılan bir ücretli lisans için fırlatılır. Geçici Demo/NFR lisansları kabul edilir. Lisansların nasıl yüklendiği için Lisans Kurulumu bölümüne bakın.
Yerleşik bir görüntüleyici bu formatları işleyemediği için, çalışma zamanı kapısı da yetenek daha sonra kullanılamaz hale gelirse sert bir şekilde başarısız olur:
LicenseException: This document type requires the 'Dicom' plugin license.Lisanslama ve filigran
| Lisans durumu | Başlangıç | DICOM çıktısı |
|---|---|---|
Sürüm penceresi içinde Dicom sağlayan ücretli lisans | Başlar | Normal sayfa filigran kuralları altında işlenir |
| Etkin 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ışında bir ücretli lisans | AddDoconut() fırlatır | — |
Normal sayfa filigran kararı aynı zamanda DICOM çıktısına da uygulanır. Animasyonlu çıktı için, her GIF çerçevesi damgalanır, böylece işaret oynatma süresince görünür kalır. Özel bir DocOptions.Watermark yalnızca lisans yolu özel filigranlara izin verdiğinde kullanılır; bir değerlendirme filigranının yerini alamaz.
C#'tan Kullanım
var token = await viewer.OpenDocumentAsync(path, new DicomConfig
{
DisplayMode = DicomDisplayMode.AnimationAndFrames
});Viewer.GetDicomMetadataAsync(token) bu paket içinde mevcut, ancak bir DICOM oturumu için null döndürür: Çerçeve notları bölümüne bakın.
Görüntüleme modları, çözünürlük ve meta veriler
Görüntüleme Modları
Multi-frame DICOM files can be presented three ways (DicomDisplayMode):
| Mod | Üretilen Sayfalar | Kullanım |
|---|---|---|
AnimationOnly | Sayfa 1 = tüm çerçeveleri döngüleyen animasyonlu GIF | Hızlı sinematik inceleme |
FramesOnly | Sayfalar 1..N = çerçeve başına bir statik PNG | Çerçeve‑çerçeve tanısal gezinme |
AnimationAndFrames (varsayılan) | Sayfa 1 = animasyonlu GIF, sayfalar 2..N+1 = çerçeve başına bir statik PNG (N = çerçeve sayısı) | Tek bir belgede genel bakış + ayrıntı |
Animasyon zamanlaması AnimationFrameDelayMs ile kontrol edilir (varsayılan 100 ms = 10 FPS; GIF granülerliği 10 ms birimlerdir) ve LoopCount (0 = sonsuza kadar döngü).
Çözünürlük
DicomConfig varsayılan olarak eksen başına 100 DPI'de render eder. Çözünürlük özelliklerinin bilinmesi gereken bir yedekleme zinciri vardır: HorizontalResolution/VerticalResolution değerlerini açıkça ayarlamazsanız, yapılandırıldığında BaseConfig.ImageResolution değerini izler ve ancak o zaman 100'e geri döner.
// Temel özellik aracılığıyla tekdüze çıkıntı…
new DicomConfig { ImageResolution = 150 };
// …veya eksen bazlı kontrol
new DicomConfig { HorizontalResolution = 200, VerticalResolution = 150 };Meta Veriler
DicomMetadata yalnızca teknik ve görüntüleme etiketlerini taşır — çerçeve sayısı, boyutlar, bit derinliği, fotometrik yorum, transfer sözdizimi, modalite ve varsayılan pencere seviyesi. Hasta kimliğini belirten veri içermez. Tam liste API referansında bulunur. Bu paket içinde meta veriler mevcut değildir; bakınız Framework notları.
Görüntüleyicide
Görünümcünün DICOM'ye özgü bir kuruluma ihtiyacı yoktur. Açık belge bir DICOM dosyası olduğunda, meta verileri (?token=<token>&meta=1) talep eder ve teknik özellikler panelini açan bir DICOM düğmesi ekler. Bu istek başarısız olursa, panel gizli kalır ve belge yine de render edilir. Bu paket içinde istek 501 yanıtını verir, bu yüzden panel asla görünmez.
Kendi Ön Ucunu Oluştur
Meta veriler, UseDoconut()'nin (genellikle /doconut) monte edildiği yol altında HTTP üzerinden, herhangi bir açık belge belirteci için kullanılabilir:
| Yol | Amaç | Başarılı yanıt |
|---|---|---|
GET ?token=<token>&meta=1 | Açık bir DICOM belgesinin teknik meta verilerini okur | 200 — DicomMetadata JSON olarak, API referansındaki özellik adlarıyla (Width, Height, NumberOfFrames, …) |
| Durum | Ne zaman | Gövde |
|---|---|---|
404 | Belge bir DICOM dosyası değildir | yalnızca durum |
501 | Belge bir DICOM dosyasıdır, ancak bu paket etiketlerini okuyamaz | { "error": "dicom_metadata_unsupported", "message": "DICOM technical metadata is not supported on this package: the underlying medical-imaging engine has no build for this target framework. On this package it always returns null; use the .NET 8 package if you need it. DICOM rendering is unaffected." } |
500 | Meta verilerin okunması başarısız oldu | { "error": "metadata failed" } |
Sayfa görüntüleri, animasyonlu ilk sayfa dahil, standart görüntüleyici görüntü yolunu kullanır.
Üretimde
Çok çerçeveli çalışmalar hem bir animasyon hem de çerçeve başına bir statik sayfa oluşturabilir. AnimationAndFrames en zengin gezinmeyi sağlar ancak en yüksek render ve önbellek maliyetine sahiptir. Büyük çalışmalar için:
- çerçeve incelemesinin sinematik oynatmadan daha önemli olduğu durumlarda
FramesOnly'yi kullanın; - her iki çözünürlük eksenini de belleği ölçmeden artırmaktan kaçının;
- çalışma artık açık olmadığında oturumu açıkça kapatın;
CachePages'yi yalnızca tekrarlanan erişim faydaları saklanan görüntülerden daha ağır bastığında etkin tutun.
Doconut.Viewer.Dicom.lic'yi her sunucuda Doconut.Viewer.lic'nin yanına koyun.
API Referansı
DicomConfig, DicomDisplayMode ve DicomMetadata, Doconut ad alanındadır. DicomPlugin, Doconut.Plugins.Dicom içinde bulunur. Tam DicomConfig özellik tablosu Format Configs 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);Belge bir DICOM dosyası olmadığında null döndürür ve bu paket içinde her zaman null döndürür. Token bilinmiyorsa veya süresi dolmuşsa InvalidOperationException fırlatır.
DicomMetadata
public sealed class DicomMetadata
{
public int Width { get; init; }
public int Height { get; init; }
public int NumberOfFrames { get; init; }
public int BitsAllocated { get; init; }
public int BitsStored { get; init; }
public int SamplesPerPixel { get; init; }
public string? PhotometricInterpretation { get; init; }
public string? PixelRepresentation { get; init; } // "Unsigned" veya "Signed"
public string? PlanarConfiguration { get; init; }
public string? TransferSyntax { get; init; }
public string? Modality { get; init; } // null maruz kalınmadığında
public double? WindowCenter { get; init; }
public double? WindowWidth { get; init; }
public bool IsColor { get; init; }
}Troubleshooting
| Belirti | Neden | Düzeltme |
|---|---|---|
AddDoconut(), The Dicom plugin is registered via AddPlugin but no active license grants Dicom. fırlatır | Lisans yok, bir TRIAL dosyası, Dicom içermeyen bir lisans veya sürüm penceresinin dışındaki ücretli bir lisans | Dicom sağlayan bir lisans kurun veya AddPlugin<DicomPlugin>() kaldırın |
.dcm dosyasını açmak, Document format '.dcm' is not supported. fırlatır | DicomPlugin kayıtlı değil veya paketi dağıtılmamış | AddPlugin<DicomPlugin>()'ı AddDoconut() içine ekleyin ve paketi dağıtın |
.dcm dosyasını açmak, LicenseException: This document type requires the 'Dicom' plugin license. fırlatır | Yüklenen lisans artık Dicom sağlamıyor | Dicom sağlayan bir lisans kurun |
| Sadece bir sayfa görünür | Kaynak tek çerçeveli, ya da DisplayMode AnimationOnly | Çok çerçeveli bir kaynak için FramesOnly veya AnimationAndFrames kullanın |
| Animasyon çok hızlı ya da yavaş | AnimationFrameDelayMs kapalı; etkili GIF zamanlaması 10 ms birimlerini kullanır | AnimationFrameDelayMs'ı ayarlayın |
| Büyük çok çerçeveli 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 veri null | Belge bir DICOM dosyası değil | Meta veri istemeden önce dosya türünü kontrol edin |
Bir DICOM dosyası için meta veri null, ya da &meta 501 döndürür | Bu paketin beklenen sınırlaması; render etme etkilenmez | 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 dolmuş veya hiç açılmamış | Belgeyi tekrar açın |
Framework notes
- No DICOM metadata. DICOM sayfa renderleme, tek tek çerçeveler, animasyon, dönüşümler ve filigranlama desteklenir. Teknik etiket meta verileri .NET Standard paketinde mevcut değildir çünkü meta veri okuyucu yalnızca .NET 8 sürümüyle gelir.
Viewer.GetDicomMetadataAsync(token)bu nedenle bir DICOM oturumu içinnulldöndürür ve tek seferlik bir uyarı kaydeder. İlgili?token=…&meta=1isteği, sabit hata kodudicom_metadata_unsupportedile HTTP501 Not Implementeddöndürür. Teknik DICOM meta verileri bir gereklilik olduğunda .NET 8 paketini kullanın. - Yalnızca Windows, .NET Standard paketinin geri kalanı gibi.
Bu sayfa yardımcı oldu mu?