Pacote google.appengine.api.images

Resumo

API de manipulação de imagem.

O App Engine permite manipular dados de imagem usando um serviço dedicado. Esse serviço pode redimensionar, girar, inverter e cortar imagens. Também pode combinar várias imagens em uma única imagem e converter dados de imagem em vários formatos. Também é capaz de aperfeiçoar fotografias por meio de um algoritmo predefinido. A API também pode fornecer informações sobre uma imagem, como formato, largura, altura e um histograma de valores de cor.

Conteúdo

exception google.appengine.api.images.AccessDeniedErrorFonte

Bases: google.appengine.api.images.Error

O aplicativo não tem permissão para acessar a imagem.

exception google.appengine.api.images.BadImageErrorFonte

Bases: google.appengine.api.images.Error

Os dados da imagem estão corrompidos.

exception google.appengine.api.images.BadRequestErrorFonte

Bases: google.appengine.api.images.Error

Os parâmetros especificados eram inválidos de alguma maneira.

exception google.appengine.api.images.BlobKeyRequiredErrorFonte

Bases: google.appengine.api.images.Error

Uma chave blob é obrigatória para essa operação.

exception google.appengine.api.images.ErrorFonte

Bases: exceptions.Exception

Classe de erro base para esse módulo.

class google.appengine.api.images.Image(image_data=None, blob_key=None, filename=None)Fonte

Bases: object

Objeto de imagem para manipular.

static CheckValidIntParameter(parameter, min_value, max_value, name)Fonte

Verifica se um parâmetro é um inteiro dentro do intervalo especificado.

crop(left_x, top_y, right_x, bottom_y)Fonte

Recorta a imagem.

Os quatro argumentos são os números de escala que descrevem a caixa delimitadora que recortará a imagem. O ponto superior esquerdo da caixa delimitadora estará em (left_x*image_width, top_y*image_height) e o ponto inferior direito estará em (right_x*image_width, bottom_y*image_height).

Parâmetros
  • left_x: valor flutuante entre 0,0 e 1,0, inclusive.

  • top_y: valor flutuante entre 0,0 e 1,0, inclusive.

  • right_x: valor flutuante entre 0,0 e 1,0, inclusive.

  • bottom_y: valor flutuante entre 0,0 e 1,0, inclusive.

Gera
  • TypeError: se os argumentos não forem do tipo float.

  • BadRequestError: quando os valores da caixa delimitadora são inválidos ou se as transformações MAX_TRANSFORMS_PER_REQUEST já foram solicitadas para essa imagem.

execute_transforms(output_encoding=0, quality=None, parse_source_metadata=False, transparent_substitution_rgb=None, rpc=None)Fonte

Executa transformações em determinada imagem.

Você só pode executar uma transformação por imagem a cada chamada execute_transforms().

Parâmetros
  • output_encoding: um valor proveniente de OUTPUT_ENCODING_TYPES.

  • quality: um valor entre 1 e 100 para especificar a qualidade da codificação. Esse valor é usado apenas para controle de qualidade de JPEG e WEBP.

  • parse_source_metadata: quando é True, os metadados (EXIF) da imagem de origem são analisados antes de qualquer transformação. Os resultados podem ser recuperados via Image.get_original_metadata.

  • transparent_substitution_rgb: quando os pixels transparentes não forem aceitos no formato de imagem de destino, eles serão substituídos pela cor especificada, que precisa estar no formato RGB de 32 bits.

  • rpc: um objeto UserRPC.

Retorna

Uma string de dados da imagem depois que as transformações foram executadas nela.

Gera
  • BadRequestError: quando as especificações da solicitação são inválidas.

  • NotImageError: quando os dados da imagem fornecidos não são uma imagem.

  • BadImageError: quando os dados da imagem fornecidos estão corrompidos.

  • LargeImageError: quando os dados da imagem fornecidos são muito grandes para serem processados.

  • InvalidBlobKeyError: quando a chave blob fornecida é inválida.

  • TransformationError: quando ocorre um erro durante a manipulação da imagem.

  • AccessDeniedError: quando a chave blob se refere a um objeto do Google Storage que o aplicativo não tem permissão para acessar.

  • ObjectNotFoundError: quando a chave blob se refere a um objeto que não existe mais.

  • Error: todas as outras condições de erro.

execute_transforms_async(output_encoding=0, quality=None, parse_source_metadata=False, transparent_substitution_rgb=None, rpc=None)Fonte

Executa transformações de maneira assíncrona em determinada imagem.

Parâmetros
  • output_encoding: um valor proveniente de OUTPUT_ENCODING_TYPES.

  • quality: um valor entre 1 e 100 para especificar a qualidade da codificação. Esse valor é usado apenas para controle de qualidade JPEG e WEBP.

  • parse_source_metadata: quando é True, os metadados (EXIF) da imagem de origem são analisados antes de qualquer transformação. Os resultados podem ser recuperados via Image.get_original_metadata.

  • transparent_substitution_rgb: quando os pixels transparentes não forem aceitos no formato de imagem de destino, eles serão substituídos pela cor especificada, que precisa estar no formato RGB de 32 bits.

  • rpc: um objeto UserRPC.

Retorna

Um objeto UserRPC.

