Plugin DICOM

Il plugin DICOM aggiunge la visualizzazione di immagini mediche a Doconut: i file DICOM multi-frame vengono renderizzati come una panoramica animata, fotogrammi individuali o entrambi. DICOM è un formato solo plugin — senza questo plugin (e la sua capacità di licenza), i file .dcm non possono essere aperti affatto.

Installa il pacchetto

dotnet add package Doconut.NETStandard.Dicom

Il comando senza versione installa l'ultima release stabile. Per fissare il plugin alla release corrente 26.8.0, passa la versione separatamente:

dotnet add package Doconut.NETStandard.Dicom --version 26.8.0

Mantieni il pacchetto DICOM alla stessa versione di Doconut.NETStandard. L'ID del pacchetto è Doconut.NETStandard.Dicom; .26.8.0 appare solo nel nome file scaricato .nupkg.

Registra il plugin

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

Il plugin (Name: "Doconut DICOM Viewer") registra visualizzatori per le estensioni .dcm e .ima, controllate dalla capacità Dicom. Un diritto mancante o insufficiente non temporaneo normalmente fallisce durante AddDoconut(). Poiché nessun visualizzatore integrato gestisce questi formati, il gate di runtime fallisce anche in modo definitivo se la capacità diventa successivamente non disponibile:

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

Apertura di un file DICOM

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

Modalità di visualizzazione

I file DICOM multi-frame possono essere presentati in tre modi (DicomDisplayMode):

Il timing dell'animazione è controllato da AnimationFrameDelayMs (predefinito 100 ms = 10 FPS; la granularità GIF è in unità da 10 ms) e LoopCount (0 = loop infinito).

Risoluzione

DicomConfig rende a 100 DPI per asse per impostazione predefinita. Le proprietà di risoluzione hanno una catena di fallback importante da conoscere: se non imposti esplicitamente HorizontalResolution/VerticalResolution, seguono BaseConfig.ImageResolution quando è configurato, e solo allora tornano a 100.

// Bump uniforme tramite la proprietà base…
new DicomConfig { ImageResolution = 150 };

// …o controllo per asse
new DicomConfig { HorizontalResolution = 200, VerticalResolution = 150 };

Disponibilità dei metadati DICOM su .NET Standard

La resa delle pagine DICOM, i fotogrammi individuali, l'animazione, le trasformazioni e il watermark sono supportati. I metadati dei tag tecnici non sono disponibili nel pacchetto .NET Standard perché il lettore di metadati è fornito solo per .NET 8.

Viewer.GetDicomMetadataAsync(token) quindi restituisce null per una sessione DICOM e registra un avviso una tantum. La corrispondente richiesta middleware ?token=…&meta restituisce HTTP 501 Not Implemented con il codice di errore stabile dicom_metadata_unsupported. Usa il pacchetto .NET 8 quando i metadati tecnici DICOM sono un requisito.

Riferimento completo alla configurazione

La tabella completa delle proprietà DicomConfig si trova in Riferimento API → Configurazioni Formato. Un esempio di produzione dal commutatore per estensione dell'app di riferimento:

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

Watermark e comportamento della memoria

La decisione normale sul watermark della pagina si applica anche all'output DICOM. Per l'output animato, ogni fotogramma GIF è contrassegnato in modo che il marchio rimanga visibile durante la riproduzione. Un DocOptions.Watermark personalizzato è usato solo quando il percorso di licenza consente watermark personalizzati; non può sostituire un watermark di valutazione.

Gli studi multiframe possono generare sia un'animazione sia una pagina statica per fotogramma. AnimationAndFrames fornisce la navigazione più ricca ma ha anche il costo più elevato di rendering e cache. Per studi di grandi dimensioni:

• usa FramesOnly quando l'ispezione dei fotogrammi è più importante della riproduzione cinematica;
• evita di aumentare entrambi gli assi di risoluzione senza misurare la memoria;
• chiudi esplicitamente la sessione quando lo studio non è più aperto;
• mantieni CachePages abilitato solo quando i benefici dell'accesso ripetuto superano le immagini conservate.

Risoluzione dei problemi