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üzeyNe zaman kullanılmalı
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, çerçeveler ve bir DICOM özellik paneli
HTTP uç noktası (?token=<token>&meta=1)Kendi ön ucunuzdan teknik meta verileri okursunuz

Eklentinin kendi widget'ı yoktur: DICOM dosyaları normal görüntüleyicide açılır. Dönüştürücü eklentisi de kayıtlı olduğunda, .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

bash
dotnet add package Doconut.NET8.Dicom

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

bash
dotnet add package Doconut.NET8.Dicom --version 26.10.0

Doconut.NET8 ile aynı sürümde DICOM paketini tutun. Paket kimliği Doconut.NET8.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.

Platformlar. Eklenti, Doconut.NET8 ç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:

bash
apt-get update && apt-get install -y libfontconfig1

RHEL, Fedora ve benzeri dağıtımlarda paket fontconfig'dır. 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 Kaydedin

csharp
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şlangıçta bir InvalidOperationException fırlatır, uygulama bir istek hizmet etmeden önce:

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.

Bu, lisans olmadığında, eski bir TRIAL dosyası, Dicom içermeyen bir lisans ve sürüm penceresi dışındaki bir ücretli lisans için fırlatılır. Geçici Demo/NFR lisansları kabul edilir. Lisansların nasıl yüklendiğini görmek için Lisans Kurulumu bölümüne bakın.

Hiçbir yerleşik görüntüleyici bu formatları işleyemediği için, çalışma zamanı geçidi de yetenek daha sonra kullanılamaz hale gelirse sert bir şekilde başarısız olur:

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

Lisanslama ve filigran

Lisans durumuBaşlangıçDICOM çıktısı
Sürüm penceresi içinde Dicom sağlayan ücretli lisansBaşlarNormal sayfa filigran kuralları altında 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 lisansAddDoconut() fırlatır—

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ü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#'dan Kullanım

csharp
var token = await viewer.OpenDocumentAsync(path, new DicomConfig
{
    DisplayMode = DicomDisplayMode.AnimationAndFrames
});

Bu eklenti aracılığıyla açılan oturumlar için, Viewer etiket meta verilerini ortaya çıkarır:

csharp
var metadata = await viewer.GetDicomMetadataAsync(token);
// oturum bir DICOM belgesi değilse null

Görüntüleme modları, çözünürlük ve meta veriler

Görüntüleme modları

Çok çerçeveli DICOM dosyaları üç şekilde sunulabilir (DicomDisplayMode):

ModOluşturulan SayfalarKullanım
AnimationOnlySayfa 1 = tüm çerçeveleri döngüleyen animasyonlu GIFHızlı sinematik inceleme
FramesOnlySayfalar 1..N = her çerçeve için bir statik PNGKare kare tanısal gezinme
AnimationAndFrames (varsayılan)Sayfa 1 = animasyonlu GIF, sayfalar 2..N+1 = her çerçeve için bir statik PNG (N = çerçeve sayısı)Tek bir belgede genel bakış + ayrıntı

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'de 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.

csharp
// Temel özellik aracılığıyla tekdüze artış…
new DicomConfig { ImageResolution = 150 };

// …veya eksen‑başına kontrol
new DicomConfig { HorizontalResolution = 200, VerticalResolution = 150 };

Meta veriler

DicomMetadata sadece 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 tanımlayıcı verileri içermez. Tam liste API referansı içinde bulunur.

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) 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 renderlanır.

Kendi ön ucunuzu oluşturun

Meta veriler, UseDoconut()'ın (genellikle /doconut) bağlandığı yol altında HTTP üzerinden, herhangi bir açık belge token'ı için kullanılabilir:

YolAmaçBaşarı Yanıtı
GET ?token=<token>&meta=1Açık bir DICOM belgesinin teknik meta verilerini oku200 — DicomMetadata JSON olarak, API referansı içindeki özellik adlarıyla (Width, Height, NumberOfFrames, …)
DurumNe ZamanGövde
404Belge bir DICOM dosyası değilsadece durum
500Meta 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 üretebilir. AnimationAndFrames en zengin gezinmeyi sağlar ancak en yüksek render ve önbellek maliyetine sahiptir. Büyük çalışmalar için:

  • FramesOnly'ı, çerçeve incelemesinin sinematik oynatmadan daha önemli olduğu durumlarda kullanın;
  • her iki çözünürlük eksenini artırmaktan kaçının, belleği ölçmeden;
  • çalışma artık açık olmadığında oturumu açıkça kapatın;
  • CachePages'ı yalnızca tekrarlanan erişim faydaları saklanan görüntülerden ağır bastığında etkin tutun.

Her sunucuda Doconut.Viewer.Dicom.lic'ı Doconut.Viewer.lic'ın 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 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);

Belge bir DICOM dosyası olmadığında null döndürür. Token bilinmiyorsa veya süresi dolmuşsa InvalidOperationException fırlatır.

DicomMetadata

csharp
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 ifşa edilmediğinde
    public double? WindowCenter { get; init; }
    public double? WindowWidth { get; init; }
    public bool IsColor { get; init; }
}

Sorun Giderme

SemptomNedenÇözüm
AddDoconut(), The Dicom plugin is registered via AddPlugin but no active license grants Dicom. fırlatırLisans yok, bir TRIAL dosyası, Dicom içermeyen bir lisans, ya da sürüm penceresinin dışındaki ücretli bir lisansDicom sağlayan bir lisans kurun veya AddPlugin<DicomPlugin>() kaldırın
Bir .dcm dosyası açmak Document format '.dcm' is not supported. fırlatırDicomPlugin kayıtlı değil veya paketi dağıtılmamışAddDoconut() içine AddPlugin<DicomPlugin>() ekleyin ve paketi dağıtın
Bir .dcm dosyası açmak LicenseException: This document type requires the 'Dicom' plugin license. fırlatırYüklenen lisans artık Dicom sağlamıyorDicom sağlayan bir lisans kurun
Yalnızca bir sayfa görünürKaynak tek kareli, ya da DisplayMode AnimationOnlyÇok kareli 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ı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üler eklerBakınız Üretimde; oturumları açıkça kapatın
Metadata nullBelge bir DICOM dosyası değilMetadata istemeden önce dosya türünü kontrol edin
GetDicomMetadataAsync, Document session not found. Please re-open document. fırlatırToken süresi doldu veya hiç açılmadıBelgeyi tekrar açın

Bu sayfa yardımcı oldu mu?