Gera
  • BadRequestError: quando as especificações da solicitação são inválidas.

  • NotImageError: quando os dados da imagem fornecidos não são uma imagem.

  • BadImageError: quando os dados da imagem fornecidos estão corrompidos.

  • LargeImageError: quando os dados da imagem fornecidos são muito grandes para serem processados.

  • InvalidBlobKeyError: quando a chave blob fornecida é inválida.

  • TransformationError: quando ocorre um erro durante a manipulação da imagem.

  • AccessDeniedError: quando a chave blob se refere a um objeto do Google Storage que o aplicativo não tem permissão para acessar.

  • ValueError: quando transparent_substitution_rgb não é um número inteiro.

  • Error: todas as outras condições de erro.

format

Recupera o formato da imagem.

get_original_metadata()Fonte

Lista os metadados da imagem original.

Retorna um dicionário de metadados extraídos da imagem original durante execute_transform.

Os campos ImageWidth e ImageLength são corrigidos caso não correspondam às dimensões reais da imagem original.

Retorna

Dicionário de metadados com chaves de string. Se execute_transform foi chamado com parse_metadata definido como True, esse dicionário contém informações sobre as várias propriedades da imagem original, como dimensões, perfil de cor e propriedades provenientes do EXIF.

Mesmo que parse_metadata fosse False ou as imagens não tivessem quaisquer metadados, o dicionário conterá um conjunto limitado de metadados, no mínimo com as dimensões ImageWidth e ImageLength da imagem original que está sendo retornada.

Essa chamada retornará None se for executada antes de uma chamada execute_transfrom bem-sucedida.

height

Recupera a altura da imagem.

histogram(rpc=None)Fonte

Calcula o histograma da imagem.

Parâmetros

rpc: um objeto UserRPC.

Retorna

3 listas de 256 elementos contendo o número de ocorrências de cada valor de cada cor na ordem RGB. Você pode saber mais sobre histogramas de cores na Wikipedia.

Gera
  • NotImageError: quando os dados da imagem fornecidos não são uma imagem.

  • BadImageError: quando os dados da imagem fornecidos estão corrompidos.

  • LargeImageError: quando os dados da imagem fornecidos são muito grandes para serem processados.

  • Error: todas as outras condições de erro.

histogram_async(rpc=None)Fonte

Calcula o histograma da imagem de maneira assíncrona.

Parâmetros

rpc: um objeto UserRPC opcional.

Retorna

Um objeto UserRPC.

Tipo de retorno

rpc

Gera
  • NotImageError: quando os dados da imagem fornecidos não são uma imagem.

  • BadImageError: quando os dados da imagem fornecidos estão corrompidos.

  • LargeImageError: quando os dados da imagem fornecidos são muito grandes para serem processados.

  • Error: todas as outras condições de erro.

horizontal_flip()Fonte

Inverte a imagem horizontalmente.

Gera

BadRequestError: se as transformações MAX_TRANSFORMS_PER_REQUEST já foram solicitadas na imagem.

im_feeling_lucky()Fonte

Ajusta automaticamente os níveis de contraste e cor da imagem.

É semelhante ao botão "Estou com sorte" do Picasa.

Gera

BadRequestError: se as transformações MAX_TRANSFORMS_PER_REQUEST já foram solicitadas para essa imagem.

resize(width=0, height=0, crop_to_fit=False, crop_offset_x=0.5, crop_offset_y=0.5, allow_stretch=False)Fonte

Redimensiona a imagem, mantendo a proporção.

Se width e height forem especificadas, o mais restritivo dos dois valores será usado quando a imagem for redimensionada. A dimensão máxima permitida para width e height é 4.000 pixels.

Se width e height forem especificadas e crop_to_fit for True, o menos restritivo dos dois valores será usado quando a imagem for redimensionada e a imagem será recortada para se ajustar ao tamanho especificado. Nesse caso, o centro do corte pode ser ajustado por crop_offset_x e crop_offset_y.

Parâmetros
  • width: número inteiro da largura, em pixels, usado para alterar a imagem.

  • height: número inteiro da altura, em pixels, usado para alterar a imagem.

  • crop_to_fit: se for True, e width e height forem especificadas, a imagem será recortada depois de redimensionada para se ajustar às dimensões especificadas.

  • crop_offset_x: valor flutuante entre 0,0 e 1,0. 0 é esquerda e 1 é direita. O valor padrão é 0,5, o centro da imagem.

  • crop_offset_y: valor flutuante entre 0,0 e 1,0. 0 é a parte superior e 1 é a parte inferior. O valor padrão é 0,5, o centro da imagem.

  • allow_stretch: se for True, e width e height forem especificadas, a imagem será esticada para se ajustar às dimensões de redimensionamento sem manter a proporção.

Gera
  • TypeError: quando width ou height não é do tipo inteiro ou longo.

  • BadRequestError: quando a altura ou a largura é inválida, ou se já foram solicitadas transformações MAX_TRANSFORMS_PER_REQUEST nessa imagem.

rotate(degrees)Fonte

Gira uma imagem em um determinado número de graus no sentido horário.

Parâmetros

degrees: valor inteiro do número de graus que uma imagem precisa ser girada. Esse valor precisa ser um múltiplo de 90.

Gera
  • TypeError: quando degrees não é um tipo inteiro ou longo.

  • BadRequestError: quando o valor de degrees é inválido ou se já foram solicitadas transformações MAX_TRANSFORMS_PER_REQUEST.

