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, plugin-only format bir formattı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 aynı zamanda Dicom yeteneğini de gerektirir.
Paketi Yükleyin
dotnet add package Doconut.NET6.DicomSürüm belirtilmemiş komut, en son kararlı sürümü kurar. Bu belgelerin açıkladığı sürüme eklentiyi sabitlemek için, sürümü ayrı olarak geçirin:
dotnet add package Doconut.NET6.Dicom --version 26.10.0DICOM paketini Doconut.NET6 ile aynı sürümde tutun. Paket kimliği
Doconut.NET6.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; bu dosya görüntüleyici lisansı ile birlikte okunur.
Platformlar. Eklenti, Doconut.NET6 çalıştığı her yerde çalışır: Windows ve x64 üzerinde glibc tabanlı Linux (Alpine veya diğer musl tabanlı dağıtımlar değil). Linux'ta, ilk belge açılmadan önce font yapılandırma kütüphanesini kurun:
apt-get update && apt-get install -y libfontconfig1RHEL, Fedora ve benzeri dağıtımlarda paket fontconfig'dir. Onsuz, bir belge açma The system library libfontconfig1 is missing. Install it (Debian/Ubuntu: apt-get install -y libfontconfig1) and see the Linux section of the Doconut documentation. hatasıyla başarısız olur.
Eklentiyi Kaydet
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ırlı olarak kaydeder. Bunu sağlayan bir lisans olmadan, AddDoconut() başlatma sırasında 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 hakkında bilgi için Lisans Kurulumu bölümüne bakın.
Hiçbir yerleşik görüntüleyici bu formatları işlemediğinden, ç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 watermark
| Lisans durumu | Başlangıç | DICOM çıktısı |
|---|---|---|
Ücretli lisans, Dicom verir, sürüm penceresi içinde | Başlar | Normal sayfa watermark kuralları altında işlenir |
| Aktif Geçici (Demo/NFR) lisans | Başlar | Değerlendirme watermark'ı 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 watermark 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 yolu özelleştirilmiş watermark'lara izin verdiğinde kullanılır; bir değerlendirme watermark'ını değiştiremez.
C#'dan Kullanım
var token = await viewer.OpenDocumentAsync(path, new DicomConfig
{
DisplayMode = DicomDisplayMode.AnimationAndFrames
});Viewer.GetDicomMetadataAsync(token) bu pakette bulunur, ancak bir DICOM oturumu için null döndürür: bkz. Çerçeve notları.
Görüntüleme modları, çözünürlük ve meta veriler
Görüntüleme modları
Çoklu ç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 = çerçeve başına bir statik PNG | Çerçeve bazlı tanısal gezinme |
AnimationAndFrames (default) | 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ış + detay |
Animasyon zamanlaması AnimationFrameDelayMs tarafından kontrol edilir (varsayılan 100 ms = 10 FPS; GIF granülerliği 10 ms birimler) ve LoopCount (0 = sonsuza kadar döngü).
Çözünürlük
DicomConfig varsayılan olarak eksen başına 100 DPI ile render eder. Çözünürlük özelliklerinin bilinmesi gereken bir geri dönüş zinciri vardır: HorizontalResolution/VerticalResolution değerlerini açıkça ayarlamazsanız, yapılandırılmış olduğunda BaseConfig.ImageResolution izler ve ancak o zaman 100'e geri döner.
// Temel özellik üzerinden tekdüze bump…
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, aktarım sözdizimi, modalite ve varsayılan pencere seviyesi. Hasta tanımlayıcı verileri içermez. Tam liste API referansı içinde bulunur. Bu pakette meta veriler mevcut değildir; bkz. Çerçeve notları.
Görüntüleyicide
Görüntüleyici DICOM'e özgü bir kurulum gerektirmez. Açık belge bir DICOM dosyası olduğunda, meta verileri (?token=<token>&meta=1) ister 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 pakette istek 501 yanıtını verir, bu yüzden panel asla görünmez.
Kendi ön uçunuzu oluşturun
Meta veriler, UseDoconut()'in (genellikle /doconut) bağlandığı yol altında HTTP üzerinden, herhangi bir açık belge token'ı 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ı içindeki özellik adlarıyla (Width, Height, NumberOfFrames, …) |
| Durum | Ne zaman | Gövde |
|---|---|---|
404 | Belge bir DICOM dosyası değil | yalnızca durum |
501 | Belge bir DICOM dosyası, ancak bu paket etiketlerini okuyamıyor | { "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 verileri okuma 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
Çoklu çerçeve çalışmaları hem bir animasyon hem de çerçeve başına bir statik sayfa üretebilir. AnimationAndFrames en zengin gezinmeyi sağlar ancak en yüksek render ve önbellek maliyetine sahiptir. Büyük çalışmalar için:
FramesOnly'i çerçeve incelemesinin sinematik oynatmadan daha önemli olduğu durumlarda 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;
- tekrarlanan erişim faydaları saklanan görüntülerden daha ağır bastığında yalnızca
CachePages'i etkin tutun.
Her sunucuda Doconut.Viewer.Dicom.lic'i Doconut.Viewer.lic'in yanına koyun.
API referansı
DicomConfig, DicomDisplayMode ve DicomMetadata Doconut ad alanında bulunur. DicomPlugin, Doconut.Plugins.Dicom içinde bulunur. Tam DicomConfig özellik tablosu Biçim 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 = sonsuz 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 üzerinde 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" or "Signed"
public string? PlanarConfiguration { get; init; }
public string? TransferSyntax { get; init; }
public string? Modality { get; init; } // null, ortaya çıkmadığında
public double? WindowCenter { get; init; }
public double? WindowWidth { get; init; }
public bool IsColor { get; init; }
}Sorun Giderme
| Semptom | Neden | Çözüm |
|---|---|---|
AddDoconut(), The Dicom plugin is registered via AddPlugin but no active license grants Dicom. hatası verir | 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ı açma, Document format '.dcm' is not supported. hatası verir | DicomPlugin kaydedilmemiş veya paketi dağıtılmamış | AddDoconut() içinde AddPlugin<DicomPlugin>() ekleyin ve paketi dağıtın |
.dcm dosyası açma, LicenseException: This document type requires the 'Dicom' plugin license. hatası verir | 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üler ekler | Bakınız Üretimde; 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 | Beklenen .NET 6 sınırlaması; renderleme etkilenmez | Etiketlere ihtiyacınız olduğunda .NET 8 paketini kullanın |
GetDicomMetadataAsync, Document session not found. Please re-open document. hatası verir | Token süresi doldu veya hiç açılmadı | Belgeyi tekrar açın |
Çerçeve Notları
- DICOM meta verisi yok. DICOM sayfa renderleme, tek tek çerçeveler, animasyon, dönüşümler ve filigranlama desteklenir. Teknik etiket meta verisi .NET 6 paketinde mevcut değil çünkü meta veri okuyucunun .NET 6 yapısı yok.
Viewer.GetDicomMetadataAsync(token)bu nedenle bir DICOM oturumu içinnulldöndürür ve tek seferlik bir uyarı kaydeder. İlgili?token=…&meta=1isteği HTTP501 Not Implementedile sabit hata kodudicom_metadata_unsupporteddöndürür. Teknik DICOM meta verisi bir gereklilik olduğunda .NET 8 paketini kullanın.
Bu sayfa yardımcı oldu mu?