Complemento DICOM

Ver imágenes médicas con DicomPlugin

El complemento DICOM añade la 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 complemento — sin este complemento (y su capacidad de licencia), los archivos .dcm no pueden abrirse en absoluto.

SuperficieÚsalo cuando
Viewer with DicomConfig (C#)Abres archivos DICOM en el servidor y eliges cómo se presentan sus fotogramas
El visor (docViewer)Muestras el estudio en tu página: animación, fotogramas y un panel de propiedades DICOM
Punto final HTTP (?token=<token>&meta=1)Lees los metadatos técnicos desde tu propio frontend

El complemento no tiene un widget propio: los archivos DICOM se abren en el visor regular. 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

bash
dotnet add package Doconut.NET8.Dicom

La orden sin versión instala la última versión estable. Para fijar el complemento a la versión que describe esta documentación, pasa la versión por separado:

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

Mantén el paquete DICOM en la misma versión que Doconut.NET8. El ID del paquete es Doconut.NET8.Dicom; .<version> aparece solo en el nombre de archivo descargado .nupkg.

El archivo de licencia del complemento, Doconut.Viewer.Dicom.lic, se coloca en la misma carpeta que Doconut.Viewer.lic; se lee junto con la licencia del visor.

Plataformas. El complemento se ejecuta dondequiera que Doconut.NET8 se ejecute: Windows y Linux basado en glibc en x64 (no Alpine ni otras distribuciones basadas en musl). En Linux, instala la biblioteca de configuración de fuentes antes de que se abra el primer documento:

bash
apt-get update && apt-get install -y libfontconfig1

En RHEL, Fedora y distribuciones similares el paquete es fontconfig. Sin él, abrir un documento falla con The system library libfontconfig1 is missing. Install it (Debian/Ubuntu: apt-get install -y libfontconfig1) and see the Linux section of the Doconut documentation.

Registrar el complemento

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

El complemento (Name: "Doconut DICOM Viewer") registra visores para las extensiones .dcm y .ima, controladas por la capacidad Dicom. Sin una licencia que lo conceda, AddDoconut() lanza un InvalidOperationException al iniciar, antes de que la aplicación sirva una solicitud:

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.

Se lanza por falta de licencia, un archivo legado TRIAL, una licencia sin Dicom, y una licencia paga usada fuera de su ventana de versión. Se aceptan licencias temporales Demo/NFR. Consulta Configuración de Licencia para saber cómo se cargan las licencias.

Debido a que ningún visor incorporado maneja estos formatos, la puerta de tiempo de ejecución también falla de forma crítica si la capacidad se vuelve indisponible más tarde:

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

Licenciamiento y marca de agua

Estado de licenciaInicioSalida DICOM
Licencia paga que otorga Dicom, dentro de su ventana de versiónIniciaRenderizado bajo las reglas normales de marca de agua de la página
Licencia Temporal Activa (Demo/NFR)IniciaRenderizado con la marca de agua de evaluación
Sin licencia, un archivo legado TRIAL, una licencia sin Dicom, o una licencia paga fuera de su ventana de versiónAddDoconut() lanza—

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 se marca para que la marca permanezca visible durante la reproducción. Un DocOptions.Watermark personalizado se usa solo cuando la ruta de licencia permite marcas de agua personalizadas; no puede reemplazar una marca de agua de evaluación.

Uso desde C#

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

Para sesiones abiertas a través de este complemento, Viewer expone los metadatos de etiquetas:

csharp
var metadata = await viewer.GetDicomMetadataAsync(token);
// null cuando la sesión no es un documento DICOM

Modos de visualización, resolución y metadatos

Modos de visualización

Los archivos DICOM multicuadro pueden presentarse de tres maneras (DicomDisplayMode):

ModoPáginas generadasUso para
AnimationOnlyPágina 1 = GIF animado que reproduce todos los cuadros en bucleRevisión cinematográfica rápida
FramesOnlyPáginas 1..N = un PNG estático por cuadroNavegación diagnóstica cuadro a cuadro
AnimationAndFrames (default)Página 1 = GIF animado, páginas 2..N+1 = un PNG estático por cuadro (N = número de cuadros)Visión general + detalle en un solo documento

El tiempo de animación lo controla AnimationFrameDelayMs (por defecto 100 ms = 10 FPS; la granularidad del GIF es de unidades de 10 ms) y LoopCount (0 = bucle infinito).

Resolución

DicomConfig se renderiza a 100 DPI por eje por defecto. Las propiedades de resolución tienen una cadena de reserva que vale la pena conocer: si no estableces HorizontalResolution/VerticalResolution explícitamente, siguen a BaseConfig.ImageResolution cuando está configurado, y solo entonces vuelven a 100.

csharp
// Aumento uniforme a través de la propiedad base…
new DicomConfig { ImageResolution = 150 };

// …o control por eje
new DicomConfig { HorizontalResolution = 200, VerticalResolution = 150 };

Metadatos

DicomMetadata lleva solo etiquetas técnicas y de imagen — recuento de cuadros, dimensiones, profundidad de bits, interpretación fotométrica, sintaxis de transferencia, modalidad y nivel de ventana predeterminado. No contiene datos identificables del paciente. La lista completa está en la referencia de API.

En el visor

El visor no necesita configuración específica de DICOM. Cuando el documento abierto es un archivo DICOM, solicita los metadatos (?token=<token>&meta=1) y agrega un botón DICOM que abre un panel de propiedades técnicas. Si esa solicitud falla, el panel permanece oculto y el documento sigue renderizándose.

Construye tu propio frontend

Los metadatos están disponibles vía HTTP bajo la ruta donde UseDoconut() está montado (normalmente /doconut), para cualquier token de documento abierto:

RutaPropósitoRespuesta exitosa
GET ?token=<token>&meta=1Leer los metadatos técnicos de un documento DICOM abierto200 — DicomMetadata como JSON, con los nombres de propiedad de la referencia de API (Width, Height, NumberOfFrames, …)
EstadoCuándoCuerpo
404El documento no es un archivo DICOMsolo estado
500Falló la lectura de los metadatos{ "error": "metadata failed" }

Las imágenes de página, incluida la primera página animada, usan la ruta estándar de imágenes del visor.

En producción

Los estudios multicuadro pueden generar tanto una animación como una página estática por cuadro. AnimationAndFrames ofrece la navegación más completa pero también tiene el mayor costo de renderizado y caché. Para estudios grandes:

  • usa FramesOnly cuando la inspección de cuadros es más importante que la reproducción cinematográfica;
  • evita aumentar ambos ejes de resolución sin medir la memoria;
  • cierra la sesión explícitamente cuando el estudio ya no está abierto;
  • mantén CachePages habilitado solo cuando los beneficios de acceso repetido superan a las imágenes retenidas.

Coloca Doconut.Viewer.Dicom.lic junto a Doconut.Viewer.lic en cada servidor.

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 se encuentra en Configuraciones de formato.

DicomConfig

csharp
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

csharp
public enum DicomDisplayMode { AnimationOnly, FramesOnly, AnimationAndFrames }

Viewer.GetDicomMetadataAsync

csharp
public Task<DicomMetadata?> GetDicomMetadataAsync(string token, CancellationToken ct = default);

Devuelve null cuando el documento no es un archivo DICOM. Lanza InvalidOperationException cuando el token es desconocido o ha expirado.

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" o "Signed"
    public string? PlanarConfiguration { get; init; }
    public string? TransferSyntax { get; init; }
    public string? Modality { get; init; }              // null cuando no está expuesto
    public double? WindowCenter { get; init; }
    public double? WindowWidth { get; init; }
    public bool IsColor { get; init; }
}

Resolución de problemas

SíntomaCausaSolución
AddDoconut() lanza 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 paga fuera de su ventana de versiónInstale 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á desplegadoAgregue AddPlugin<DicomPlugin>() dentro de AddDoconut() y despliegue el paquete
Abrir un archivo .dcm lanza LicenseException: This document type requires the 'Dicom' plugin license.La licencia cargada ya no otorga DicomInstale una licencia que otorgue Dicom
Solo aparece una páginaLa fuente es de un solo fotograma, o DisplayMode es AnimationOnlyUse FramesOnly o AnimationAndFrames para una fuente multi‑fotograma
La animación es demasiado rápida o lentaAnimationFrameDelayMs está desactivado; el temporizador efectivo de GIF usa unidades de 10 msAjuste AnimationFrameDelayMs
La memoria crece con archivos multiframe grandesEl modo de visualización, la resolución y la caché de páginas añaden todas imágenes retenidasVea En producción; cierre las sesiones explícitamente
Los metadatos son nullEl documento no es un archivo DICOMVerifique el tipo de archivo antes de solicitar los metadatos
GetDicomMetadataAsync lanza Document session not found. Please re-open document.El token expiró o nunca se abrióAbra el documento nuevamente

¿Fue útil esta página?