set_correct_orientation(correct_orientation)Fonte

Define uma sinalização para corrigir a orientação da imagem com base nos metadados dela.

Os metadados EXIF dentro da imagem podem conter um parâmetro que indica a orientação correta. Esse valor pode ser de 1 a 8, inclusive. Definir a orientação como 1 significa que a imagem está na orientação “normal”, ou seja, será visualizada da maneira que está armazenada. Normalmente, esse valor de orientação não tem efeito sobre o comportamento das transformações. No entanto, se você chamar essa função com o argumento correct_orientation, qualquer orientação especificada nos metadados EXIF será corrigida durante a primeira transformação.

Se a correção foi solicitada ou não, o valor de orientação na imagem transformada é sempre desmarcado para indicar que nenhuma correção adicional da orientação da imagem retornada é necessária.

Parâmetros

correct_orientation: um valor proveniente de ORIENTATION_CORRECTION_TYPE.

Gera

BadRequestError: se o valor correct_orientation é inválido.

vertical_flip()Fonte

Inverte a imagem verticalmente.

Gera

BadRequestError: se as transformações MAX_TRANSFORMS_PER_REQUEST já foram solicitadas na imagem.

width

Recupera a largura da imagem.

exception google.appengine.api.images.InvalidBlobKeyError(blob_key=None)Fonte

Bases: google.appengine.api.images.Error

A chave blob fornecida era inválida.

exception google.appengine.api.images.LargeImageErrorFonte

Bases: google.appengine.api.images.Error

Os dados da imagem são muito grandes para serem processados.

exception google.appengine.api.images.NotImageErrorFonte

Bases: google.appengine.api.images.Error

Os dados de imagem fornecidos não são reconhecíveis como uma imagem.

exception google.appengine.api.images.ObjectNotFoundErrorFonte

Bases: google.appengine.api.images.Error

A chave blob se refere a um objeto que não existe.

exception google.appengine.api.images.TransformationErrorFonte

Bases: google.appengine.api.images.Error

Ocorreu um erro ao tentar transformar a imagem.

exception google.appengine.api.images.UnsupportedSizeErrorFonte

Bases: google.appengine.api.images.Error

O tamanho especificado não é compatível com a operação solicitada.

google.appengine.api.images.composite(inputs, width, height, color=0, output_encoding=0, quality=None, rpc=None)Fonte

Combina uma ou mais imagens em uma tela.

Parâmetros
  • inputs:

    uma lista de tuplas (image_data, x_offset, y_offset, opacity, anchor) em que:

    • image_data

      String dos dados da imagem de origem.

    • x_offset

      Desvio no eixo X, em pixels, a partir da posição de ancoragem.

    • y_offset

      Desvio no eixo Y, em pixels, a partir da posição de ancoragem.

    • opacity

      Opacidade da imagem, especificada como um valor flutuante no intervalo [0,0, 1,0].

    • anchor

      Ponto de ancoragem de ANCHOR_POINTS. O ponto de ancoragem da imagem é alinhado com o mesmo ponto de ancoragem da tela. Por exemplo, TOP_RIGHT colocaria o canto superior direito da imagem no canto superior direito da tela e aplicaria os desvios x e y.

  • width: largura da tela, em pixels.

  • height: altura da tela, em pixels.

  • color: cor de fundo da tela, codificada como um número inteiro não assinado de 32 bits, em que cada canal de cor é representado por um byte na ordem ARGB.

  • output_encoding: um valor proveniente de OUTPUT_ENCODING_TYPES.

  • quality: um valor entre 1 e 100 para especificar a qualidade da codificação. Esse valor é usado apenas para controlar a qualidade JPEG.

  • rpc: um objeto UserRPC opcional.

Retorna

Uma string que contém os dados da imagem composta.

Gera
  • TypeError: se width, height, color, x_offset ou y_offset não for do tipo inteiro ou longo, ou se opacity não for um valor flutuante.

  • BadRequestError: se mais de MAX_TRANSFORMS_PER_REQUEST combinações foram solicitadas, se a largura ou a altura da tela for maior que 4.000 ou menor ou igual a 0, se a cor for inválida, se a opacidade estiver fora do intervalo [0,1] para qualquer opção de combinação, ou se a âncora for inválida.

google.appengine.api.images.composite_async(inputs, width, height, color=0, output_encoding=0, quality=None, rpc=None)Fonte

Combina uma ou mais imagens em uma tela de maneira assíncrona.

Parâmetros
  • inputs:

    uma lista de tuplas (image_data, x_offset, y_offset, opacity, anchor) em que:

    • image_data

      String dos dados da imagem de origem.

    • x_offset

      Desvio no eixo X, em pixels, a partir da posição de ancoragem.

    • y_offset

      Desvio no eixo Y, em pixels, a partir da posição de ancoragem.

    • opacity

      Opacidade da imagem, especificada como um valor flutuante no intervalo [0,0, 1,0].

    • anchor

      Ponto de ancoragem de ANCHOR_POINTS. O ponto de ancoragem da imagem é alinhado com o mesmo ponto de ancoragem da tela. Por exemplo, TOP_RIGHT colocaria o canto superior direito da imagem no canto superior direito da tela e aplicaria os desvios x e y.

  • width: largura da tela, em pixels.

  • height: altura da tela, em pixels.

  • color: cor de fundo da tela, codificada como um número inteiro não assinado de 32 bits, em que cada canal de cor é representado por um byte na ordem ARGB.

  • output_encoding: um valor proveniente de OUTPUT_ENCODING_TYPES.

  • quality: um valor entre 1 e 100 para especificar a qualidade da codificação. Esse valor é usado apenas para controle de qualidade de JPEG.

  • rpc: um objeto UserRPC opcional.

