Wtyczka DICOM

Plugin DICOM dodaje przeglądanie obrazów medycznych do Doconut: pliki DICOM wieloklatkowe są renderowane jako animowany przegląd, pojedyncze klatki lub oba. 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.NET6.Dicom

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

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

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

Zarejestruj wtyczkę

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

Plugin (Name: "Doconut DICOM Viewer") rejestruje przeglądarki dla rozszerzeń .dcm i .ima, zabezpieczone możliwością Dicom. Brak lub niewystarczające, nietrwałe 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

Pliki DICOM wieloklatkowe mogą być prezentowane na trzy sposoby (DicomDisplayMode):

Czas trwania animacji jest kontrolowany przez AnimationFrameDelayMs (domyślnie 100 ms = 10 FPS; rozdzielczość 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 wartości domyślnych, który warto znać: jeśli nie ustawisz explicite HorizontalResolution/VerticalResolution, będą one przyjmować wartość BaseConfig.ImageResolution, jeśli jest skonfigurowana, 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 };

Dostępność metadanych DICOM w .NET 6

Renderowanie stron DICOM, pojedynczych klatek, animacji, transformacji i znakowanie wodne są wspierane. Metadane techniczne tagów nie są dostępne w pakiecie .NET 6, ponieważ czytnik metadanych nie ma wersji .NET 6.

Viewer.GetDicomMetadataAsync(token) w związku z tym zwraca null dla sesji DICOM i loguje jednorazowe ostrzeżenie. Odpowiednie żądanie middleware ?token=…&meta zwraca HTTP 501 Not Implemented z trwałym kodem błędu dicom_metadata_unsupported. Użyj pakietu .NET 8, gdy techniczne metadane DICOM są wymagane.

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 per‑rozszerzenie w aplikacji referencyjnej:

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

Znakowanie wodne i zachowanie pamięci

Standardowa decyzja o znakowaniu wodnym stron ma również zastosowanie do wyjścia DICOM. Dla wyjścia animowanego każda klatka GIF jest znakowana, aby znak pozostawał widoczny podczas odtwarzania. 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 ma też najwyższy 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ę explicite, 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