DICOM‑plugin

DICOM‑pluginet lägger till visning av medicinska bilder i Doconut: flerbilds‑DICOM‑filer renderas som en animerad översikt, enskilda bildrutor eller båda. DICOM är ett endast‑plugin‑format — utan detta plugin (och dess licensfunktion) kan .dcm‑filer inte öppnas alls.

Installera paketet

dotnet add package Doconut.NET6.Dicom

Kommandot utan version installerar den senaste stabila versionen. För att låsa pluginet till den aktuella 26.7.0‑utgåvan, ange versionen separat:

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

Behåll DICOM‑paketet på samma version som Doconut.NET6. Paket‑ID:t är Doconut.NET6.Dicom; .26.7.0 visas endast i den nedladdade .nupkg‑filnamnet.

Registrera pluginet

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

Pluginet (Name: "Doconut DICOM Viewer") registrerar visare för .dcm‑ och .ima‑filändelser, styrda av Dicom‑kapaciteten. En saknad eller otillräcklig icke‑tillfällig rättighet misslyckas normalt under AddDoconut(). Eftersom ingen inbyggd visare hanterar dessa format misslyckas även körningsgrinden hårt om kapaciteten senare blir otillgänglig:

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

Öppna en DICOM‑fil

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

Visningslägen

Flerbilds‑DICOM‑filer kan presenteras på tre sätt (DicomDisplayMode):

Animeringstiden styrs av AnimationFrameDelayMs (standard 100 ms = 10 FPS; GIF‑granularitet är 10 ms‑enheter) och LoopCount (0 = loopa för alltid).

Upplösning

DicomConfig renderar med 100 DPI per axel som standard. Upplösningsegenskaperna har en återfallskedja som är bra att känna till: om du inte anger HorizontalResolution/VerticalResolution explicit, följer de BaseConfig.ImageResolution när den är konfigurerad, och faller först därefter tillbaka till 100.

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

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

Tillgänglighet för DICOM‑metadata i .NET 6

DICOM‑sidrendering, enskilda bildrutor, animation, transformationer och vattenstämpling stöds. Teknisk tagg‑metadata är inte tillgänglig i .NET 6‑paketet eftersom metadata‑läsaren saknar en .NET 6‑byggnad.

Viewer.GetDicomMetadataAsync(token) returnerar därför null för en DICOM‑session och loggar en engångsvarning. Den motsvarande ?token=…&meta‑middleware‑begäran returnerar HTTP 501 Not Implemented med den stabila felkoden dicom_metadata_unsupported. Använd .NET 8‑paketet när teknisk DICOM‑metadata är ett krav.

Fullständig konfigurationsreferens

Den kompletta DicomConfig‑egenskapstabellen finns i API‑referens → Format‑konfigurationer. Ett produktionsexempel från referensappens per‑filändelse‑växel:

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

Vattenstämpel och minnesbeteende

Det vanliga beslutet om sidvattensstämpel gäller även för DICOM‑utdata. För animerad utdata märks varje GIF‑bildruta så att märket förblir synligt under uppspelning. En anpassad DocOptions.Watermark används endast när licensvägen tillåter anpassade vattenstämplar; den kan inte ersätta en utvärderingsvattensstämpel.

Multiramstudier kan generera både en animation och en statisk sida per bildruta. AnimationAndFrames ger den rikaste navigeringen men har också den högsta renderings‑ och cachekostnaden. För stora studier:

• använd FramesOnly när bildrutinssökning är viktigare än filmisk uppspelning;
• undvik att öka båda upplösningsaxlarna utan att mäta minnet;
• stäng sessionen explicit när studien inte längre är öppen;
• behåll CachePages aktiverat endast när fördelarna med återkommande åtkomst överväger de behållna bilderna.

Felsökning