Retorna

Um objeto UserRPC.

Gera
  • TypeError: se width, height, color, x_offset ou y_offset não for do tipo inteiro ou longo, ou se opacity não for um valor flutuante.

  • BadRequestError: se mais de MAX_TRANSFORMS_PER_REQUEST combinações foram solicitadas, se a largura ou a altura da tela for maior que 4.000 ou menor ou igual a 0, se a cor for inválida, se a opacidade estiver fora do intervalo [0,1] para qualquer opção de combinação, ou se a âncora for inválida.

google.appengine.api.images.create_rpc(deadline=None, callback=None)Fonte

Cria um objeto RPC para uso com a Images API.

Parâmetros
  • deadline: prazo opcional em segundos para a operação. O padrão é um prazo específico do sistema, geralmente de cinco segundos.

  • callback: chamável opcional a ser invocado na conclusão.

Retorna

Um objeto apiproxy_stub_map.UserRPC especializado para esse serviço.

google.appengine.api.images.crop(image_data, left_x, top_y, right_x, bottom_y, output_encoding=0, quality=None, correct_orientation=0, rpc=None, transparent_substitution_rgb=None)Fonte

Recorta a imagem.

Os quatro argumentos são os números de escala que descrevem a caixa delimitadora que recortará a imagem. O ponto superior esquerdo da caixa delimitadora estará em (left_x*image_width, top_y*image_height) e o ponto inferior direito estará em (right_x*image_width, bottom_y*image_height).

Parâmetros
  • image_data: string dos dados da imagem de origem.

  • left_x: valor flutuante entre 0,0 e 1,0, inclusive.

  • top_y: valor flutuante entre 0,0 e 1,0, inclusive.

  • right_x: valor flutuante entre 0,0 e 1,0, inclusive.

  • bottom_y: valor flutuante entre 0,0 e 1,0, inclusive.

  • output_encoding: um valor proveniente de OUTPUT_ENCODING_TYPES.

  • quality: um valor entre 1 e 100 para especificar a qualidade da codificação. Esse valor é usado apenas para controlar a qualidade JPEG.

  • correct_orientation: um valor proveniente de ORIENTATION_CORRECTION_TYPE para indicar se a correção da orientação deve ser executada durante a transformação.

  • rpc: um objeto UserRPC opcional.

  • transparent_substitution_rgb: quando os pixels transparentes não forem aceitos no formato de imagem de destino, eles serão substituídos pela cor especificada, que precisa estar no formato RGB de 32 bits.

Retorna

Dados brutos da imagem transformada.

Gera
  • TypeError: se os argumentos não forem do tipo float.

  • BadRequestError: se os valores da caixa delimitadora forem inválidos.

  • Error: todos os outros erros. Consulte Image.ExecuteTransforms para mais detalhes.

google.appengine.api.images.crop_async(image_data, left_x, top_y, right_x, bottom_y, output_encoding=0, quality=None, correct_orientation=0, rpc=None, transparent_substitution_rgb=None)Fonte

Recorta a imagem fornecida de maneira assíncrona.

Os quatro argumentos são os números de escala que descrevem a caixa delimitadora que recortará a imagem. O ponto superior esquerdo da caixa delimitadora estará em (left_x*image_width, top_y*image_height) e o ponto inferior direito estará em (right_x*image_width, bottom_y*image_height).

Parâmetros
  • image_data: string dos dados da imagem de origem.

  • left_x: valor flutuante entre 0,0 e 1,0, inclusive.

  • top_y: valor flutuante entre 0,0 e 1,0, inclusive.

  • right_x: valor flutuante entre 0,0 e 1,0, inclusive.

  • bottom_y: valor flutuante entre 0,0 e 1,0, inclusive.

  • output_encoding: um valor proveniente de OUTPUT_ENCODING_TYPES.

  • quality: um valor entre 1 e 100 para especificar a qualidade da codificação. Esse valor é usado apenas para controlar a qualidade JPEG.

  • correct_orientation: um valor proveniente de ORIENTATION_CORRECTION_TYPE para indicar se a correção da orientação deve ser executada durante a transformação.

  • rpc: um objeto UserRPC opcional.

  • transparent_substitution_rgb: quando os pixels transparentes não forem aceitos no formato de imagem de destino, eles serão substituídos pela cor especificada, que precisa estar no formato RGB de 32 bits.

Retorna

Um objeto UserRPC. Chame get_result() para concluir o RPC e conseguir o resultado do corte.

Gera
  • TypeError: se os argumentos não forem do tipo float.

  • BadRequestError: quando os valores da caixa delimitadora forem inválidos.

  • Error: todos os outros erros. Consulte Image.ExecuteTransforms para mais detalhes.

google.appengine.api.images.delete_serving_url(blob_key, rpc=None)Fonte

