Wtyczka DICOM

Wtyczka DICOM dodaje przeglądanie obrazów medycznych do Doconut: wieloklatkowe pliki DICOM są renderowane jako animowany przegląd, pojedyncze klatki lub oba jednocześnie. DICOM jest formatem wyłącznie wtyczkowym — bez tej wtyczki (i jej możliwości licencyjnej) pliki .dcm nie mogą być otwarte w ogóle.

Zainstaluj pakiet

dotnet add package Doconut.NET8.Dicom

Polecenie bez określenia wersji instaluję najnowsze stabilne wydanie. Aby przypiąć wtyczkę do bieżącego wydania 26.7.0, przekaż wersję osobno:

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

Utrzymuj pakiet DICOM w tej samej wersji co Doconut.NET8. Identyfikator pakietu to Doconut.NET8.Dicom; .26.7.0 pojawia się tylko w nazwie pobranego pliku .nupkg.

Zarejestruj wtyczkę

builder.Services.AddDoconut(options =>
{
    options.AddPlugin<Doconut.Plugins.Dicom.DicomPlugin>();
});

Wtyczka (Name: "Doconut DICOM Viewer") rejestruje przeglądarki dla rozszerzeń .dcm i .ima, zabezpieczone możliwością Dicom. Brak lub niewystarczające nie‑tymczasowe uprawnienie zazwyczaj powoduje błąd podczas AddDoconut(). Ponieważ żaden wbudowany podgląd nie obsługuje tych formatów, bramka w czasie wykonywania również twardo zawiedzie, jeśli możliwość później stanie się niedostępna:

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

Otwieranie pliku DICOM

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

Tryby wyświetlania

Wieloklatkowe pliki DICOM mogą być prezentowane na trzy sposoby (DicomDisplayMode):

Czas animacji jest kontrolowany przez AnimationFrameDelayMs (domyślnie 100 ms = 10 FPS; granularity GIF to jednostki 10 ms) oraz LoopCount (0 = nieskończona pętla).

Rozdzielczość

DicomConfig renderuje domyślnie z 100 DPI na oś. Właściwości rozdzielczości mają łańcuch domyślnych wartości, który warto znać: jeśli nie ustawisz HorizontalResolution/VerticalResolution jawnie, będą one dziedziczyć BaseConfig.ImageResolution, gdy jest skonfigurowane, a dopiero potem wracają do 100.

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

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

Odczytywanie metadanych DICOM

Podczas sesji otwartych przez tę wtyczkę, Viewer udostępnia metadane tagów:

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

Pełna referencja konfiguracji

Pełna tabela właściwości DicomConfig znajduje się w Referencji API → Konfiguracje formatów. Przykład produkcyjny z przełącznika aplikacji referencyjnej per‑rozszerzenie:

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

Znak wodny i zachowanie pamięci

Standardowa decyzja o znaku wodnym na stronie ma również zastosowanie do wyjścia DICOM. Dla wyjścia animowanego, każda klatka GIF jest znakowana, aby znak pozostał widoczny przez całe odtwarzanie. Niestandardowy DocOptions.Watermark jest używany tylko wtedy, gdy ścieżka licencyjna zezwala na własne znaki wodne; nie może zastąpić znaku wodnego wersji ewaluacyjnej.

Badania wieloklatkowe mogą generować zarówno animację, jak i jedną statyczną stronę na klatkę. AnimationAndFrames zapewnia najbogatszą nawigację, ale także największy koszt renderowania i pamięci podręcznej. Dla dużych badań:

• użyj FramesOnly, gdy inspekcja klatek jest ważniejsza niż odtwarzanie filmowe;
• unikaj zwiększania obu osi rozdzielczości bez pomiaru zużycia pamięci;
• zamknij sesję jawnie, gdy badanie nie jest już otwarte;
• pozostaw CachePages włączone tylko wtedy, gdy korzyści z powtarzalnego dostępu przewyższają koszty przechowywanych obrazów.

Rozwiązywanie problemów