Plugin DICOM
Afficher les images médicales avec DicomPlugin
Le plugin DICOM ajoute la visualisation d'images médicales à Doconut : les fichiers DICOM multi‑cadres s'affichent sous forme d'aperçu animé, de cadres individuels, ou les deux. DICOM est un format uniquement plugin — sans ce plugin (et sa capacité de licence), les fichiers .dcm ne peuvent pas être ouverts du tout.
Sur .NET Framework 4.7.2, les fichiers DICOM s'affichent complètement — pages, cadres et animation — mais les métadonnées techniques (les balises DICOM) ne sont pas disponibles.
Viewer.GetDicomMetadataAsyncrenvoie toujoursnull, et la requête de métadonnées du visualiseur (?token=…&meta=1surDocImage.axd) répond404, ainsi le visualiseur n'affiche aucun panneau de propriétés DICOM. UtilisezDoconut.NET8si votre application a besoin des balises.
| Surface | Quand l'utiliser |
|---|---|
Viewer with DicomConfig (C#) | Vous ouvrez des fichiers DICOM sur le serveur et choisissez comment leurs cadres sont présentés |
Le visualiseur (docViewer) sur DocImage.axd | Vous affichez l'étude sur votre page : animation et cadres |
Le plugin n'a aucun widget propre : les fichiers DICOM s'ouvrent dans le visualiseur standard. Avec le plugin de conversion également enregistré, les fichiers .dcm et .ima peuvent être convertis en Pdf, Png, Jpeg, Bmp, Tiff ou Gif ; cette conversion nécessite également la capacité Dicom.
Installer le package
Install-Package Doconut.NETFramework.DicomPour épingler le plugin à la version décrite dans cette documentation :
Install-Package Doconut.NETFramework.Dicom -Version 26.10.0Conservez le package DICOM à la même version que Doconut.NETFramework.
Le fichier de licence du plugin, Doconut.Viewer.Dicom.lic, se trouve dans le même dossier que Doconut.Viewer.lic ; il est lu conjointement avec la licence du visualiseur.
Enregistrer le plugin
Doconut.DoconutHost.Initialize(options =>
{
options.AddPlugin<Doconut.Plugins.Dicom.DicomPlugin>();
});Le plugin (Name: "Doconut DICOM Viewer") enregistre des visualiseurs pour les extensions .dcm et .ima, contrôlées par la capacité Dicom. Si la licence ne le permet pas, DoconutHost.Initialize lève une exception depuis 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.Dans System.Web, cela signifie que chaque requête renvoie un 500 vide, et la raison n'apparaît que dans le journal d'événements Windows (source ASP.NET). Une exception est levée en l'absence de licence, pour un fichier TRIAL hérité, une licence sans Dicom, et une licence payante utilisée en dehors de sa fenêtre de version. Les licences temporaires Démo/NFR sont acceptées. Voir Configuration de la licence.
Parce qu'aucun visualiseur intégré ne gère ces formats, l'ouverture d'un tel fichier échoue complètement si la capacité devient indisponible plus tard :
LicenseException: This document type requires the 'Dicom' plugin license.Licence & filigrane
| État de la licence | Démarrage | Sortie DICOM |
|---|---|---|
Licence payante accordant Dicom, dans sa fenêtre de version | Démarre | Rendu selon les règles normales de filigrane de page |
| Licence temporaire active (Démo/NFR) | Démarre | Rendu avec le filigrane d'évaluation |
Pas de licence, un fichier TRIAL hérité, une licence sans Dicom, ou une licence payante hors de sa fenêtre de version | Application_Start lève une exception ; chaque requête renvoie un 500 vide | — |
La décision de filigrane de page normale s'applique également à la sortie DICOM. Pour la sortie animée, chaque cadre GIF est estampillé, de sorte que le marquage reste visible pendant toute la lecture. Un DocOptions.Watermark personnalisé n'est utilisé que lorsque la licence autorise les filigranes personnalisés ; il ne peut pas remplacer un filigrane d'évaluation.
Utilisation depuis C#
var token = await viewer.OpenDocumentAsync(path, new DicomConfig
{
DisplayMode = DicomDisplayMode.AnimationAndFrames
});var metadata = await viewer.GetDicomMetadataAsync(token);
// Sur .NET Framework ceci est toujours null : le lecteur de métadonnées DICOM n'est pas disponible pour cela
// target. Pages, cadres et animation s'affichent normalement.La méthode existe dans ce package afin que le code partagé avec le package .NET 8 se compile, mais la lecture des balises DICOM nécessite un composant qui n’a pas de version .NET Framework. Concevez votre interface utilisateur sans elles — par exemple, masquez un panneau de métadonnées lorsque le résultat est null.
Modes d'affichage et résolution
Modes d'affichage
Les fichiers DICOM multi‑images peuvent être présentés de trois manières (DicomDisplayMode) :
| Mode | Pages générées | Utilisation |
|---|---|---|
AnimationOnly | Page 1 = GIF animé en boucle de toutes les images | Revue cinématographique rapide |
FramesOnly | Pages 1..N = un PNG statique par image | Navigation diagnostique image par image |
AnimationAndFrames (par défaut) | Page 1 = GIF animé, pages 2..N+1 = un PNG statique par image (N = nombre d'images) | Vue d'ensemble et détail dans un même document |
Le timing de l'animation est contrôlé par AnimationFrameDelayMs (par défaut 100 ms = 10 IPS ; le timing GIF utilise des unités de 10 ms) et LoopCount (0 = boucle infinie).
Le visualiseur découvre que la page 1 est animée en envoyant une requête HEAD pour celle‑ci. Le gestionnaire DocImage.axd doit donc accepter HEAD dans Web.config (verb="GET,HEAD,POST", voir Installation) ; sans cela, IIS répond 404 avant que Doconut ne s’exécute et la détection d'animation ne fonctionne jamais.
Résolution
DicomConfig rend à 100 DPI par axe par défaut. Si vous ne définissez pas explicitement HorizontalResolution/VerticalResolution, ils suivent BaseConfig.ImageResolution lorsqu'il est défini, et ce n'est qu'alors qu'ils reviennent à 100.
// Augmentation uniforme via la propriété de base…
new DicomConfig { ImageResolution = 150 };
// …ou contrôle par axe
new DicomConfig { HorizontalResolution = 200, VerticalResolution = 150 };Créez votre propre interface
Les images de page, y compris la première page animée, utilisent la route d'image standard DocImage.axd. La requête de métadonnées, GET /DocImage.axd?token=<token>&meta=1, renvoie 404 dans ce package pour chaque document, fichiers DICOM inclus, car le lecteur de métadonnées n'est pas disponible.
En production
Les études multi‑images peuvent produire à la fois une animation et une page statique par image. AnimationAndFrames offre la navigation la plus riche mais aussi le coût de rendu et de mémoire le plus élevé — et sur un serveur unique, cette mémoire appartient au processus de travail IIS. Pour les grandes études :
- utilisez
FramesOnlylorsque l'inspection des images compte plus que la lecture ; - évitez d'augmenter les deux axes de résolution sans mesurer la mémoire ;
- fermez explicitement la session lorsque l'étude n'est plus ouverte ;
- conservez
CachePagesactivé uniquement lorsque l'accès répété vaut les images conservées.
Placez Doconut.Viewer.Dicom.lic à côté de Doconut.Viewer.lic sur chaque serveur, et conservez HEAD dans la liste verb du gestionnaire.
Référence API
DicomConfig, DicomDisplayMode et DicomMetadata se trouvent dans l'espace de noms Doconut. DicomPlugin se trouve dans Doconut.Plugins.Dicom. Le tableau complet des propriétés DicomConfig se trouve dans Configurations de format.
DicomConfig
public sealed class DicomConfig : BaseConfig
{
public int HorizontalResolution { get; set; } // par défaut : ImageResolution lorsqu'il est défini, sinon 100
public int VerticalResolution { get; set; } // par défaut : ImageResolution lorsqu'il est défini, sinon 100
public int AnimationFrameDelayMs { get; set; } = 100;
public ushort LoopCount { get; set; } = 0; // 0 = boucle infinie
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);Retourne toujours null sur ce package. Lève InvalidOperationException lorsque le jeton est inconnu ou expiré. DicomMetadata est défini afin que le code partagé avec le package .NET 8 se compile.
Dépannage
| Symptôme | Cause | Solution |
|---|---|---|
Chaque requête renvoie un 500 vide après l'ajout du plugin ; le journal d'événements Windows (source ASP.NET) indique The Dicom plugin is registered via AddPlugin but no active license grants Dicom. | Pas de licence, un fichier TRIAL, une licence sans Dicom, ou une licence payante en dehors de sa fenêtre de version | Installez une licence qui accorde Dicom, ou supprimez AddPlugin<DicomPlugin>() |
L'ouverture d'un fichier .dcm lève Document format '.dcm' is not supported. | DicomPlugin n'est pas enregistré, ou son package n'est pas déployé | Ajoutez AddPlugin<DicomPlugin>() dans DoconutHost.Initialize et déployez le package |
L'ouverture d'un fichier .dcm lève LicenseException: This document type requires the 'Dicom' plugin license. | La licence chargée n'accorde plus Dicom | Installez une licence qui accorde Dicom |
| Une seule page apparaît | La source est à image unique, ou DisplayMode est AnimationOnly | Utilisez FramesOnly ou AnimationAndFrames pour une source multi-image |
| La page 1 ne s'anime pas | Le gestionnaire dans Web.config n'accepte pas HEAD | Utilisez verb="GET,HEAD,POST" |
| L'animation est trop rapide ou trop lente | AnimationFrameDelayMs est désactivé ; le timing GIF utilise des unités de 10 ms | Ajustez AnimationFrameDelayMs |
| La mémoire augmente avec les gros fichiers multi-image | Le mode d'affichage, la résolution et le cache de pages ajoutent tous des images retenues | Voir En production ; fermez les sessions explicitement |
Les métadonnées sont toujours null | Attendu sur ce package | Utilisez le package .NET 8 lorsque vous avez besoin des balises |
GetDicomMetadataAsync lève Document session not found. Please re-open document. | Le jeton a expiré ou n'a jamais été ouvert | Ouvrez à nouveau le document |
Notes du framework
Comparé aux packages ASP.NET Core, ce package diffère au niveau de l'hébergement et des métadonnées DICOM :
- Enregistrement se fait dans
Application_Start, viaDoconutHost.Initialize, au lieu debuilder.Services.AddDoconut. - Échecs de démarrage apparaissent comme un
500vide à chaque requête, la raison étant dans le journal d'événements Windows. - Détection d'animation nécessite
HEADdans la listeverbdu gestionnaireDocImage.axd. - Pas de métadonnées DICOM.
Viewer.GetDicomMetadataAsyncrenvoie toujoursnullet consigne un avertissement unique pour une session DICOM ; la requête de métadonnéesDocImage.axdrépond404, pas le501des packages .NET 6 et .NET Standard. - Windows uniquement, comme le reste du package .NET Framework.
Cette page était-elle utile ?