DICOM Eklentisi

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.

Paketi Yükleyin

dotnet add package Doconut.NET8.Dicom

Sürüm belirtilmemiş komut, en son kararlı sürümü kurar. Eklentiyi mevcut 26.7.0 sürümüne sabitlemek için sürümü ayrı olarak geçirin:

dotnet add package Doconut.NET8.Dicom --version 26.7.0

DICOM paketini Doconut.NET8 ile aynı sürümde tutun. Paket kimliği Doconut.NET8.Dicom; .26.7.0 yalnızca indirilen .nupkg dosya adında görünür.

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ırlı olarak kaydeder. Eksik veya yetersiz geçici olmayan yetki genellikle AddDoconut() sırasında başarısız olur. Bu formatları işleyen yerleşik bir görüntüleyici olmadığından, çalışma zamanı kapısı yetenek daha sonra kullanılamaz hale gelirse sert bir şekilde başarısız olur:

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

Bir DICOM dosyası açma

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

Görüntüleme modları

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

Animasyon zamanlaması AnimationFrameDelayMs (varsayılan 100 ms = 10 FPS; GIF granülerliği 10 ms birimleridir) ve LoopCount (0 = sonsuz döngü) ile kontrol edilir.

Çözünürlük

DicomConfig varsayılan olarak eksen başına 100 DPI ile işler. Çö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 değerini izler ve ancak o zaman 100'e geri döner.

// Uniform bump via the base property…
new DicomConfig { ImageResolution = 150 };

// …or per-axis control
new DicomConfig { HorizontalResolution = 200, VerticalResolution = 150 };

DICOM meta verilerini okuma

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

var metadata = await viewer.GetDicomMetadataAsync(token);
// null when the session isn't a DICOM document

Tam yapılandırma referansı

Tam DicomConfig özellik tablosu API Referansı → Format Configs içinde bulunur. Referans uygulamasının uzantı bazlı geçişinden bir üretim örneği:

".DCM" or ".IMA" => new DicomConfig { DisplayMode = DicomDisplayMode.AnimationAndFrames },

Filigran ve bellek davranışı

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 boyunca görünür kalır. Özel bir DocOptions.Watermark yalnızca lisans yolu özel filigranlara izin verdiğinde kullanılır; değerlendirme filigranının yerini alamaz.

Çok çerçeveli çalışmalar hem bir animasyon hem de çerçeve başına bir statik sayfa üretebilir. AnimationAndFrames en zengin navigasyonu sağlar ancak en yüksek işleme ve önbellek maliyetine sahiptir. Büyük çalışmalar için:

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

Sorun Giderme