Πρόσθετο DICOM
Προβολή ιατρικών εικόνων με DicomPlugin
Το πρόσθετο DICOM προσθέτει προβολή ιατρικών εικόνων στο Doconut: τα αρχεία DICOM πολλαπλών πλαισίων αποδίδονται ως μια κινούμενη επισκόπηση, μεμονωμένα πλαίσια ή και τα δύο. Το DICOM είναι μορφή μόνο με πρόσθετο — χωρίς αυτό το πρόσθετο (και τη δυνατότητα άδειας), τα αρχεία .dcm δεν μπορούν να ανοιχτούν καθόλου.
| Περιβάλλον | Χρησιμοποιήστε το όταν |
|---|---|
Viewer with DicomConfig (C#) | Ανοίγετε αρχεία DICOM στον διακομιστή και επιλέγετε πώς θα παρουσιαστούν τα πλαίσια τους |
Ο προβολέας (docViewer) | Εμφανίζετε τη μελέτη στη σελίδα σας: κίνηση και πλαίσια |
Το πρόσθετο δεν έχει δικό του widget: τα αρχεία DICOM ανοίγουν στον κανονικό προβολέα. Με το Πρόσθετο μετατροπέα επίσης καταχωρημένο, τα αρχεία .dcm και .ima μπορούν να μετατραπούν σε Pdf, Png, Jpeg, Bmp, Tiff ή Gif· η μετατροπή αυτή απαιτεί επίσης τη δυνατότητα Dicom.
Εγκατάσταση του πακέτου
dotnet add package Doconut.NET6.DicomΗ εντολή χωρίς έκδοση εγκαθιστά την τελευταία σταθερή έκδοση. Για να κλειδώσετε το πρόσθετο στην έκδοση που περιγράφει αυτή η τεκμηρίωση, περάστε την έκδοση ξεχωριστά:
dotnet add package Doconut.NET6.Dicom --version 26.10.0Διατηρήστε το πακέτο DICOM στην ίδια έκδοση με το Doconut.NET6. Το αναγνωριστικό του πακέτου είναι Doconut.NET6.Dicom· το .<version> εμφανίζεται μόνο στο ληφθέν όνομα αρχείου .nupkg.
Το αρχείο άδειας του πρόσθετου, Doconut.Viewer.Dicom.lic, τοποθετείται στον ίδιο φάκελο με το Doconut.Viewer.lic· διαβάζεται μαζί με την άδεια του προβολέα.
Πλατφόρμες. Το πρόσθετο λειτουργεί όπου και το Doconut.NET6 λειτουργεί: Windows και Linux βασισμένο σε glibc σε x64 (όχι Alpine ή άλλες διανομές βασισμένες σε musl). Σε Linux, εγκαταστήστε τη βιβλιοθήκη διαμόρφωσης γραμματοσειρών πριν ανοίξει το πρώτο έγγραφο:
apt-get update && apt-get install -y libfontconfig1Σε διανομές RHEL, Fedora και παρόμοιες, το πακέτο είναι fontconfig. Χωρίς αυτό, το άνοιγμα ενός εγγράφου αποτυγχάνει με The system library libfontconfig1 is missing. Install it (Debian/Ubuntu: apt-get install -y libfontconfig1) and see the Linux section of the Doconut documentation.
Καταχώριση του πρόσθετου
builder.Services.AddDoconut(options =>
{
options.AddPlugin<Doconut.Plugins.Dicom.DicomPlugin>();
});Το πρόσθετο (Name: "Doconut DICOM Viewer") καταχωρεί προβολείς για τις επεκτάσεις .dcm και .ima, ελεγχόμενες από τη δυνατότητα Dicom. Χωρίς άδεια που το παρέχει, το AddDoconut() ρίχνει ένα InvalidOperationException κατά την εκκίνηση, πριν η εφαρμογή εξυπηρετήσει ένα αίτημα:
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. Δείτε το Ρύθμιση Άδειας για το πώς φορτώνονται οι άδειες.
Επειδή κανένας ενσωματωμένος προβολέας δεν διαχειρίζεται αυτές τις μορφές, η πύλη χρόνου εκτέλεσης επίσης αποτυγχάνει σκληρά εάν η δυνατότητα αργότερα καταστεί μη διαθέσιμη:
LicenseException: This document type requires the 'Dicom' plugin license.Άδειες & υδατογράφημα
| Κατάσταση άδειας | Έναρξη | Έξοδος DICOM |
|---|---|---|
Πληρωμένη άδεια που παρέχει Dicom, εντός του χρονικού πλαισίου της | Ξεκινά | Απεικονίζεται σύμφωνα με τους κανονικούς κανόνες υδατογραφήματος της σελίδας |
| Ενεργή προσωρινή (Demo/NFR) άδεια | Ξεκινά | Απεικονίζεται με το υδατογράφημα αξιολόγησης |
Χωρίς άδεια, παλιό αρχείο TRIAL, άδεια χωρίς Dicom, ή πληρωμένη άδεια εκτός του χρονικού πλαισίου της | AddDoconut() ρίχνει | — |
Η απόφαση για το κανονικό υδατογράφημα της σελίδας εφαρμόζεται επίσης στην έξοδο DICOM. Για την κινούμενη έξοδο, κάθε πλαίσιο GIF σφραγίζεται ώστε το σήμα να παραμένει ορατό κατά τη διάρκεια της αναπαραγωγής. Ένα προσαρμοσμένο DocOptions.Watermark χρησιμοποιείται μόνο όταν η διαδρομή άδειας επιτρέπει προσαρμοσμένα υδατογραφήματα· δεν μπορεί να αντικαταστήσει ένα υδατογράφημα αξιολόγησης.
Χρήση από C#
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 (default) | Σελίδα 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.
// Ομοιόμορφη ανάγλυφη μέσω της βασικής ιδιότητας…
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 | Ανάγνωση των τεχνικών μεταδεδομένων ενός ανοιχτού εγγράφου DICOM | 200 — 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
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
public enum DicomDisplayMode { AnimationOnly, FramesOnly, AnimationAndFrames }Viewer.GetDicomMetadataAsync
public Task<DicomMetadata?> GetDicomMetadataAsync(string token, CancellationToken ct = default);Επιστρέφει null όταν το έγγραφο δεν είναι αρχείο DICOM και πάντα επιστρέφει null σε αυτό το πακέτο. Εγείρει InvalidOperationException όταν το διακριτικό είναι άγνωστο ή έχει λήξει.
DicomMetadata
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" or "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 6· η απόδοση δεν επηρεάζεται | Χρησιμοποιήστε το πακέτο .NET 8 όταν χρειάζεστε τις ετικέτες |
GetDicomMetadataAsync προκαλεί Document session not found. Please re-open document. | Το διακριτικό έληξε ή δεν ανοίχθηκε ποτέ | Ανοίξτε ξανά το έγγραφο |
Σημειώσεις Πλαισίου
- Δεν υπάρχουν μεταδεδομένα DICOM. Η απόδοση σελίδων DICOM, τα μεμονωμένα καρέ, η κίνηση, οι μετασχηματισμοί και η προσθήκη υδατογραφήματος υποστηρίζονται. Τα τεχνικά μεταδεδομένα ετικετών δεν είναι διαθέσιμα στο πακέτο .NET 6 επειδή ο αναγνώστης μεταδεδομένων δεν έχει έκδοση .NET 6.
Viewer.GetDicomMetadataAsync(token)επομένως επιστρέφειnullγια συνεδρία DICOM και καταγράφει μια εφάπαξ προειδοποίηση. Η αντίστοιχη αίτηση?token=…&meta=1επιστρέφει HTTP501 Not Implementedμε τον σταθερό κωδικό σφάλματοςdicom_metadata_unsupported. Χρησιμοποιήστε το πακέτο .NET 8 όταν τα τεχνικά μεταδεδομένα DICOM είναι απαραίτητα.
Ήταν αυτή η σελίδα χρήσιμη;