Exclui um URL de veiculação criado para blob_key usando get_serving_url.

Parâmetros
  • blob_key: BlobKey, BlobInfo, string ou representação Unicode da BlobKey de um blob com um URL existente que você quer excluir.

  • rpc: um objeto UserRPC opcional.

Gera
google.appengine.api.images.delete_serving_url_async(blob_key, rpc=None)Fonte

Exclui um URL de veiculação criado usando get_serving_url - versão assíncrona.

Parâmetros
  • blob_key: BlobKey, BlobInfo, string ou representação Unicode da BlobKey de um blob com um URL existente que você quer excluir.

  • rpc: um objeto UserRPC opcional.

Retorna

Um objeto UserRPC.

Gera
google.appengine.api.images.get_serving_url(blob_key, size=None, crop=False, secure_url=None, filename=None, rpc=None)Fonte

Recebe um URL que veiculará a imagem subjacente.

Esse URL é veiculado por uma infraestrutura de veiculação de imagem dinâmica de alto desempenho. Esse formato de URL também permite o redimensionamento dinâmico e o corte com certas restrições. Para redimensionar e cortar dinamicamente, especifique o tamanho e os argumentos de corte ou simplesmente anexe as opções ao final do URL padrão recebido por meio dessa chamada.

Exemplo:

get_serving_url -> "http://lh3.ggpht.com/SomeCharactersGoesHere"

Para uma versão de 32 pixels com proporção preservada, acrescente =s32 ao URL:

http://lh3.ggpht.com/SomeCharactersGoesHere=s32

Para uma versão recortada de 32 pixels, acrescente =s32-c:

http://lh3.ggpht.com/SomeCharactersGoesHere=s32-c

Os tamanhos disponíveis são qualquer número inteiro no intervalo [0, 1600] e estão disponíveis como IMG_SERVING_SIZES_LIMIT.

Parâmetros
  • blob_key: a BlobKey, a BlobInfo, a string ou a representação Unicode da BlobKey de um blob com um URL existente que você requer.

  • size: número inteiro do tamanho das imagens resultantes.

  • crop: valor booleano. True solicita uma imagem recortada, enquanto False solicita uma imagem redimensionada.

  • secure_url: valor booleano. True solicita um URL https, enquanto False solicita um URL http.

  • filename: o nome do arquivo de um objeto do Google Storage com um URL que você requer.

  • rpc: um objeto UserRPC opcional.

Retorna

Uma string de URL.

Gera
  • BlobKeyRequiredError: se uma chave blob não foi especificada no construtor.

  • UnsupportedSizeError: se você especificou um parâmetro de tamanho inválido.

  • BadRequestError: se crop e size estão presentes na combinação errada, ou se blob_key e filename estão especificados.

  • TypeError: se secure_url não é um tipo booleano.

  • AccessDeniedError: se blob_key refere-se a um objeto do Google Storage que o aplicativo não tem permissão para acessar.

  • ObjectNotFoundError: se blob_key refere-se a um objeto que não existe.

google.appengine.api.images.get_serving_url_async(blob_key, size=None, crop=False, secure_url=None, filename=None, rpc=None)Fonte

Recebe um URL de maneira assíncrona que veiculará a imagem subjacente.

Esse URL é veiculado por uma infraestrutura de veiculação de imagem dinâmica de alto desempenho. Esse formato de URL também permite o redimensionamento dinâmico e o corte com certas restrições. Para redimensionar e cortar dinamicamente, especifique o tamanho e os argumentos de corte ou simplesmente anexe as opções ao final do URL padrão recebido por meio dessa chamada.r

Exemplo:

get_serving_url -> "http://lh3.ggpht.com/SomeCharactersGoesHere"

Para uma versão de 32 pixels com proporção preservada, acrescente =s32 ao URL:

http://lh3.ggpht.com/SomeCharactersGoesHere=s32

Para uma versão recortada de 32 pixels, acrescente =s32-c:

http://lh3.ggpht.com/SomeCharactersGoesHere=s32-c

Os tamanhos disponíveis são qualquer número inteiro no intervalo [0, 1600] e estão disponíveis como IMG_SERVING_SIZES_LIMIT.

Parâmetros
  • blob_key: a BlobKey, a BlobInfo, a string ou a representação Unicode da BlobKey de um blob com um URL que você requer.

  • size: número inteiro do tamanho das imagens resultantes.

  • crop: valor booleano. True solicita uma imagem recortada, enquanto False solicita uma imagem redimensionada.

  • secure_url: valor booleano. True solicita um URL https, enquanto False solicita um URL http.

  • filename: o nome do arquivo de um objeto do Google Storage com um URL que você requer.

  • rpc: um objeto UserRPC opcional.

Retorna

Um UserRPC com um resultado que será uma string que é o URL de veiculação.

Gera
  • BlobKeyRequiredError: se uma chave blob não foi especificada no construtor.

  • UnsupportedSizeError: se você especificou um parâmetro de tamanho inválido.

  • BadRequestError: se crop e size estão presentes na combinação errada, ou se blob_key e filename estão especificados.

  • TypeError: se secure_url não é um tipo booleano.

  • AccessDeniedError: se blob_key refere-se a um objeto do Google Storage que o aplicativo não tem permissão para acessar.

google.appengine.api.images.histogram(image_data, rpc=None)Fonte

