Πρόσθετο DICOM

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

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

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

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

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

bash
dotnet add package Doconut.NETStandard.Dicom

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

bash
dotnet add package Doconut.NETStandard.Dicom --version 26.10.0

Διατηρήστε το πακέτο DICOM στην ίδια έκδοση με το Doconut.NETStandard. Το ID του πακέτου είναι Doconut.NETStandard.Dicom· .<version> εμφανίζεται μόνο στο ληφθέν όνομα αρχείου .nupkg.

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

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

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

Το πρόσθετο (Name: "Doconut DICOM Viewer") καταχωρεί προβολείς για τις επεκτάσεις .dcm και .ima, ελεγχόμενες από τη δυνατότητα Dicom. Χωρίς άδεια που το επιτρέπει, το AddDoconut() ρίχνει ένα InvalidOperationException κατά την εκκίνηση, πριν η εφαρμογή εξυπηρετήσει ένα αίτημα:

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.

Ρίχνει σφάλμα όταν δεν υπάρχει άδεια, όταν υπάρχει παλιό αρχείο TRIAL, όταν η άδεια δεν περιέχει Dicom, ή όταν μια πληρωμένη άδεια χρησιμοποιείται εκτός του χρονικού πλαισίου της. Δέχονται προσωρινές άδειες Demo/NFR. Δείτε το Ρύθμιση Άδειας για το πώς φορτώνονται οι άδειες.

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

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

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

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

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

Χρήση από C#

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

Viewer.GetDicomMetadataAsync(token) υπάρχει σε αυτό το πακέτο, αλλά επιστρέφει null για μια συνεδρία DICOM: δείτε τις Σημειώσεις πλαισίου.

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

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

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

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

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

Ανάλυση

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

csharp
// Ομοιόμορφη ανάγλυφη μέσω της ιδιότητας base…
new DicomConfig { ImageResolution = 150 };

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

Μεταδεδομένα

DicomMetadata περιέχει μόνο τεχνικές και απεικονιστικές ετικέτες — αριθμός καρέ, διαστάσεις, βάθος bit, φωτομετρική ερμηνεία, σύνταξη μεταφοράς, λειτουργία και το προεπιλεγμένο επίπεδο παραθύρου. Δεν περιέχει δεδομένα που να ταυτοποιούν ασθενή. Η πλήρης λίστα βρίσκεται στην αναφορά API. Σε αυτό το πακέτο τα μεταδεδομένα δεν είναι διαθέσιμα· δείτε τις σημειώσεις του πλαισίου.

Στον προβολέα

Ο προβολέας δεν χρειάζεται καμία ρύθμιση ειδική για DICOM. Όταν το ανοιχτό έγγραφο είναι αρχείο DICOM, ζητά τα μεταδεδομένα (?token=<token>&meta=1) και προσθέτει ένα κουμπί DICOM που ανοίγει ένα πάνελ τεχνικών ιδιοτήτων. Αν αυτή η αίτηση αποτύχει, το πάνελ παραμένει κρυφό και το έγγραφο εξακολουθεί να αποδίδεται. Σε αυτό το πακέτο η αίτηση επιστρέφει 501, έτσι το πάνελ δεν εμφανίζεται ποτέ.

Δημιουργήστε το δικό σας frontend

Τα μεταδεδομένα είναι διαθέσιμα μέσω HTTP στη διαδρομή όπου το UseDoconut() είναι προσαρτημένο (συνήθως /doconut), για οποιοδήποτε token ανοιχτού εγγράφου:

ΔιαδρομήΣκοπόςΑπάντηση επιτυχίας
GET ?token=<token>&meta=1Διαβάζει τα τεχνικά μεταδεδομένα ενός ανοιχτού εγγράφου DICOM200 — DicomMetadata ως JSON, με τα ονόματα ιδιοτήτων της αναφοράς API (Width, Height, NumberOfFrames, …)
ΚατάστασηΠότεΣώμα
404Το έγγραφο δεν είναι αρχείο DICOMμόνο κατάσταση
501Το έγγραφο είναι αρχείο DICOM, αλλά αυτό το πακέτο δεν μπορεί να διαβάσει τις ετικέτες του{ "error": "dicom_metadata_unsupported", "message": "DICOM technical metadata is not supported on this package: the underlying medical-imaging engine has no build for this target framework. On this package it always returns null; use the .NET 8 package if you need it. DICOM rendering is unaffected." }
500Η ανάγνωση των μεταδεδομένων απέτυχε{ "error": "metadata failed" }

