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.GetDicomMetadataAsyncreturnerar alltidnull, och visningsprogrammets metadataförfrågan (?token=…&meta=1påDocImage.axd) svarar404, så visaren visar inget DICOM‑egenskapspanel. AnvändDoconut.NET8om din applikation behöver taggarna.
| Yta | Anvä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.axd | Du 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
Install-Package Doconut.NETFramework.DicomFör att låsa pluginet till den version som denna dokumentation beskriver:
Install-Package Doconut.NETFramework.Dicom -Version 26.10.0Behå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
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:
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:
LicenseException: This document type requires the 'Dicom' plugin license.Licensiering & vattenstämpel
| Licensstatus | Uppstart | DICOM‑utdata |
|---|---|---|
Betald licens som ger Dicom, inom sitt versionsfönster | Startar | Renderas enligt de vanliga sidvattenstämpelreglerna |
| Aktiv tillfällig (Demo/NFR) licens | Startar | Renderas med utvärderingsvattenstämpeln |
Ingen licens, en äldre TRIAL‑fil, en licens utan Dicom, eller en betald licens utanför sitt versionsfönster | Application_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#
var token = await viewer.OpenDocumentAsync(path, new DicomConfig
{
DisplayMode = DicomDisplayMode.AnimationAndFrames
});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äge | Producerade sidor | Användning |
|---|---|---|
AnimationOnly | Sida 1 = animerad GIF som loopar alla ramar | Snabb filmisk granskning |
FramesOnly | Sidor 1..N = en statisk PNG per ram | Ram‑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.
// 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
FramesOnlynä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
CachePagespå 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
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
public enum DicomDisplayMode { AnimationOnly, FramesOnly, AnimationAndFrames }Viewer.GetDicomMetadataAsync
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
| Symptom | Orsak | Å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önster | Installera 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 distribuerat | Lä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 Dicom | Installera en licens som ger Dicom |
| Endast en sida visas | Källan är enkelram, eller DisplayMode är AnimationOnly | Använd FramesOnly eller AnimationAndFrames för en flerramig källa |
| Sida 1 animeras inte | Hanteraren i Web.config accepterar inte HEAD | Använd verb="GET,HEAD,POST" |
| Animationen är för snabb eller för långsam | AnimationFrameDelayMs är avstängd; GIF-timing använder 10 ms-enheter | Justera AnimationFrameDelayMs |
| Minnet växer på stora flerramiga filer | Visningsläge, upplösning och sidcache lägger alla till behållna bilder | Se I produktion; stäng sessioner explicit |
Metadata är alltid null | Förväntas i detta paket | Anvä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, viaDoconutHost.Initialize, istället förbuilder.Services.AddDoconut. - Startfel visas som en tom
500på varje begäran, med orsaken i Windows‑händelseloggen. - Detektering av animation kräver
HEADiDocImage.axd‑hanterarensverb‑lista. - Ingen DICOM‑metadata.
Viewer.GetDicomMetadataAsyncreturnerar alltidnulloch loggar en engångsvarning för en DICOM‑session;DocImage.axd‑metadataförfrågan svarar404, inte501i .NET 6‑ och .NET Standard‑paketen. - Endast Windows, precis som resten av .NET Framework‑paketet.
Var den här sidan hjälpsam?