Πρόσθετο DICOM

Προβολή ιατρικών εικόνων με DicomPlugin

Το πρόσθετο DICOM προσθέτει προβολή ιατρικών εικόνων στο Doconut: τα αρχεία DICOM πολλαπλών καρέ αποδίδονται ως μια κινούμενη επισκόπηση, μεμονωμένα καρέ ή και τα δύο. Το DICOM είναι μια μορφή μόνο-πρόσθετου — χωρίς αυτό το πρόσθετο (και τη δυνατότητα άδειας χρήσης του), .dcm αρχεία δεν μπορούν να ανοιχτούν καθόλου.

Στο .NET Framework 4.7.2, τα αρχεία DICOM αποδίδονται πλήρως — σελίδες, καρέ και animation — αλλά τα τεχνικά μεταδεδομένα (οι ετικέτες DICOM) δεν είναι διαθέσιμα. Viewer.GetDicomMetadataAsync πάντα επιστρέφει null, και το αίτημα μεταδεδομένων του προβολέα (?token=…&meta=1 στο DocImage.axd) απαντά 404, έτσι ο προβολέας δεν εμφανίζει κανένα πάνελ ιδιοτήτων DICOM. Χρησιμοποιήστε Doconut.NET8 εάν η εφαρμογή σας χρειάζεται τις ετικέτες.

