Visor

Viewer (namespace Doconut) es el punto de entrada público para abrir documentos desde páginas Razor, controladores MVC, componentes Blazor o APIs mínimas. Está sellado, registrado como un servicio transitorio mediante AddDoconut(), y resuelto mediante inyección de constructor — nunca lo construyas directamente.

Viewer no mantiene estado por solicitud y deliberadamente no implementa IDisposable: las sesiones de documento viven independientemente en la caché de sesiones, por lo que disponer del servicio nunca podría cerrar un documento abierto (ver Conceptos básicos → Cómo funciona el Viewer).

OpenDocumentAsync

Abre un documento y devuelve el token de sesión que el widget cliente usa para todas las solicitudes posteriores.

// Simple open
string token = await viewer.OpenDocumentAsync(path);

// With per-format config and options
token = await viewer.OpenDocumentAsync(
    path,
    new PdfConfig { AllowSearch = true, AllowCopy = true },
    new DocOptions { TimeOut = 30 });

// From an upload
await using var ms = new MemoryStream();
await file.CopyToAsync(ms);
ms.Position = 0;
token = await viewer.OpenDocumentAsync(ms, new FileInfo(file.FileName));

Excepciones a manejar:

• LicenseException — una licencia encontrada es rechazada (el mensaje lleva la razón del rechazo), o el formato necesita una capacidad de complemento que ya no está concedida. La expiración del calendario sin mensaje de rechazo degrada a renderizado con marca de agua en lugar de lanzar una excepción.
• FormatNotSupportedException — El formato de documento '<extension>' no está soportado.
• InvalidDataException — el contenido del archivo está corrupto o no coincide con su extensión.

CloseDocument

void CloseDocument(string token)

Elimina la sesión de la caché (descargando el motor de documento inmediatamente), borra el marcador de seguridad y revoca la concesión de acceso. Opcional — la expiración deslizante realiza la misma limpieza — pero se recomienda para documentos grandes.

GetPageCount

int GetPageCount(string token)

Páginas totales de la sesión abierta. Lanza una excepción si el token es desconocido o ha expirado.

DocOptions

Opciones por apertura, independientes del formato (namespace Doconut):

La clase también expone propiedades especializadas que están intencionalmente fuera del flujo normal de visualización de host único:

Marca de agua personalizada

DocOptions.Watermark utiliza seis campos separados por tilde. Un ^ opcional al inicio solicita el diseño en todas las esquinas:

^Text~Color~FontSize~FontName~Opacity~Angle

string token = await viewer.OpenDocumentAsync(
    path,
    new PdfConfig(),
    new DocOptions
    {
        Watermark = "^Confidential~Red~24~Verdana~80~-45",
        TimeOut = 30
    });

El analizador espera exactamente seis campos después del ^ opcional. Una definición inválida se reemplaza por el fallback visible Invalid Watermark del SDK en lugar de desaparecer silenciosamente.

Decisión de licencia

La misma decisión se aplica a las imágenes de página servidas y a las exportaciones de anotaciones. La salida GIF animado se marca cuadro por cuadro. Por lo tanto, una marca de agua personalizada es una característica de aplicación licenciada, no una forma de reemplazar o suprimir la marca de agua de evaluación.

API de anotaciones

Carga y exportación de anotaciones del lado del servidor. El tutorial completo está en Guías → Anotaciones; la superficie es:

Metadatos DICOM

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

El método está presente para alineación de API, pero el visor DICOM .NET 6 no puede suministrar etiquetas técnicas. Devuelve null para sesiones DICOM y no-DICOM; en una sesión DICOM también escribe una advertencia única explicando la limitación de la plataforma. El renderizado de página, fotograma y animación sigue siendo compatible.

Ayudantes de recursos — ReferenceCss / ReferenceScripts

Emite las etiquetas <link>/<script> para los recursos incrustados servidos por UseDoconutResources(), en el orden correcto de dependencias. Los paquetes para funciones bajo licencia como búsqueda y anotación se emiten solo cuando la licencia las habilita, manteniendo la UI del cliente consistente con el comportamiento del servidor.

string ReferenceCss(CssConfig? config = null)      // null → Bootstrap + viewer + search + annotation
string ReferenceScripts(ScriptConfig? config = null)

Banderas de CssConfig: IncludeBootstrapCss, IncludeViewerCss, IncludeSearchCss (búsqueda bajo licencia), IncludeAnnotationCss (anotación bajo licencia).

Banderas de ScriptConfig: IncludeJQuery (requerido por todos los demás), IncludeBootstrap, IncludeViewerScripts (núcleo: docViewer.js + splitter + links), IncludeSearchScripts y IncludeSearchBar (búsqueda bajo licencia), IncludeAnnotationScripts y IncludeAnnotationBar (anotación bajo licencia).

@inject Doconut.Viewer Viewer

@Html.Raw(Viewer.ReferenceCss(new CssConfig { IncludeBootstrapCss = true, IncludeViewerCss = true }))
@Html.Raw(Viewer.ReferenceScripts(new ScriptConfig { IncludeJQuery = true, IncludeViewerScripts = true }))