Calcula o histograma da imagem fornecida.

Parâmetros
  • image_data: string dos dados da imagem de origem.

  • rpc: um objeto UserRPC opcional.

Retorna

3 listas de 256 elementos contendo o número de ocorrências de cada valor de cada cor na ordem RGB.

Gera
  • NotImageError: se os dados da imagem fornecidos não são uma imagem.

  • BadImageError: se os dados da imagem fornecidos estão corrompidos.

  • LargeImageError: se os dados da imagem fornecidos são muito grandes para serem processados.

  • Error: todos os outros erros.

google.appengine.api.images.histogram_async(image_data, rpc=None)Fonte

Calcula o histograma da imagem fornecida, versão assíncrona.

Parâmetros
  • image_data: string dos dados da imagem de origem.

  • rpc: um objeto UserRPC opcional.

Retorna

Um objeto UserRPC.

Gera
  • NotImageError: se os dados da imagem fornecidos não são uma imagem.

  • BadImageError: se os dados da imagem fornecidos estão corrompidos.

  • LargeImageError: se os dados da imagem fornecidos são muito grandes para serem processados.

  • Error: todos os outros erros.

google.appengine.api.images.horizontal_flip(image_data, output_encoding=0, quality=None, correct_orientation=0, rpc=None, transparent_substitution_rgb=None)Fonte

Inverte a imagem horizontalmente.

Parâmetros
  • image_data: string dos dados da imagem de origem.

  • output_encoding: um valor proveniente de OUTPUT_ENCODING_TYPES.

  • quality: um valor entre 1 e 100 para especificar a qualidade da codificação. Esse valor é usado apenas para controlar a qualidade JPEG.

  • correct_orientation: um valor proveniente de ORIENTATION_CORRECTION_TYPE para indicar se a correção da orientação deve ser executada durante a transformação.

  • rpc: um objeto UserRPC opcional.

  • transparent_substitution_rgb: quando os pixels transparentes não forem aceitos no formato de imagem de destino, eles serão substituídos pela cor especificada, que precisa estar no formato RGB de 32 bits.

Retorna

Dados brutos da imagem transformada.

Gera

Error: todos os erros. Consulte Image.ExecuteTransforms para mais detalhes.

google.appengine.api.images.horizontal_flip_async(image_data, output_encoding=0, quality=None, correct_orientation=0, rpc=None, transparent_substitution_rgb=None)Fonte

Inverte a imagem horizontalmente de maneira assíncrona.

Parâmetros
  • image_data: string dos dados da imagem de origem.

  • output_encoding: um valor proveniente de OUTPUT_ENCODING_TYPES.

  • quality: um valor entre 1 e 100 para especificar a qualidade da codificação. Esse valor é usado apenas para controlar a qualidade JPEG.

  • correct_orientation: um valor proveniente de ORIENTATION_CORRECTION_TYPE para indicar se a correção da orientação deve ser executada durante a transformação.

  • rpc: um objeto UserRPC opcional.

  • transparent_substitution_rgb: quando os pixels transparentes não forem aceitos no formato de imagem de destino, eles serão substituídos pela cor especificada, que precisa estar no formato RGB de 32 bits.

Retorna

Um objeto UserRPC. Chame get_result() para concluir o RPC e conseguir o resultado do corte.

Gera

Error: todos os erros. Consulte Image.ExecuteTransforms para mais detalhes.

google.appengine.api.images.im_feeling_lucky(image_data, output_encoding=0, quality=None, correct_orientation=0, rpc=None, transparent_substitution_rgb=None)Fonte

Ajusta automaticamente os níveis da imagem.

É semelhante ao botão "Estou com sorte" do Picasa.

Parâmetros
  • image_data: string dos dados da imagem de origem.

  • output_encoding: um valor proveniente de OUTPUT_ENCODING_TYPES.

  • quality: um valor entre 1 e 100 para especificar a qualidade da codificação. Esse valor é usado apenas para controlar a qualidade JPEG.

  • correct_orientation: um valor proveniente de ORIENTATION_CORRECTION_TYPE para indicar se a correção da orientação deve ser executada durante a transformação.

  • rpc: um objeto UserRPC opcional.

  • transparent_substitution_rgb: quando os pixels transparentes não forem aceitos no formato de imagem de destino, eles serão substituídos pela cor especificada, que precisa estar no formato RGB de 32 bits.

Retorna

Dados brutos da imagem transformada.

Gera

Error: todos os erros. Consulte Image.ExecuteTransforms para mais detalhes.

google.appengine.api.images.im_feeling_lucky_async(image_data, output_encoding=0, quality=None, correct_orientation=0, rpc=None, transparent_substitution_rgb=None)Fonte

Ajusta automaticamente os níveis de imagem de maneira assíncrona.

É semelhante ao botão "Estou com sorte" do Picasa.

Parâmetros
  • image_data: string dos dados da imagem de origem.

  • output_encoding: um valor proveniente de OUTPUT_ENCODING_TYPES.

  • quality: um valor entre 1 e 100 para especificar a qualidade da codificação. Esse valor é usado apenas para controlar a qualidade JPEG.

  • correct_orientation: um valor proveniente de ORIENTATION_CORRECTION_TYPE para indicar se a correção da orientação deve ser executada durante a transformação.

  • rpc: um objeto UserRPC opcional.

  • transparent_substitution_rgb: quando os pixels transparentes não forem aceitos no formato de imagem de destino, eles serão substituídos pela cor especificada, que precisa estar no formato RGB de 32 bits.

