Servlet de imagem adaptável

Última atualização: 26 de fevereiro de 2025

Criado para:

  • Desenvolvedor
  • Administrador
  • Usuário

Saiba como os Componentes principais usam o Servlet de imagem adaptável para entrega de imagens e como você pode otimizar seu uso.

WARNING
Por motivos de desempenho, é altamente recomendável armazenar imagens no DAM e usar a entrega de imagens otimizadas para a web.
O armazenamento de imagens diretamente no nó do componente destina-se a usos ocasionais. Ele não utiliza as representações do DAM para reduzir o processamento no Servlet de imagens adaptável nem proporciona os benefícios de desempenho da entrega de imagens otimizadas para a web, resultando em possíveis problemas de desempenho.

Servlet de imagens adaptável ou entrega de imagens otimizadas para a web?

O componente principal de imagem possui dois métodos para fornecer imagens.

Este documento descreve o Servlet de imagem adaptável padrão.

Visão geral

Por padrão, o Componente de imagem usa o Servlet de imagem adaptável do Componente principal para fornecer imagens. O Servlet de imagem adaptável é responsável pelo processamento e transmissão de imagens e pode ser aproveitado pelos desenvolvedores em suas personalizações dos Componentes principais.

Seleção de representação

O Servlet de imagem adaptável selecionará automaticamente a representação mais apropriada a ser exibida com base no tamanho do container no qual ele é exibido. O processo de seleção de representação é o seguinte.

  1. O Servlet de imagem adaptável analisa todas as representações disponíveis do ativo da imagem.
  2. Ele seleciona apenas aquelas com o mesmo tipo MIME do ativo referenciado original.
    • Por exemplo: se o ativo original era um arquivo PNG, ele só considerará representações em PNG.
  3. Dessas representações, ele considera as dimensões e as compara ao tamanho do container no qual a imagem deve ser exibida.
  4. Se a representação for maior ou igual ao tamanho do container, ela será adicionada a uma lista de representações candidatas.
  5. Se a representação for menor do que o container, ela será desconsiderada.
  6. Esses critérios garantem que a representação não seja ampliada, o que afetaria a qualidade da imagem.
  7. O Servlet de imagem adaptável escolhe a representação da lista de candidatas que tem o menor tamanho de arquivo.

Otimização da seleção de representação

O Servlet de imagem adaptável tentará escolher a melhor representação para o tamanho e tipo de imagem solicitados. Recomenda-se que as representações do DAM e as larguras permitidas do componente de imagem sejam definidas em sincronia para que o Servlet de imagem adaptável faça o menor processamento possível.

Isto melhorará o desempenho e evitará que algumas imagens sejam processadas corretamente pela biblioteca de processamento de imagens subjacente.