Plugin DICOM
Ver imágenes médicas con DicomPlugin
El plugin DICOM agrega visualización de imágenes médicas a Doconut: los archivos DICOM de varios fotogramas se renderizan como una vista animada, fotogramas individuales o ambos. DICOM es un formato solo de plugin — sin este plugin (y su capacidad de licencia), los archivos .dcm no pueden abrirse en absoluto.
En .NET Framework 4.7.2, los archivos DICOM se renderizan completamente — páginas, fotogramas y animación — pero los metadatos técnicos (las etiquetas DICOM) no están disponibles.
Viewer.GetDicomMetadataAsyncsiempre devuelvenull, y la solicitud de metadatos del visor (?token=…&meta=1enDocImage.axd) responde404, por lo que el visor no muestra el panel de propiedades DICOM. UseDoconut.NET8si su aplicación necesita las etiquetas.
| Superficie | Cuándo usarlo |
|---|---|
Viewer con DicomConfig (C#) | Abre archivos DICOM en el servidor y elige cómo se presentan sus fotogramas |
El visor (docViewer) en DocImage.axd | Muestra el estudio en su página: animación y fotogramas |
El plugin no tiene su propio widget: los archivos DICOM se abren en el visor normal. Con el Complemento Convertidor también registrado, los archivos .dcm y .ima pueden convertirse a Pdf, Png, Jpeg, Bmp, Tiff o Gif; esa conversión también necesita la capacidad Dicom.
Instalar el paquete
Install-Package Doconut.NETFramework.DicomPara fijar el plugin a la versión que describe esta documentación:
Install-Package Doconut.NETFramework.Dicom -Version 26.10.0Mantenga el paquete DICOM en la misma versión que Doconut.NETFramework.
El archivo de licencia del plugin, Doconut.Viewer.Dicom.lic, se coloca en la misma carpeta que Doconut.Viewer.lic; se lee junto con la licencia del visor.
Registrar el plugin
Doconut.DoconutHost.Initialize(options =>
{
options.AddPlugin<Doconut.Plugins.Dicom.DicomPlugin>();
});El plugin (Name: "Doconut DICOM Viewer") registra visores para las extensiones .dcm y .ima, controladas por la capacidad Dicom. Si la licencia no la concede, DoconutHost.Initialize lanza una excepción desde 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.En System.Web eso significa que cada solicitud responde con un 500 vacío, y la razón solo está en el registro de eventos de Windows (fuente ASP.NET). Lanza una excepción por falta de licencia, un archivo TRIAL heredado, una licencia sin Dicom, y una licencia paga usada fuera de su ventana de versión. Se aceptan licencias temporales Demo/NFR. Vea Configuración de Licencia.
Debido a que ningún visor incorporado maneja estos formatos, abrir uno falla directamente si la capacidad posteriormente no está disponible:
LicenseException: This document type requires the 'Dicom' plugin license.Licenciamiento y marca de agua
| Estado de licencia | Inicio | Salida DICOM |
|---|---|---|
Licencia paga que otorga Dicom, dentro de su ventana de versión | Inicia | Renderizado bajo las reglas normales de marca de agua de la página |
| Licencia Temporal activa (Demo/NFR) | Inicia | Renderizado con la marca de agua de evaluación |
Sin licencia, un archivo TRIAL heredado, una licencia sin Dicom, o una licencia paga fuera de su ventana de versión | Application_Start lanza; cada solicitud responde con un 500 vacío | — |
La decisión normal de marca de agua de la página también se aplica a la salida DICOM. Para la salida animada, cada fotograma GIF lleva la marca, de modo que la señal permanece visible durante la reproducción. Un DocOptions.Watermark personalizado se usa solo cuando la licencia permite marcas de agua personalizadas; no puede reemplazar una marca de agua de evaluación.
Uso desde C#
var token = await viewer.OpenDocumentAsync(path, new DicomConfig
{
DisplayMode = DicomDisplayMode.AnimationAndFrames
});var metadata = await viewer.GetDicomMetadataAsync(token);
// En .NET Framework esto siempre es null: el lector de metadatos DICOM no está disponible para esto
// target. Páginas, fotogramas y animación se renderizan normalmente.El método existe en este paquete para que el código compartido con el paquete .NET 8 compile, pero la lectura de etiquetas DICOM necesita un componente que no tiene una compilación para .NET Framework. Planifique su interfaz de usuario sin ellas — por ejemplo, oculte un panel de metadatos cuando el resultado sea null.
Modos de visualización y resolución
Modos de visualización
Los archivos DICOM de varios fotogramas pueden presentarse de tres maneras (DicomDisplayMode):
| Modo | Páginas generadas | Uso para |
|---|---|---|
AnimationOnly | Página 1 = GIF animado que reproduce todos los fotogramas en bucle | Revisión cinematográfica rápida |
FramesOnly | Páginas 1..N = un PNG estático por fotograma | Navegación diagnóstica fotograma a fotograma |
AnimationAndFrames (default) | Página 1 = GIF animado, páginas 2..N+1 = un PNG estático por fotograma (N = recuento de fotogramas) | Visión general y detalle en un solo documento |
El tiempo de animación está controlado por AnimationFrameDelayMs (valor predeterminado 100 ms = 10 FPS; el tiempo del GIF usa unidades de 10 ms) y LoopCount (0 = bucle infinito).
El visor descubre que la página 1 está animada enviando una solicitud HEAD para ella. El controlador DocImage.axd debe, por lo tanto, aceptar HEAD en Web.config (verb="GET,HEAD,POST", vea Instalación); sin ello, IIS responde 404 antes de que Doconut se ejecute y la detección de animación nunca funciona.
Resolución
DicomConfig se renderiza a 100 DPI por eje de forma predeterminada. Si no establece HorizontalResolution/VerticalResolution explícitamente, siguen a BaseConfig.ImageResolution cuando está configurado, y solo entonces vuelven a 100.
// Aumento uniforme mediante la propiedad base…
new DicomConfig { ImageResolution = 150 };
// …o control por eje
new DicomConfig { HorizontalResolution = 200, VerticalResolution = 150 };Construya su propio frontend
Las imágenes de página, incluida la primera página animada, utilizan la ruta de imagen estándar DocImage.axd. La solicitud de metadatos, GET /DocImage.axd?token=<token>&meta=1, responde 404 en este paquete para cada documento, incluidos los archivos DICOM, porque el lector de metadatos no está disponible.
En producción
Los estudios de varios fotogramas pueden producir tanto una animación como una página estática por fotograma. AnimationAndFrames ofrece la navegación más completa pero también el mayor costo de renderizado y memoria — y en un solo servidor esa memoria pertenece al proceso trabajador de IIS. Para estudios grandes:
- use
FramesOnlycuando la inspección de fotogramas sea más importante que la reproducción; - evite aumentar ambos ejes de resolución sin medir la memoria;
- cierre la sesión explícitamente cuando el estudio ya no esté abierto;
- mantenga
CachePagesactivado solo cuando el acceso repetido justifique las imágenes retenidas.
Coloque Doconut.Viewer.Dicom.lic junto a Doconut.Viewer.lic en cada servidor, y mantenga HEAD en la lista verb del controlador.
Referencia de API
DicomConfig, DicomDisplayMode y DicomMetadata están en el espacio de nombres Doconut. DicomPlugin está en Doconut.Plugins.Dicom. La tabla completa de propiedades DicomConfig está en Configuraciones de formato.
DicomConfig
public sealed class DicomConfig : BaseConfig
{
public int HorizontalResolution { get; set; } // predeterminado: ImageResolution cuando está configurado, de lo contrario 100
public int VerticalResolution { get; set; } // predeterminado: ImageResolution cuando está configurado, de lo contrario 100
public int AnimationFrameDelayMs { get; set; } = 100;
public ushort LoopCount { get; set; } = 0; // 0 = bucle infinito
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);Siempre devuelve null en este paquete. Lanza InvalidOperationException cuando el token es desconocido o ha expirado. DicomMetadata está definido para que el código compartido con el paquete .NET 8 compile.
Solución de problemas
| Síntoma | Causa | Solución |
|---|---|---|
Cada solicitud responde con un 500 vacío después de agregar el complemento; el registro de eventos de Windows (fuente ASP.NET) muestra The Dicom plugin is registered via AddPlugin but no active license grants Dicom. | Sin licencia, un archivo TRIAL, una licencia sin Dicom, o una licencia de pago fuera de su ventana de versión | Instale una licencia que otorgue Dicom, o elimine AddPlugin<DicomPlugin>() |
Abrir un archivo .dcm lanza Document format '.dcm' is not supported. | DicomPlugin no está registrado, o su paquete no está desplegado | Añada AddPlugin<DicomPlugin>() en DoconutHost.Initialize y despliegue el paquete |
Abrir un archivo .dcm lanza LicenseException: This document type requires the 'Dicom' plugin license. | La licencia cargada ya no otorga Dicom | Instale una licencia que otorgue Dicom |
| Solo aparece una página | La fuente es de un solo cuadro, o DisplayMode está AnimationOnly | Use FramesOnly o AnimationAndFrames para una fuente multi‑cuadro |
| La página 1 no anima | El controlador en Web.config no acepta HEAD | Use verb="GET,HEAD,POST" |
| La animación es demasiado rápida o lenta | AnimationFrameDelayMs está desactivado; el temporizador GIF usa unidades de 10 ms | Ajuste AnimationFrameDelayMs |
| La memoria crece con archivos multi‑cuadro grandes | El modo de visualización, la resolución y la caché de páginas añaden imágenes retenidas | Consulte En producción; cierre las sesiones explícitamente |
Los metadatos siempre son null | Esperado en este paquete | Use el paquete .NET 8 cuando necesite las etiquetas |
GetDicomMetadataAsync lanza Document session not found. Please re-open document. | El token expiró o nunca se abrió | Abra el documento nuevamente |
Notas del framework
En comparación con los paquetes ASP.NET Core, este paquete difiere en el alojamiento y en los metadatos DICOM:
- Registro está en
Application_Start, a través deDoconutHost.Initialize, en lugar debuilder.Services.AddDoconut. - Fallos de inicio aparecen como un
500vacío en cada solicitud, con la razón en el registro de eventos de Windows. - Detección de animación necesita
HEADen la listaverbdel controladorDocImage.axd. - Sin metadatos DICOM.
Viewer.GetDicomMetadataAsyncsiempre devuelvenully registra una advertencia única para una sesión DICOM; la solicitud de metadatosDocImage.axdresponde404, no el501de los paquetes .NET 6 y .NET Standard. - Solo Windows, como el resto del paquete .NET Framework.
¿Fue útil esta página?