Retorna

Um objeto UserRPC.

Gera

Error: todos os erros. Consulte Image.ExecuteTransforms para mais detalhes.

google.appengine.api.images.resize(image_data, width=0, height=0, output_encoding=0, quality=None, correct_orientation=0, crop_to_fit=False, crop_offset_x=0.5, crop_offset_y=0.5, allow_stretch=False, rpc=None, transparent_substitution_rgb=None)Fonte

Redimensiona um determinado arquivo de imagem enquanto mantém a proporção.

Se width e height forem especificadas, o mais restritivo dos dois valores será usado no redimensionamento da imagem. A dimensão máxima permitida para largura e altura é 4.000 pixels.

Se width e height forem especificadas e crop_to_fit for True, o menos restritivo dos dois valores será usado no redimensionamento e a imagem será cortada para se ajustar ao tamanho especificado. Nesse caso, o centro de corte pode ser ajustado por crop_offset_x e crop_offset_y.

Parâmetros
  • image_data: string dos dados da imagem de origem.

  • width: número inteiro da largura, em pixels, usado para alterar a imagem.

  • height: número inteiro da altura, em pixels, usado para alterar a imagem.

  • output_encoding: um valor proveniente de OUTPUT_ENCODING_TYPES.

  • quality: um valor entre 1 e 100 para especificar a qualidade da codificação. Esse valor é usado apenas para controlar a qualidade JPEG.

  • correct_orientation: um valor proveniente de ORIENTATION_CORRECTION_TYPE para indicar se a correção da orientação deve ser executada durante a transformação.

  • crop_to_fit: se for True, e width e height forem especificadas, a imagem será recortada depois de redimensionada para se ajustar às dimensões especificadas.

  • crop_offset_x: valor flutuante entre 0,0 e 1,0. 0 é a esquerda e 1 é a direita. O valor padrão é 0,5, ou o centro da imagem.

  • crop_offset_y: valor flutuante entre 0,0 e 1,0. 0 é a parte superior e 1 é a parte inferior. O valor padrão é 0,5, ou o centro da imagem.

  • allow_stretch: se for True, e a width e a height forem especificadas, a imagem será esticada para se ajustar às dimensões de redimensionamento sem manter a proporção.

  • rpc: um objeto UserRPC opcional.

  • transparent_substitution_rgb: quando os pixels transparentes não forem aceitos no formato de imagem de destino, eles serão substituídos pela cor especificada, que precisa estar no formato RGB de 32 bits.

Retorna

Dados brutos da imagem redimensionada.

Gera
  • TypeError: quando width ou height não são do tipo inteiro ou longo.

  • BadRequestError: quando a width ou a height especificada é inválida.

  • Error: todos os outros erros. Consulte Image.ExecuteTransforms para mais detalhes.

google.appengine.api.images.resize_async(image_data, width=0, height=0, output_encoding=0, quality=None, correct_orientation=0, crop_to_fit=False, crop_offset_x=0.5, crop_offset_y=0.5, allow_stretch=False, rpc=None, transparent_substitution_rgb=None)Fonte

Redimensiona um arquivo de imagem de maneira assíncrona, mantendo a proporção.

Se width e height forem especificadas, o mais restritivo dos dois valores será usado no redimensionamento da imagem. A dimensão máxima permitida para largura e altura é 4.000 pixels.

Se width e height forem especificadas e crop_to_fit for True, o menos restritivo dos dois valores será usado no redimensionamento e a imagem será cortada para se ajustar ao tamanho especificado. Nesse caso, o centro de corte pode ser ajustado por crop_offset_x e crop_offset_y.

Parâmetros
  • image_data: string dos dados da imagem de origem.

  • width: número inteiro da largura, em pixels, usado para alterar a imagem.

  • height: número inteiro da altura, em pixels, usado para alterar a imagem.

  • output_encoding: um valor proveniente de OUTPUT_ENCODING_TYPES.

  • quality: um valor entre 1 e 100 para especificar a qualidade da codificação. Esse valor é usado apenas para controlar a qualidade JPEG.

  • correct_orientation: um valor proveniente de ORIENTATION_CORRECTION_TYPE para indicar se a correção da orientação deve ser executada durante a transformação.

  • crop_to_fit: se for True, e width e height forem especificadas, a imagem será recortada depois de redimensionada para se ajustar às dimensões especificadas.

  • crop_offset_x: valor flutuante entre 0,0 e 1,0. 0 é a esquerda e 1 é a direita. O valor padrão é 0,5, ou o centro da imagem.

  • crop_offset_y: valor flutuante entre 0,0 e 1,0. 0 é a parte superior e 1 é a parte inferior. O valor padrão é 0,5, ou o centro da imagem.

  • allow_stretch: se for True, e a width e a height forem especificadas, a imagem será esticada para se ajustar às dimensões de redimensionamento sem manter a proporção.

  • rpc: um objeto UserRPC opcional.

  • transparent_substitution_rgb: quando os pixels transparentes não forem aceitos no formato de imagem de destino, eles serão substituídos pela cor especificada, que precisa estar no formato RGB de 32 bits.

