DICOM-Plugin

Das DICOM‑Plugin fügt Doconut die Anzeige medizinischer Bilder hinzu: Mehrframe‑DICOM‑Dateien werden als animierte Übersicht, einzelne Frames oder beides dargestellt. DICOM ist ein nur‑Plugin‑Format — ohne dieses Plugin (und dessen Lizenz‑Fähigkeit) können .dcm‑Dateien überhaupt nicht geöffnet werden.

Paket installieren

dotnet add package Doconut.NET8.Dicom

Der unveröffentlichte Befehl installiert die neueste stabile Version. Um das Plugin auf die aktuelle Version 26.7.0 zu fixieren, übergeben Sie die Version separat:

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

Halten Sie das DICOM‑Paket in derselben Version wie Doconut.NET8. Die Paket‑ID ist Doconut.NET8.Dicom; .26.7.0 erscheint nur im heruntergeladenen .nupkg‑Dateinamen.

Plugin registrieren

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

Das Plugin (Name: "Doconut DICOM Viewer") registriert Viewer für die .dcm‑ und .ima‑Erweiterungen, gesteuert durch die Dicom‑Fähigkeit. Ein fehlendes oder unzureichendes nicht‑temporäres Entitlement führt normalerweise während AddDoconut() zu einem Fehler. Da kein integrierter Viewer diese Formate unterstützt, schlägt das Laufzeit‑Gate ebenfalls hart fehl, wenn die Fähigkeit später nicht mehr verfügbar ist:

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

DICOM‑Datei öffnen

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

Anzeigemodi

Mehrframe‑DICOM‑Dateien können auf drei Arten präsentiert werden (DicomDisplayMode):

Die Animationsgeschwindigkeit wird durch AnimationFrameDelayMs (Standard 100 ms = 10 FPS; GIF‑Granularität ist 10 ms‑Einheiten) und LoopCount (0 = endlos wiederholen) gesteuert.

Auflösung

DicomConfig rendert standardmäßig mit 100 DPI pro Achse. Die Auflösungseigenschaften besitzen eine Fallback‑Kette, die es zu kennen gilt: Wenn Sie HorizontalResolution/VerticalResolution nicht explizit setzen, übernehmen sie BaseConfig.ImageResolution, sofern diese konfiguriert ist, und fallen erst danach auf 100 zurück.

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

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

DICOM‑Metadaten lesen

Für über dieses Plugin geöffnete Sitzungen stellt Viewer die Tag‑Metadaten bereit:

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

Vollständige Konfigurationsreferenz

Die vollständige DicomConfig‑Eigenschaftstabelle befindet sich in API Reference → Format Configs. Ein Produktionsbeispiel aus dem Referenz‑App‑Switch pro Erweiterung:

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

Wasserzeichen und Speicherverhalten

Die übliche Entscheidung zum Seiten‑Wasserzeichen gilt ebenfalls für DICOM‑Ausgaben. Für animierte Ausgaben wird jedes GIF‑Frame versehen, sodass das Wasserzeichen während der Wiedergabe sichtbar bleibt. Ein benutzerdefiniertes DocOptions.Watermark wird nur verwendet, wenn der Lizenzpfad benutzerdefinierte Wasserzeichen zulässt; es kann ein Evaluations‑Wasserzeichen nicht ersetzen.

Multiframe‑Studien können sowohl eine Animation als auch eine statische Seite pro Frame erzeugen. AnimationAndFrames bietet die umfangreichste Navigation, verursacht jedoch die höchsten Render‑ und Cache‑Kosten. Für große Studien:

• Verwenden Sie FramesOnly, wenn die Frame‑Inspektion wichtiger ist als die filmische Wiedergabe;
• Vermeiden Sie das Erhöhen beider Auflösungsachsen, ohne den Speicherverbrauch zu messen;
• Schließen Sie die Sitzung explizit, wenn die Studie nicht mehr geöffnet ist;
• Aktivieren Sie CachePages nur, wenn der Nutzen wiederholter Zugriffe die gespeicherten Bilder überwiegt.

Fehlersuche