DICOM‑plugin

Visa medicinska bilder med DicomPlugin

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

På .NET Framework 4.7.2 renderas DICOM‑filer fullt ut — sidor, ramar och animation — men teknisk metadata (DICOM‑taggarna) är inte tillgänglig. Viewer.GetDicomMetadataAsync returnerar alltid null, och visningsprogrammets metadataförfrågan (?token=…&meta=1 på DocImage.axd) svarar 404, så visaren visar inget DICOM‑egenskapspanel. Använd Doconut.NET8 om din applikation behöver taggarna.

YtaAnvänd när
Viewer med DicomConfig (C#)Du öppnar DICOM‑filer på servern och väljer hur deras ramar ska presenteras
Visaren (docViewer) på DocImage.axdDu visar studien på din sida: animation och ramar

Pluginet har ingen egen widget: DICOM‑filer öppnas i den vanliga visaren. Med Converter plugin också registrerat kan .dcm‑ och .ima‑filer konverteras till Pdf, Png, Jpeg, Bmp, Tiff eller Gif; den konverteringen kräver även Dicom‑kapaciteten.

Installera paketet

powershell
Install-Package Doconut.NETFramework.Dicom

För att låsa pluginet till den version som denna dokumentation beskriver:

powershell
Install-Package Doconut.NETFramework.Dicom -Version 26.10.0

Behåll DICOM‑paketet på samma version som Doconut.NETFramework.

Pluginets licensfil, Doconut.Viewer.Dicom.lic, placeras i samma mapp som Doconut.Viewer.lic; den läses tillsammans med visarlicensen.

Registrera pluginet

csharp
Doconut.DoconutHost.Initialize(options =>
{
    options.AddPlugin<Doconut.Plugins.Dicom.DicomPlugin>();
});

Pluginet (Name: "Doconut DICOM Viewer") registrerar visare för .dcm‑ och .ima‑tillägg, styrda av Dicom‑kapaciteten. Om licensen inte ger detta, kastar DoconutHost.Initialize från Application_Start:

text
The Dicom plugin is registered via AddPlugin but no active license grants Dicom. Remove the AddPlugin<...>() call or install a license (or trial/demo) that includes Dicom.

I System.Web betyder det att varje begäran svarar med en tom 500, och orsaken finns bara i Windows‑händelseloggen (källa ASP.NET). Det kastas för ingen licens, en äldre TRIAL‑fil, en licens utan Dicom, och en betald licens som används utanför sitt versionsfönster. Tillfälliga Demo/NFR‑licenser accepteras. Se License Setup.

Eftersom ingen inbyggd visare hanterar dessa format misslyckas öppning av en sådan om kapaciteten senare blir otillgänglig:

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

Licensiering & vattenstämpel

LicensstatusUppstartDICOM‑utdata
Betald licens som ger Dicom, inom sitt versionsfönsterStartarRenderas enligt de vanliga sidvattenstämpelreglerna
Aktiv tillfällig (Demo/NFR) licensStartarRenderas med utvärderingsvattenstämpeln
Ingen licens, en äldre TRIAL‑fil, en licens utan Dicom, eller en betald licens utanför sitt versionsfönsterApplication_Start kastar; varje begäran svarar med en tom 500—

Den vanliga sidvattenstämpelbeslutet gäller även för DICOM‑utdata. För animerad utdata stämplas varje GIF‑ram, så märket förblir synligt under hela uppspelningen. En anpassad DocOptions.Watermark används endast när licensen tillåter anpassade vattenstämplar; den kan inte ersätta en utvärderingsvattenstämpel.

Användning i C#

csharp
var token = await viewer.OpenDocumentAsync(path, new DicomConfig
{
    DisplayMode = DicomDisplayMode.AnimationAndFrames
});
csharp
var metadata = await viewer.GetDicomMetadataAsync(token);
// På .NET Framework är detta alltid null: DICOM-metadata läsaren är inte tillgänglig för detta
// target. Pages, frames och animation renderas normalt.

Metoden finns i detta paket så att kod som delas med .NET 8‑paketet kompileras, men läsning av DICOM‑taggar kräver en komponent som inte har någon .NET Framework‑byggnad. Planera ditt användargränssnitt utan dem — till exempel, dölj en metadata‑panel när resultatet är null.

Visningslägen och upplösning

Visningslägen

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

LägeProducerade sidorAnvändning
AnimationOnlySida 1 = animerad GIF som loopar alla ramarSnabb filmisk granskning
FramesOnlySidor 1..N = en statisk PNG per ramRam‑för‑ram diagnostisk navigering
AnimationAndFrames (standard)Sida 1 = animerad GIF, sidor 2..N+1 = en statisk PNG per ram (N = antalet ramar)Översikt och detaljer i ett dokument

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

Visaren upptäcker att sida 1 är animerad genom att skicka en HEAD‑förfrågan för den. DocImage.axd‑hanteraren måste därför acceptera HEAD i Web.config (verb="GET,HEAD,POST", se Installation); utan den svarar IIS med 404 innan Doconut körs och animeringsdetektering fungerar aldrig.

Upplösning

DicomConfig renderar med 100 DPI per axel som standard. Om du inte anger HorizontalResolution/VerticalResolution explicit, följer de BaseConfig.ImageResolution när den är satt, och faller först tillbaka till 100.

csharp
// Enhetlig bump via basegenskapen…
new DicomConfig { ImageResolution = 150 };

// …eller per‑axelkontroll
new DicomConfig { HorizontalResolution = 200, VerticalResolution = 150 };

Bygg ditt eget användargränssnitt

Sidsbilder, inklusive den animerade första sidan, använder den standard DocImage.axd bildrutten. Metadatabegäran, GET /DocImage.axd?token=<token>&meta=1, svarar med 404 i detta paket för varje dokument, inklusive DICOM‑filer, eftersom metadata‑läsaren inte är tillgänglig.

I produktion

Multi‑frame‑studier kan producera både en animation och en statisk sida per ram. AnimationAndFrames ger den rikaste navigeringen men också den högsta renderings‑ och minneskostnaden — och på en enskild server tillhör det minnet IIS‑arbetsprocessen. För stora studier:

  • använd FramesOnly när ram‑inspektion är viktigare än 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;
  • håll CachePages på endast när återkommande åtkomst är värd de behållna bilderna.

Placera Doconut.Viewer.Dicom.lic bredvid Doconut.Viewer.lic på varje server, och håll HEAD i hanterarens verb‑lista.

API‑referens

DicomConfig, DicomDisplayMode och DicomMetadata finns i Doconut‑namnutrymmet. DicomPlugin finns i Doconut.Plugins.Dicom. Den kompletta DicomConfig‑egenskapstabellen finns i Formatkonfigurationer.

DicomConfig

csharp
public sealed class DicomConfig : BaseConfig
{
    public int HorizontalResolution { get; set; }   // standard: ImageResolution när den är satt, annars 100
    public int VerticalResolution { get; set; }     // standard: ImageResolution när den är satt, annars 100
    public int AnimationFrameDelayMs { get; set; } = 100;
    public ushort LoopCount { get; set; } = 0;      // 0 = loopa för alltid
    public DicomDisplayMode DisplayMode { get; set; } = DicomDisplayMode.AnimationAndFrames;
}

DicomDisplayMode

csharp
public enum DicomDisplayMode { AnimationOnly, FramesOnly, AnimationAndFrames }

Viewer.GetDicomMetadataAsync

csharp
public Task<DicomMetadata?> GetDicomMetadataAsync(string token, CancellationToken ct = default);

Returnerar alltid null i detta paket. Kastar InvalidOperationException när token är okänd eller har gått ut. DicomMetadata är definierad så att kod som delas med .NET 8-paketet kompileras.

Felsökning

SymptomOrsakÅtgärd
Varje begäran svarar med en tom 500 efter att pluginet lagts till; Windows‑händelseloggen (källa ASP.NET) visar The Dicom plugin is registered via AddPlugin but no active license grants Dicom.Ingen licens, en TRIAL‑fil, en licens utan Dicom, eller en betald licens utanför dess versionsfönsterInstallera en licens som ger Dicom, eller ta bort AddPlugin<DicomPlugin>()
Öppning av en .dcm‑fil kastar Document format '.dcm' is not supported.DicomPlugin är inte registrerad, eller så är dess paket inte distribueratLägg till AddPlugin<DicomPlugin>() i DoconutHost.Initialize och distribuera paketet
Öppning av en .dcm‑fil kastar LicenseException: This document type requires the 'Dicom' plugin license.Den inlästa licensen ger inte längre DicomInstallera en licens som ger Dicom
Endast en sida visasKällan är enkelram, eller DisplayMode är AnimationOnlyAnvänd FramesOnly eller AnimationAndFrames för en flerramig källa
Sida 1 animeras inteHanteraren i Web.config accepterar inte HEADAnvänd verb="GET,HEAD,POST"
Animationen är för snabb eller för långsamAnimationFrameDelayMs är avstängd; GIF-timing använder 10 ms-enheterJustera AnimationFrameDelayMs
Minnet växer på stora flerramiga filerVisningsläge, upplösning och sidcache lägger alla till behållna bilderSe I produktion; stäng sessioner explicit
Metadata är alltid nullFörväntas i detta paketAnvänd .NET 8-paketet när du behöver taggarna
GetDicomMetadataAsync kastar Document session not found. Please re-open document.Token har gått ut eller öppnades aldrigÖppna dokumentet igen

Ramanteckningar

  • Registrering är i Application_Start, via DoconutHost.Initialize, istället för builder.Services.AddDoconut.
  • Startfel visas som en tom 500 på varje begäran, med orsaken i Windows‑händelseloggen.
  • Detektering av animation kräver HEAD i DocImage.axd‑hanterarens verb‑lista.
  • Ingen DICOM‑metadata. Viewer.GetDicomMetadataAsync returnerar alltid null och loggar en engångsvarning för en DICOM‑session; DocImage.axd‑metadataförfrågan svarar 404, inte 501 i .NET 6‑ och .NET Standard‑paketen.
  • Endast Windows, precis som resten av .NET Framework‑paketet.

Var den här sidan hjälpsam?