Retorna

Um objeto UserRPC. Chame get_result() para receber o resultado do RPC.

Gera
  • TypeError: quando width ou height não são do tipo inteiro ou longo.

  • BadRequestError: quando a width ou a height especificada é inválida.

  • Error: todos os outros erros. Consulte Image.ExecuteTransforms para mais detalhes.

google.appengine.api.images.rotate(image_data, degrees, output_encoding=0, quality=None, correct_orientation=0, rpc=None, transparent_substitution_rgb=None)Fonte

Gira uma imagem em um determinado número de graus no sentido horário.

Parâmetros
  • image_data: string dos dados da imagem de origem.

  • degrees: um valor proveniente de ROTATE_DEGREE_VALUES.

  • output_encoding: um valor proveniente de OUTPUT_ENCODING_TYPES.

  • quality: um valor entre 1 e 100 para especificar a qualidade da codificação. Esse valor é usado apenas para controlar a qualidade JPEG.

  • correct_orientation: um valor proveniente de ORIENTATION_CORRECTION_TYPE para indicar se a correção da orientação deve ser executada durante a transformação.

  • rpc: um objeto UserRPC opcional.

  • transparent_substitution_rgb: quando os pixels transparentes não forem aceitos no formato de imagem de destino, eles serão substituídos pela cor especificada, que precisa estar no formato RGB de 32 bits.

Retorna

Dados brutos da imagem girada.

Gera
  • TypeError: quando degrees não é do tipo inteiro ou longo.

  • BadRequestError: quando o valor especificado de degrees é inválido.

  • Error: todos os outros erros. Consulte Image.ExecuteTransforms para mais detalhes.

google.appengine.api.images.rotate_async(image_data, degrees, output_encoding=0, quality=None, correct_orientation=0, rpc=None, transparent_substitution_rgb=None)Fonte

Gira uma imagem de maneira assíncrona em um número especificado de graus no sentido horário.

Parâmetros
  • image_data: string dos dados da imagem de origem.

  • degrees: um valor proveniente de ROTATE_DEGREE_VALUES.

  • output_encoding: um valor proveniente de OUTPUT_ENCODING_TYPES.

  • quality: um valor entre 1 e 100 para especificar a qualidade da codificação. Esse valor é usado apenas para controlar a qualidade JPEG.

  • correct_orientation: um valor proveniente de ORIENTATION_CORRECTION_TYPE para indicar se a correção da orientação deve ser executada durante a transformação.

  • rpc: um objeto UserRPC opcional.

  • transparent_substitution_rgb: quando os pixels transparentes não forem aceitos no formato de imagem de destino, eles serão substituídos pela cor especificada, que precisa estar no formato RGB de 32 bits.

Retorna

Um objeto UserRPC. Chame get_result() para concluir o RPC e conseguir o resultado do corte.

Gera
  • TypeError: quando degrees não é do tipo inteiro ou longo.

  • BadRequestError: quando o valor especificado de degrees é inválido.

  • Error: todos os outros erros. Consulte Image.ExecuteTransforms para mais detalhes.

google.appengine.api.images.vertical_flip(image_data, output_encoding=0, quality=None, correct_orientation=0, rpc=None, transparent_substitution_rgb=None)Fonte

Inverte a imagem verticalmente.

Parâmetros
  • image_data: string dos dados da imagem de origem.

  • output_encoding: um valor proveniente de OUTPUT_ENCODING_TYPES.

  • quality: um valor entre 1 e 100 para especificar a qualidade da codificação. Esse valor é usado apenas para controlar a qualidade JPEG.

  • correct_orientation: um valor proveniente de ORIENTATION_CORRECTION_TYPE para indicar se a correção da orientação deve ser executada durante a transformação.

  • rpc: um objeto UserRPC opcional.

  • transparent_substitution_rgb: quando os pixels transparentes não forem aceitos no formato de imagem de destino, eles serão substituídos pela cor especificada, que precisa estar no formato RGB de 32 bits.

Retorna

Dados brutos da imagem transformada.

Gera

Error: todos os erros. Consulte Image.ExecuteTransforms para mais detalhes.

google.appengine.api.images.vertical_flip_async(image_data, output_encoding=0, quality=None, correct_orientation=0, rpc=None, transparent_substitution_rgb=None)Fonte

Inverte a imagem verticalmente de maneira assíncrona.

Parâmetros
  • image_data: string dos dados da imagem de origem.

  • output_encoding: um valor proveniente de OUTPUT_ENCODING_TYPES.

  • quality: um valor entre 1 e 100 para especificar a qualidade da codificação. Esse valor é usado apenas para controlar a qualidade JPEG.

  • correct_orientation: um valor proveniente de ORIENTATION_CORRECTION_TYPE para indicar se a correção da orientação deve ser executada durante a transformação.

  • rpc: um objeto UserRPC opcional.

  • transparent_substitution_rgb: quando os pixels transparentes não forem aceitos no formato de imagem de destino, eles serão substituídos pela cor especificada, que precisa estar no formato RGB de 32 bits.

Retorna

Um objeto UserRPC. Chame get_result() para concluir o RPC e conseguir o resultado do corte.

Gera

Error: todos os erros. Consulte Image.ExecuteTransforms para mais detalhes.

Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Ambiente padrão do App Engine para Python 2