My favorites | Português | Sign in

Visão geral da API de imagens em Java

O Google App Engine fornece a capacidade de manipular dados de imagens usando um serviço Imagens do Google dedicado. Esse serviço pode redimensionar, girar, inverter e cortar imagens, pode compor diversas imagens em uma única imagem e pode converter dados de imagem entre vários formatos. Também pode aprimorar fotografias usando um algoritmo predefinido. A API também pode fornecer informações sobre uma imagem, como o formato, a largura, a altura e um histograma de valores de cores.

Como transformar imagens em Java

A API em Java do serviço de imagens permite aplicar transformações em imagens, usando um serviço em vez de realizar o processamento da imagem no servidor do aplicativo. O aplicativo prepara um objeto Image com os dados da imagem a serem transformados e um objeto Transform com instruções sobre como transformar a imagem. O aplicativo obtém um objeto ImagesService e chama o seu método applyTransform() com os objetos Image e Transform. O método retorna um objeto Image da imagem transformada.

O aplicativo obtém instâncias ImagesService, Image e Transform usando ImagesServiceFactory.

import com.google.appengine.api.images.Image;
import com.google.appengine.api.images.ImagesService;
import com.google.appengine.api.images.ImagesServiceFactory;
import com.google.appengine.api.images.Transform;

// ...
        byte[] oldImageData;  // ...

        ImagesService imagesService = ImagesServiceFactory.getImagesService();

        Image oldImage = ImagesServiceFactory.makeImage(oldImageData);
        Transform resize = ImagesServiceFactory.makeResize(200, 300);

        Image newImage = imagesService.applyTransform(resize, oldImage);

        byte[] newImageData = newImage.getImageData();

Use uma instância CompositeTransform para combinar várias transformações em uma única ação. Consulte a referência da API de imagens.

Transformações de imagem disponíveis

O serviço de imagens pode redimensionar, girar, inverter e cortar imagens, além de aprimorar fotografias. Também pode compor diversas imagens em uma única imagem.

Resize

Você pode redimensionar a imagem, mantendo a mesma proporção.

  

Rotate

Você pode girar a imagem em incrementos de 90 graus.

  

Flip Horizontally

Você pode inverter a imagem horizontalmente.

  

Flip Vertically

Você pode inverter a imagem verticalmente.

  

Crop

Você pode cortar a imagem usando uma caixa de corte determinada.

  

I'm Feeling Lucky

A transformação "Estou com sorte" realça as cores escuras e brilhantes de uma imagem e ajusta a cor e o contraste para níveis ideais.

  

Formatos de imagem

O serviço aceita dados de imagem nos formatos JPEG, PNG, GIF (incluindo GIF animado), BMP, TIFF e ICO.

Pode retornar as imagens transformadas nos formatos JPEG e PNG. Se o formato de entrada e o formato de saída forem diferentes, o serviço converterá os dados de entrada no formato de saída antes de realizar a transformação.

Imagens e o servidor de desenvolvimento

O servidor de desenvolvimento usa a sua máquina local para executar os recursos do serviço de imagens.

O servidor de desenvolvimento em Java inclui uma funcionalidade para simular o serviço de imagens. O recurso de aprimoramento de fotografia "Estou com sorte" não é suportado.

Cotas e limites

Cada solicitação do serviço de imagens é computada para a cota de Chamadas da APi de manipulação de imagens. Um aplicativo pode executar diversas transformações de uma imagem em uma única chamada de API.

Os dados enviados para o serviço de imagens são computados para a cota Dados enviados para a API (imagens). Os dados recebidos do serviço de imagens são computados para a cota Dados recebidos da API (imagens).

Cada transformação de uma imagem é computada para a cota Transformações executadas.

Para obter mais informações sobre cotas, consulte Quotas e a seção "Quota Details" (Detalhes da cota) do Console de administração.

Além das cotas, os seguintes limites são aplicados ao uso do serviço de imagens:

Limite Quantidade
tamanho máximo dos dados da imagem enviados ao serviço 1 megabyte
tamanho máximo dos dados da imagem recebidos do serviço 1 megabyte