Ajuste de Desempenho

Otimize renderização e memória

O perfil de recursos do Doconut é dominado por três coisas: DPI de renderização, o que permanece em cache, e quanto tempo as sessões duram. Este guia percorre as alavancas em ordem de impacto.

Resolução — a maior alavanca

ImageResolution (25–300 DPI) controla tanto o tempo de renderização quanto o tamanho da imagem. A maioria dos formatos tem padrão de 200 DPI; imagens e PSD têm padrão de 100.

csharp
// Uma pré-visualização da lista de documentos não precisa de qualidade de impressão
var token = await viewer.OpenDocumentAsync(path, new PdfConfig { ImageResolution = 100 });

Reduzir o DPI pela metade diminui aproximadamente para um quarto a contagem de pixels por página — renderizações mais rápidas, transferências menores, menos memória de cache. Reserve 250–300 DPI para casos de uso com muito zoom (CAD, desenhos de engenharia).

Para PDFs com imagens incorporadas pesadas, PdfConfig adiciona ajustes mais finos: CompressImages + CompressQuality, ResizeImages + ResizeResolution, e CompressFast. Para imagens simples, ImageConfig.MaxImagePixelSize (padrão 3000 px) limita o tamanho de saída.

Cache de página — memória vs. re-renderização

BaseConfig.CachePages (padrão true) mantém cada página renderizada na memória durante a vida útil da sessão. Esse é o padrão correto para visualização interativa — os usuários rolam para frente e para trás. Desative‑o quando:

  • documentos são enormes e visualizados uma única vez, de frente para trás,
  • muitas sessões simultâneas multiplicariam as páginas em cache,
  • você prefere pagar CPU por visualização a manter RAM.
csharp
var token = await viewer.OpenDocumentAsync(path, new PdfConfig { CachePages = false });

No cliente, ViewerConfig.CacheEnabled = true pré‑carrega uma pequena janela móvel de imagens de páginas futuras na memória do navegador. É um cache de pré‑busca por visualização, não um localStorage persistente.

Sessões — a memória que você não vê

Cada sessão aberta mantém o modelo de documento analisado mais (com CachePages) suas páginas renderizadas, até que o TimeOut deslizante (padrão 60 minutos) expire desde a última solicitação. Dois hábitos mantêm isso sob controle:

  • Feche o que você terminou. viewer.CloseDocument(token) libera o motor imediatamente em vez de aguardar a janela ociosa.
  • Dimensione corretamente o tempo limite. Uma pré‑visualização que os usuários olham por dois minutos não precisa de uma sessão de uma hora:
csharp
var token = await viewer.OpenDocumentAsync(path, new DocOptions { TimeOut = 10 });

Lembre‑se da troca: após a expiração o widget mostra Document session not found. Please re-open document. — escolha um tempo limite que corresponda às sessões reais de leitura.

Alternâncias específicas de formato

  • Excel: MemoryOptimizationPreference está ativado por padrão e reduz a pegada de memória ao renderizar planilhas muito grandes — deixe‑o ativado, ou defina‑o como false se quiser trocar memória por um pequeno ganho de velocidade; SheetNames / PrintArea restringem a renderização ao que importa.
  • O modo de redirecionamento tem um custo inicial: DefaultRender = false converte o documento inteiro para PDF no momento da abertura. Isso permite busca nativa baseada em texto, mas em um documento de 500 páginas a chamada de abertura carrega essa conversão — não o habilite reflexivamente.
  • Word/PPT no Linux/Docker: fontes ausentes causam sondagem de fallback lenta e métricas incorretas; aponte FontFolders para um diretório com suas fontes.
  • Apresentações no Linux: nenhum interruptor libgdiplus ou System.Drawing.EnableUnixSupport é necessário — veja Fontes no Linux.

Estratégias do lado do cliente

  • LargeDoc = true — estratégia de carregamento preguiçoso para documentos muito grandes; as páginas carregam à medida que o usuário se aproxima delas.
  • AutoLoad = false (padrão) — não renderize até que você realmente chame View(token).
  • ShowThumbs = false — ignore a geração/solicitações de miniaturas para pré‑visualizações de página única ou incorporadas.
  • Habilitar FixedZoom evita alterações de zoom livres; ao mapear um C# ViewerConfig, ajuste FixedZoomPercentMobile (padrão C# 75) para telas pequenas.

Inicialização única, não por requisição

Encoding.RegisterProvider(CodePagesEncodingProvider.Instance) pertence a Program.cs — registrar codificações por requisição é trabalho desperdiçado; esquecê‑lo completamente quebra documentos legados de página de código.

Distribuindo o trabalho entre nós

Todo o acima ajusta a renderização de um nó sob demanda. Quando um único nó não pode absorver a carga, o próximo alavanca não é um dial maior — é publicar os artefatos de um documento uma vez em armazenamento compartilhado e deixar que cada nó os sirva. Isso altera o modelo de custo: a renderização ocorre uma vez por documento em vez de uma vez por sessão, e as solicitações de página tornam‑se leituras de arquivo. Veja Implantações Distribuídas.

Uma lista de verificação de ajuste

  1. Defina o menor ImageResolution que sua UX aceita.
  2. Mantenha CachePages ativado para visualização interativa; desativado para cenários de passagem única ou alta concorrência.
  3. Feche sessões explicitamente; reduza TimeOut onde o uso é intermitente.
  4. Use LargeDoc + padrão AutoLoad = false no cliente para documentos grandes.
  5. Use DefaultRender = false somente quando precisar de uma projeção PDF que contenha texto.

Esta página foi útil?