ΠεριβάλλονΧρησιμοποιήστε το όταν
Viewer με DicomConfig (C#)Ανοίγετε αρχεία DICOM στον διακομιστή και επιλέγετε πώς θα παρουσιαστούν τα καρέ τους
Ο προβολέας (docViewer) στο DocImage.axdΕμφανίζετε τη μελέτη στη σελίδα σας: animation και καρέ

Το πρόσθετο δεν έχει δικό του widget: τα αρχεία DICOM ανοίγουν στον κανονικό προβολέα. Με το Converter plugin επίσης καταχωρημένο, τα αρχεία .dcm και .ima μπορούν να μετατραπούν σε Pdf, Png, Jpeg, Bmp, Tiff ή Gif· η μετατροπή αυτή απαιτεί επίσης τη δυνατότητα Dicom.

Εγκατάσταση του πακέτου

powershell
Install-Package Doconut.NETFramework.Dicom

Για να συνδέσετε το πρόσθετο στην έκδοση που περιγράφει αυτή η τεκμηρίωση:

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

Διατηρήστε το πακέτο DICOM στην ίδια έκδοση με το Doconut.NETFramework.

Το αρχείο άδειας του πρόσθετου, Doconut.Viewer.Dicom.lic, τοποθετείται στον ίδιο φάκελο με το Doconut.Viewer.lic· διαβάζεται μαζί με την άδεια του προβολέα.

Καταχώρηση του πρόσθετου

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

Το πρόσθετο (Name: "Doconut DICOM Viewer") καταχωρεί προβολείς για τις επεκτάσεις .dcm και .ima, περιορισμένες από τη δυνατότητα Dicom. Εάν η άδεια δεν το παρέχει, DoconutHost.Initialize ρίχνει από 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.

Στο System.Web αυτό σημαίνει ότι κάθε αίτημα απαντά με ένα κενό 500, και ο λόγος εμφανίζεται μόνο στο αρχείο καταγραφής συμβάντων των Windows (πηγή ASP.NET). Ρίχνει σφάλμα για έλλειψη άδειας, ένα παλιό αρχείο TRIAL, άδεια χωρίς Dicom, και μια πληρωμένη άδεια που χρησιμοποιείται εκτός του χρονικού παραθύρου έκδοσής της. Δέχονται προσωρινές άδειες Demo/NFR. Δείτε το License Setup.

Επειδή κανένας ενσωματωμένος προβολέας δεν διαχειρίζεται αυτές τις μορφές, το άνοιγμα ενός αποτυγχάνει εντελώς εάν η δυνατότητα αργότερα καταστεί μη διαθέσιμη:

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

Άδεια & υδατογράφημα

Κατάσταση άδειαςΈναρξηΈξοδος DICOM
Πληρωμένη άδεια που παρέχει Dicom, εντός του χρονικού παραθύρου έκδοσής τηςΞεκινάΑπεικονίζεται σύμφωνα με τους κανονικούς κανόνες υδατογραφήματος σελίδας
Ενεργή Προσωρινή (Demo/NFR) άδειαΞεκινάΑπεικονίζεται με το υδατογράφημα αξιολόγησης
Χωρίς άδεια, ένα παλιό αρχείο TRIAL, άδεια χωρίς Dicom, ή πληρωμένη άδεια εκτός του χρονικού παραθύρου έκδοσής τηςApplication_Start ρίχνει σφάλμα· κάθε αίτημα απαντά με ένα κενό 500—

Η απόφαση για το κανονικό υδατογράφημα σελίδας ισχύει επίσης για την έξοδο DICOM. Για την κινούμενη έξοδο, κάθε καρέ GIF σφραγίζεται, ώστε το σήμα να παραμένει ορατό κατά τη διάρκεια της αναπαραγωγής. Ένα προσαρμοσμένο DocOptions.Watermark χρησιμοποιείται μόνο όταν η άδεια επιτρέπει προσαρμοσμένα υδατογραφήματα· δεν μπορεί να αντικαταστήσει ένα υδατογράφημα αξιολόγησης.

Χρήση από C#

csharp
var token = await viewer.OpenDocumentAsync(path, new DicomConfig
{
    DisplayMode = DicomDisplayMode.AnimationAndFrames
});
csharp
var metadata = await viewer.GetDicomMetadataAsync(token);
// Στο .NET Framework αυτό είναι πάντα null: ο αναγνώστης μεταδεδομένων DICOM δεν είναι διαθέσιμος για αυτό
// target. Οι σελίδες, τα πλαίσια και η animation αποδίδονται κανονικά.

Η μέθοδος υπάρχει σε αυτό το πακέτο ώστε ο κώδικας που μοιράζεται με το πακέτο .NET 8 να μεταγλωττίζεται, αλλά η ανάγνωση ετικετών DICOM απαιτεί ένα στοιχείο που δεν έχει έκδοση για .NET Framework. Σχεδιάστε τη διεπαφή χρήστη χωρίς αυτά — για παράδειγμα, κρύψτε ένα πάνελ μεταδεδομένων όταν το αποτέλεσμα είναι null.

Λειτουργίες εμφάνισης και ανάλυση

Λειτουργίες εμφάνισης

Τα αρχεία DICOM πολλαπλών καρέ μπορούν να παρουσιαστούν με τρεις τρόπους (DicomDisplayMode):

ΛειτουργίαΣελίδες που παράγονταιΧρήση για
AnimationOnlyΣελίδα 1 = animated GIF που επαναλαμβάνει όλα τα καρέΓρήγορη κινηματογραφική επισκόπηση
FramesOnlyΣελίδες 1..N = ένα στατικό PNG ανά καρέΔιάγνωση πλοήγησης καρέ‑καρέ
AnimationAndFrames (προεπιλογή)Σελίδα 1 = animated GIF, σελίδες 2..N+1 = ένα στατικό PNG ανά καρέ (N = αριθμός καρέ)Επισκόπηση και λεπτομέρειες σε ένα έγγραφο

Ο χρόνος animation ελέγχεται από AnimationFrameDelayMs (προεπιλογή 100 ms = 10 FPS· ο χρόνος GIF χρησιμοποιεί μονάδες 10 ms) και LoopCount (0 = αέναος βρόχος).

Ο προβολέας διαπιστώνει ότι η σελίδα 1 είναι animated στέλνοντας ένα αίτημα HEAD για αυτήν. Ο χειριστής DocImage.axd πρέπει επομένως να δέχεται HEAD στο Web.config (verb="GET,HEAD,POST", δείτε Εγκατάσταση); χωρίς αυτό, το IIS απαντά 404 πριν εκτελεστεί το Doconut και η ανίχνευση animation δεν λειτουργεί ποτέ.

Ανάλυση

DicomConfig αποδίδει σε 100 DPI ανά άξονα από προεπιλογή. Εάν δεν ορίσετε ρητά HorizontalResolution/VerticalResolution, ακολουθούν το BaseConfig.ImageResolution όταν αυτό έχει οριστεί, και μόνο τότε επιστρέφουν στα 100.

csharp
// Ομοιόμορφη αύξηση μέσω της ιδιότητας base…
new DicomConfig { ImageResolution = 150 };

// …ή έλεγχος ανά‑άξονα
new DicomConfig { HorizontalResolution = 200, VerticalResolution = 150 };

Δημιουργήστε το δικό σας περιβάλλον χρήστη

Οι εικόνες σελίδων, συμπεριλαμβανομένης της animated πρώτης σελίδας, χρησιμοποιούν τη στάνταρδ διαδρομή εικόνας DocImage.axd. Το αίτημα μεταδεδομένων, GET /DocImage.axd?token=<token>&meta=1, απαντά 404 σε αυτό το πακέτο για κάθε έγγραφο, συμπεριλαμβανομένων των αρχείων DICOM, επειδή ο αναγνώστης μεταδεδομένων δεν είναι διαθέσιμος.

Σε παραγωγή

Οι μελέτες πολλαπλών καρέ μπορούν να παράγουν τόσο ένα animation όσο και μια στατική σελίδα ανά καρέ. AnimationAndFrames παρέχει την πιο πλούσια πλοήγηση αλλά και το υψηλότερο κόστος απόδοσης και μνήμης — και σε έναν μοναδικό διακομιστή αυτή η μνήμη ανήκει στη διεργασία εργαζόμενου IIS. Για μεγάλες μελέτες:

  • χρησιμοποιήστε FramesOnly όταν η επιθεώρηση καρέ είναι πιο σημαντική από την αναπαραγωγή·
  • αποφύγετε την αύξηση και των δύο αξόνων ανάλυσης χωρίς μέτρηση μνήμης·
  • κλείστε τη συνεδρία ρητά όταν η μελέτη δεν είναι πλέον ανοιχτή·
  • διατηρήστε το CachePages ενεργό μόνο όταν η επαναλαμβανόμενη πρόσβαση αξίζει τις διατηρημένες εικόνες.

Τοποθετήστε το Doconut.Viewer.Dicom.lic δίπλα στο Doconut.Viewer.lic σε κάθε διακομιστή, και διατηρήστε το HEAD στη λίστα verb του χειριστή.

Αναφορά API

DicomConfig, DicomDisplayMode και DicomMetadata βρίσκονται στον χώρο ονομάτων Doconut. DicomPlugin βρίσκεται στο Doconut.Plugins.Dicom. Ο πλήρης πίνακας ιδιοτήτων DicomConfig βρίσκεται στο Διαμορφώσεις Μορφής.

DicomConfig

csharp
public sealed class DicomConfig : BaseConfig
{
    public int HorizontalResolution { get; set; }   // προεπιλογή: ImageResolution όταν ορίζεται, αλλιώς 100
    public int VerticalResolution { get; set; }     // προεπιλογή: ImageResolution όταν ορίζεται, αλλιώς 100
    public int AnimationFrameDelayMs { get; set; } = 100;
    public ushort LoopCount { get; set; } = 0;      // 0 = επανάληψη για πάντα
    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);

Πάντα επιστρέφει null σε αυτό το πακέτο. Ρίχνει InvalidOperationException όταν το διακριτικό είναι άγνωστο ή έχει λήξει. Το DicomMetadata ορίζεται ώστε ο κώδικας που μοιράζεται με το πακέτο .NET 8 να μεταγλωττίζεται.

Troubleshooting

ΣύμπτωμαΑιτίαΔιόρθωση
Κάθε αίτηση απαντά με ένα κενό 500 μετά την προσθήκη του plugin· το ημερολόγιο συμβάντων των Windows (πηγή ASP.NET) εμφανίζει The Dicom plugin is registered via AddPlugin but no active license grants Dicom.Καμία άδεια, ένα αρχείο TRIAL, άδεια χωρίς Dicom, ή πληρωμένη άδεια εκτός του παραθύρου έκδοσής τηςΕγκαταστήστε μια άδεια που παρέχει Dicom, ή αφαιρέστε AddPlugin<DicomPlugin>()
Το άνοιγμα ενός αρχείου .dcm προκαλεί Document format '.dcm' is not supported.Το DicomPlugin δεν είναι καταχωρημένο, ή το πακέτο του δεν έχει αναπτυχθείΠροσθέστε AddPlugin<DicomPlugin>() στο DoconutHost.Initialize και αναπτύξτε το πακέτο
Το άνοιγμα ενός αρχείου .dcm προκαλεί LicenseException: This document type requires the 'Dicom' plugin license.Η φορτωμένη άδεια δεν παρέχει πλέον DicomΕγκαταστήστε μια άδεια που παρέχει Dicom
Εμφανίζεται μόνο μία σελίδαΗ πηγή είναι μονοκαρέ, ή το DisplayMode είναι AnimationOnlyΧρησιμοποιήστε FramesOnly ή AnimationAndFrames για πηγή πολλαπλών καρέ
Η σελίδα 1 δεν κινείταιΟ χειριστής στο Web.config δεν δέχεται HEADΧρησιμοποιήστε verb="GET,HEAD,POST"
Η κίνηση είναι πολύ γρήγορη ή αργήΤο AnimationFrameDelayMs είναι απενεργοποιημένο· ο χρόνος GIF χρησιμοποιεί μονάδες 10 msΡυθμίστε το AnimationFrameDelayMs
Η μνήμη αυξάνεται σε μεγάλα αρχεία πολλαπλών καρέΗ λειτουργία εμφάνισης, η ανάλυση και η προσωρινή μνήμη σελίδων προσθέτουν όλες εικόνες που διατηρούνταιΔείτε Σε παραγωγή; κλείστε τις συνεδρίες ρητά
Τα μεταδεδομένα είναι πάντα nullΑναμένεται σε αυτό το πακέτοΧρησιμοποιήστε το πακέτο .NET 8 όταν χρειάζεστε τις ετικέτες
GetDicomMetadataAsync προκαλεί Document session not found. Please re-open document.Το διακριτικό έληξε ή δεν ανοίχτηκε ποτέΑνοίξτε ξανά το έγγραφο

Σημειώσεις πλαισίου

Σε σύγκριση με τα πακέτα ASP.NET Core, αυτό το πακέτο διαφέρει στη φιλοξενία και στα μεταδεδομένα DICOM:

  • Καταχώρηση είναι στο Application_Start, μέσω DoconutHost.Initialize, αντί για builder.Services.AddDoconut.
  • Αποτυχίες εκκίνησης εμφανίζονται ως ένα κενό 500 σε κάθε αίτηση, με τον λόγο στο ημερολόγιο συμβάντων των Windows.
  • Ανίχνευση κίνησης χρειάζεται HEAD στη λίστα verb του χειριστή DocImage.axd.
  • Χωρίς μεταδεδομένα DICOM. Το Viewer.GetDicomMetadataAsync πάντα επιστρέφει null και καταγράφει μια εφάπαξ προειδοποίηση για μια συνεδρία DICOM· η αίτηση μεταδεδομένων DocImage.axd απαντά 404, όχι το 501 των πακέτων .NET 6 και .NET Standard.
  • Μόνο Windows, όπως και το υπόλοιπο του πακέτου .NET Framework.

Ήταν αυτή η σελίδα χρήσιμη;