Enable image transformation - Edge Security Acceleration: Central de Documentação do Alibaba Cloud

O Edge Security Acceleration (ESA) transforma imagens de origem na borda ao converter formatos, ajustar qualidade, recortar e redimensionar. Em seguida, armazena os resultados em cache para aumentar a velocidade de entrega e reduzir o tráfego de retorno à origem.

Limites

O processamento de imagens está sujeito aos limites abaixo.

Limites da imagem original:

Formatos de imagem compatíveis: JPEG, JPG, PNG, WebP, BMP, GIF, TIFF e JPEG 2000.
O tamanho da imagem original não deve exceder 10 MB.
O produto largura × altura não pode ultrapassar 16.777.216 pixels.

Nota
Para imagens GIF, o total de largura × altura corresponde à soma de todos os quadros. Use ferramentas como ImageMagick para visualizar detalhes dos quadros de uma imagem GIF.

Limites da imagem transformada:

O produto largura × altura não pode ultrapassar 16.777.216 pixels.
Na conversão para WebP, o produto largura × altura não deve exceder 16.777.216 pixels, e nem a largura nem a altura podem passar de 16.384 pixels individualmente. Imagens source animadas tornam-se estáticas após a conversão para WebP.

Limites de pré-busca de cache:

As transformações de imagem não se aplicam ao conteúdo pré-buscado no cache. Durante a pré-busca, os nós do ESA obtêm apenas os arquivos de imagem originais, sem executar transformações.

Ativar transformação de imagem

No console do ESA, acesse Site Management. Na coluna Website, clique em no site desejado.
No painel de navegação à esquerda, escolha Speed and Network > Optimize.
Acesse a aba Speed Optimization e ative a opção Image Transformations. Adicione parâmetros de processamento de imagem à URL da solicitação para aplicar diferentes transformações.

Por exemplo, em JavaScript, escreva uma função de manipulação de URL para converter uma imagem para outro formato.
```
function updateImageUrl(format) {
  let baseUrl = "https://example.com/image_01";
  let newUrl = `${baseUrl}.png?image_process=format,${format}`;
  document.getElementById('imageElement').src = newUrl;
}

// Example call to convert to BMP format
updateImageUrl("bmp");

// To convert to another format, such as JPG:
// updateImageUrl("jpg");
```
No código acima, image_process=format,${format} especifica o parâmetro de transformação de imagem. Para consultar outros parâmetros compatíveis e seus valores válidos, visualize Métodos de processamento de imagem compatíveis.

Validação da transformação

Solicitação original

Solicite example.com/bb.jpeg. A resposta retorna uma imagem com orientação normal no formato .jpeg.

Solicitação transformada

Conversão de formato: Para converter uma imagem .jpeg para .png, altere a URL da solicitação para example.com/bb.jpeg?image_process=format,png. A resposta retornará uma imagem .png.
Rotação de imagem: Para girar a imagem 90° no sentido horário, altere a URL da solicitação para example.com/bb.jpeg?image_process=rotate,90. A resposta retornará a imagem girada em 90° no sentido horário.

Métodos de processamento de imagem compatíveis

O ESA permite aplicar um ou mais parâmetros de transformação a uma imagem. A tabela a seguir lista os parâmetros compatíveis.

Recurso de processamento de imagem	Parâmetro de processamento	Descrição
Conversão de formato	format	Converte o formato da imagem.
Conversão de qualidade	quality	Ajusta a qualidade da imagem.
Recorte de imagem	crop	Recorta a imagem para um tamanho especificado.
Redimensionamento de imagem	resize	Redimensiona a imagem para um tamanho especificado. Atualmente, apenas a redução é compatível; o aumento não está disponível.
Rotação de imagem	Rotação automática: auto-orient Rotação especificada: rotate	Gira a imagem automaticamente com base em seus metadados ou a gira no sentido horário por um ângulo especificado.
Cor da imagem	Brilho: bright Contraste: contrast Nitidez: sharpen	Ajusta o brilho, o contraste e a definição da imagem.
Adicionar marca d'água	watermark	Adiciona uma marca d'água de imagem ou texto à figura.
Obter informações	info	Recupera informações da imagem, incluindo dimensões, formato e qualidade.

Relação entre recursos globais e baseados em regras

As configurações globais aplicam-se a todas as solicitações de um site. Para ativar transformações de imagem apenas para solicitações específicas, utilize configurações baseadas em regras com condições correspondentes. O equivalente baseado em regras da transformação de imagem global é a Otimização de Imagem.