DICOM-plugin

DICOM‑pluginet lägger till visning av medicinska bilder i Doconut: flermåls‑DICOM‑filer renderas som en animerad översikt, enskilda ramar 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.NET8.Dicom

Det oversionsspecifika kommandot installerar den senaste stabila versionen. För att låsa pluginet till den aktuella versionen 26.7.0, ange versionen separat:

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

Behåll DICOM‑paketet på samma version som Doconut.NET8. Paket‑ID:t är Doconut.NET8.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örningens gate 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

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

Animationstiden 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 };

Läsa DICOM-metadata

För sessioner som öppnas via detta plugin, exponerar Viewer tagg‑metadata:

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

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 sidvattenstämpel gäller även för DICOM‑utdata. För animerad utdata märks varje GIF‑ram så att vattenstämpeln förblir synlig under hela uppspelningen. En anpassad DocOptions.Watermark används endast när licensvägen tillåter anpassade vattenstämplar; den kan inte ersätta en utvärderingsvattenstämpel.

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

• använd FramesOnly när ram‑inspektion ä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