Esta página oferece exemplos de comportamento avançado de processamento de imagens, efeitos de ordenação de pipeline e regras de normalização automática de imagens.
Ordem das transformações
As operações na string de parâmetro de consulta imop são executadas sequencialmente da esquerda para a direita, com exceção de metadata ou scale, que são executadas primeiro, e canvas, que é executada por último. Como cada operação atua diretamente na saída visual da operação anterior, a sequência dos parâmetros afeta a qualidade visual final e a preservação de detalhes da imagem derivada.
Considere uma imagem de origem com 1.000 pixels de largura por 1.000 pixels de altura:
Exemplo: Resize seguido de Crop
https://www.example.com/image.jpg?imop=Resize,height=200;Crop,left=0.5
Redimensionar: a imagem é reduzida de 1.000 × 1.000 px para 200 × 200 px para atender ao parâmetro
height=200.Cortar: a operação
left=0.5remove a metade esquerda da imagem já reduzida.
Resultado: uma imagem final de 100 x 200 px que representa os 50% direitos do conteúdo. Como a imagem inteira foi reduzida antes do corte, a região final retém muito menos detalhes.
Exemplo : Crop seguido de Resize
https://www.example.com/image.jpg?imop=Crop,left=0.5;Resize,height=200
Cortar: a
left=0.5operação extrai primeiro os 50% direitos da imagem de origem de alta resolução, criando uma500 x 1000 pximagem intermediária.Redimensionar: A operação
height=200redimensiona a seção cortada para a sua altura final.
Resultado: uma imagem final de 100 * 200 px. Como a imagem original foi cortada primeiro e redimensionada depois, a saída final retém muito mais detalhes e clareza.
Comportamento de alongamento e aumento de escala
Por padrão, o serviço de otimização de imagens aplica uma estratégia estrita de redução de escala para conservar a largura de banda de veiculação de borda e proteger a qualidade visual. Se você solicitar dimensões maiores que a imagem original, o Cloud CDN vai ignorar o aumento e gerar a imagem no tamanho original.
Para substituir esse comportamento e forçar um recurso a aumentar a escala, declare explicitamente o valor stretch.
Requisitos de validação para aumento de escala
Regra de dimensionamento duplo: o valor
stretchsó é permitido se você fornecer explicitamente os parâmetroswidtheheightna operaçãoResize.Restrição de dimensão única: se você incluir
scaling=stretchao definir apenas uma dimensão, comowidthouheight, o serviço de otimização de imagens vai rejeitar toda a solicitação.
Por exemplo,
Solicitação válida: ?imop=resize,width=500,height=500,scaling=stretch
Solicitação inválida: ?imop=resize,width=500, scaling=stretch
Armazenamento em cache e invalidação de cache
Quando você atualiza uma imagem original no servidor de origem, é necessário invalidar a versão armazenada em cache para garantir que o Cloud CDN recupere e veicule o recurso atualizado.
Comportamento de armazenamento em cache
Cada combinação exclusiva de parâmetros de transformação anexada a um URL de imagem cria uma entrada de cache separada e distinta na borda. Para otimizar a taxa de acertos de cache, evite criar um número excessivo de variações de parâmetros exclusivas. Por exemplo, mudanças de um pixel.
O Cloud CDN normaliza as chaves de cache para agrupar parâmetros de transformação idênticos, independentemente da ordem deles na string de consulta.
Comportamento de invalidação
Quando você atualiza uma imagem original no servidor de origem, só precisa enviar uma única solicitação de invalidação para o URL da imagem base. O Cloud CDN aprimorado limpa automaticamente a imagem original armazenada em cache e todas as variantes geradas automaticamente (como WebP ou versões otimizadas) globalmente.
Como a invalidação de variantes funciona
Quando você emite uma solicitação de invalidação de cache usando um padrão de caminho que corresponde a um URL de imagem base, por exemplo,/images/my-picture.jpg, o Cloud CDN identifica e limpa automaticamente:
A imagem de origem original armazenada em cache.
Todas as variantes geradas anteriormente.
É possível aplicar a invalidação de cache do Cloud CDN usando:
Google Google Cloud console: acesse Serviços de rede > Cloud CDN, selecione a origem e acesse a guia Invalidação de cache. Como alternativa, acesse Serviços de rede > Balanceamento de carga, selecione o balanceador de carga e use a guia Invalidação de cache.
Google Cloud CLI: use o comando
Google Cloud CLI compute url-maps invalidate-cdn-cache.Tags de cache : essa é a abordagem recomendada para gerenciar imagens otimizadas. Isso permite emitir solicitações de invalidação direcionadas a uma tag específica, que limpa o conteúdo associado a ela para um controle mais granular.
Por exemplo:
Para invalidar /images/my-picture.jpg e todas as variantes otimizadas globalmente:
Caminho: especifique o caminho exato
/images/my-picture.jpg.Host (opcional): especifique o host se quiser limpar a imagem apenas para um domínio específico.
Quando enviada, essa ação única remove todas as versões otimizadas da imagem dos caches de borda globalmente, garantindo que os usuários recebam imediatamente a versão atualizada na próxima solicitação.
Perfil de cor e orientação da imagem no EXIF (normalização)
Smartphones e câmeras digitais modernos geralmente salvam imagens com grades de pixels brutos e não rotacionados e dependem de uma tag de orientação EXIF incorporada para instruir o dispositivo de visualização a girar a imagem. Por exemplo, 90 graus no sentido horário para orientação retrato. Da mesma forma, os perfis de cores ICC incorporados definem como as cores são exibidas em diferentes monitores.
Para garantir operações previsíveis, o pipeline de borda de otimização de imagens normaliza automaticamente as imagens antes de executar qualquer transformação.
Processo de normalização
Antes de executar as transformações, o mecanismo de borda lê as tags de orientação EXIF e os metadados do perfil de cores ICC e os aplica fisicamente à grade de pixels. Isso ajuda a garantir a previsibilidade das coordenadas para os parâmetros
croperesizesubsequentes.Operações como
crop,resizeouscalesão executadas corretamente nas dimensões visuais verdadeiras para evitar erros visuais.Depois de aplicar ajustes aos pixels principais, o mecanismo de borda remove todos os metadados não essenciais do arquivo para maximizar a economia de tamanho. Por padrão, ele retém
copyright, a menos que um valor específico seja solicitado na operação de metadados.