Ajuste de Rendimiento
Optimizar renderizado y memoria
El perfil de recursos de Doconut está dominado por tres cosas: render DPI, lo que permanece en caché, y cuánto tiempo viven las sesiones. Esta guía recorre las palancas en orden de impacto.
Resolución — la palanca más grande
ImageResolution (25–300 DPI) impulsa tanto el tiempo de renderizado como el tamaño de la imagen. La mayoría de los formatos tienen como valor predeterminado 200 DPI; las imágenes y PSD tienen como predeterminado 100.
// Una vista previa de la lista de documentos no necesita calidad de impresión
var token = await viewer.OpenDocumentAsync(path, new PdfConfig { ImageResolution = 100 });Reducir a la mitad el DPI reduce aproximadamente a la cuarta parte la cantidad de píxeles por página — renderizados más rápidos, transferencias más pequeñas, menos memoria de caché. Reserva 250–300 DPI para casos de uso con mucho zoom (CAD, dibujos de ingeniería).
Para PDFs con imágenes incrustadas intensas, PdfConfig agrega ajustes más finos: CompressImages + CompressQuality, ResizeImages + ResizeResolution, y CompressFast. Para imágenes simples, ImageConfig.MaxImagePixelSize (predeterminado 3000 px) limita el tamaño de salida.
Caché de páginas — memoria vs. re-renderizado
BaseConfig.CachePages (predeterminado true) mantiene cada página renderizada en memoria durante la vida de la sesión. Ese es el valor predeterminado correcto para la visualización interactiva — los usuarios se desplazan adelante y atrás. Desactívalo cuando:
- los documentos son enormes y se ven una sola vez, de principio a fin,
- muchas sesiones concurrentes multiplicarían las páginas en caché,
- prefieres pagar CPU por vista en lugar de mantener RAM.
var token = await viewer.OpenDocumentAsync(path, new PdfConfig { CachePages = false });En el cliente, ViewerConfig.CacheEnabled = true precarga una pequeña ventana móvil de imágenes de páginas próximas en la memoria del navegador. Es una caché de prefetch por vista, no una localStorage persistente.
Sesiones — la memoria que no ves
Cada sesión abierta mantiene el modelo de documento analizado más (con CachePages) sus páginas renderizadas, hasta que el TimeOut deslizante (predeterminado 60 minutos) transcurre desde la última solicitud. Dos hábitos mantienen esto bajo control:
- Cierra lo que ya no necesitas.
viewer.CloseDocument(token)libera el motor inmediatamente en lugar de esperar la ventana de inactividad. - Ajusta el tiempo de espera. Una vista previa que los usuarios miran durante dos minutos no necesita una sesión de una hora:
var token = await viewer.OpenDocumentAsync(path, new DocOptions { TimeOut = 10 });Recuerda la compensación: después de expirar el widget muestra Document session not found. Please re-open document. — elige un tiempo de espera que coincida con sesiones de lectura reales.
Conmutadores específicos por formato
- Excel:
MemoryOptimizationPreferenceestá activado por defecto y reduce la huella de memoria al renderizar libros de trabajo muy grandes — déjalo activado, o configúralo afalsesi prefieres intercambiar memoria por una pequeña ganancia de velocidad;SheetNames/PrintArearestringen el renderizado a lo que importa. - El modo de redirección tiene un costo inicial:
DefaultRender = falseconvierte el documento completo a PDF al abrirlo. Proporciona búsqueda nativa basada en texto, pero en un documento de 500 páginas la llamada de apertura lleva esa conversión — no lo actives de forma reflexiva. - Word/PPT en Linux/Docker: la falta de fuentes provoca una detección de reserva lenta y métricas incorrectas; apunta
FontFoldersa un directorio con tus fuentes. - Presentaciones en Linux: no se necesita el conmutador
libgdiplusoSystem.Drawing.EnableUnixSupport— consulta Fuentes en Linux.
Estrategias del lado del cliente
LargeDoc = true— estrategia de carga diferida para documentos muy grandes; las páginas se cargan a medida que el usuario se acerca a ellas.AutoLoad = false(predeterminado) — no renderizar hasta que realmente llames aView(token).ShowThumbs = false— omitir la generación/solicitud de miniaturas para vistas previas de una sola página o incrustadas.- Habilitar
FixedZoomevita cambios de zoom libres; cuando asignas unViewerConfigde C#, ajustaFixedZoomPercentMobile(predeterminado C# 75) para pantallas pequeñas.
Iniciar una vez, no por solicitud
Encoding.RegisterProvider(CodePagesEncodingProvider.Instance) pertenece a Program.cs — registrar codificaciones por solicitud es trabajo desperdiciado; olvidarlo por completo rompe documentos legados de páginas de código.
Distribuir el trabajo entre nodos
Todo lo anterior ajusta el renderizado de un nodo bajo demanda. Cuando un solo nodo no puede absorber la carga, la siguiente palanca no es un dial más grande — es publicar los artefactos del documento una vez en almacenamiento compartido y permitir que cada nodo los sirva. Eso cambia el modelo de costos: el renderizado ocurre una vez por documento en lugar de una vez por sesión, y las solicitudes de página se convierten en lecturas de archivos. Consulta Despliegues Distribuidos.
Lista de verificación de ajuste
- Establece el
ImageResolutionmás bajo que tu UX acepte. - Mantén
CachePagesactivado para visualización interactiva; desactivado para escenarios de paso único o alta concurrencia. - Cierra sesiones explícitamente; acorta
TimeOutdonde el uso es intermitente. - Utiliza
LargeDoc+AutoLoad = falsepredeterminado en el cliente para documentos grandes. - Usa
DefaultRender = falsesolo cuando necesites una proyección PDF con texto.
¿Fue útil esta página?