Οι εικόνες σελίδων, συμπεριλαμβανομένης της κινούμενης πρώτης σελίδας, χρησιμοποιούν τη στάνταρ διαδρομή εικόνας του προβολέα.

Σε παραγωγή

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

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

Τοποθετήστε το Doconut.Viewer.Dicom.lic δίπλα στο Doconut.Viewer.lic σε κάθε διακομιστή.

Αναφορά 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 όταν το έγγραφο δεν είναι αρχείο DICOM και πάντα επιστρέφει null σε αυτό το πακέτο. Εγείρει InvalidOperationException όταν το διακριτικό είναι άγνωστο ή έχει λήξει.

DicomMetadata

csharp
public sealed class DicomMetadata
{
    public int Width { get; init; }
    public int Height { get; init; }
    public int NumberOfFrames { get; init; }
    public int BitsAllocated { get; init; }
    public int BitsStored { get; init; }
    public int SamplesPerPixel { get; init; }
    public string? PhotometricInterpretation { get; init; }
    public string? PixelRepresentation { get; init; }   // "Unsigned" ή "Signed"
    public string? PlanarConfiguration { get; init; }
    public string? TransferSyntax { get; init; }
    public string? Modality { get; init; }              // null όταν δεν εκτίθεται
    public double? WindowCenter { get; init; }
    public double? WindowWidth { get; init; }
    public bool IsColor { get; init; }
}

Αντιμετώπιση προβλημάτων

ΣύμπτωμαΑιτίαΔιόρθωση
AddDoconut() εγείρει 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>() μέσα στο AddDoconut() και αναπτύξτε το πακέτο
Το άνοιγμα ενός αρχείου .dcm εγείρει LicenseException: This document type requires the 'Dicom' plugin license.Η φορτωμένη άδεια δεν παρέχει πλέον DicomΕγκαταστήστε μια άδεια που παρέχει Dicom
Εμφανίζεται μόνο μία σελίδαΗ πηγή είναι μονοκαρέ, ή DisplayMode είναι AnimationOnlyΧρησιμοποιήστε FramesOnly ή AnimationAndFrames για πηγή πολλαπλών καρέ
Η κίνηση είναι πολύ γρήγορη ή αργήAnimationFrameDelayMs είναι απενεργοποιημένο· ο αποτελεσματικός χρονισμός GIF χρησιμοποιεί μονάδες 10 msΡυθμίστε AnimationFrameDelayMs
Η μνήμη αυξάνεται σε μεγάλα αρχεία πολλαπλών καρέΗ λειτουργία εμφάνισης, η ανάλυση και η προσωρινή μνήμη σελίδων προσθέτουν όλες εικόνες που διατηρούνταιΔείτε Σε παραγωγή; κλείστε τις συνεδρίες ρητά
Τα μεταδεδομένα είναι nullΤο έγγραφο δεν είναι αρχείο DICOMΕλέγξτε τον τύπο αρχείου πριν ζητήσετε μεταδεδομένα
Τα μεταδεδομένα είναι null για αρχείο DICOM, ή &meta επιστρέφει 501Αναμενόμενος περιορισμός αυτού του πακέτου· η απόδοση δεν επηρεάζεταιΧρησιμοποιήστε το πακέτο .NET 8 όταν χρειάζεστε τις ετικέτες
GetDicomMetadataAsync εγείρει Document session not found. Please re-open document.Το διακριτικό έληξε ή δεν ανοίχθηκε ποτέΑνοίξτε ξανά το έγγραφο

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

  • Χωρίς μεταδεδομένα DICOM. Η απόδοση σελίδων DICOM, τα μεμονωμένα καρέ, η κίνηση, οι μετασχηματισμοί και η προσθήκη υδατογραφήματος υποστηρίζονται. Τα τεχνικά μεταδεδομένα ετικετών δεν είναι διαθέσιμα στο πακέτο .NET Standard επειδή ο αναγνώστης μεταδεδομένων παρέχεται μόνο σε έκδοση .NET 8. Το Viewer.GetDicomMetadataAsync(token) επομένως επιστρέφει null για μια συνεδρία DICOM και καταγράφει μια μοναδική προειδοποίηση. Η αντίστοιχη αίτηση ?token=…&meta=1 επιστρέφει HTTP 501 Not Implemented με τον σταθερό κωδικό σφάλματος dicom_metadata_unsupported. Χρησιμοποιήστε το πακέτο .NET 8 όταν τα τεχνικά μεταδεδομένα DICOM είναι απαραίτητα.
  • Μόνο Windows, όπως και το υπόλοιπο του πακέτου .NET Standard.

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