Processamento de Imagem e GD

Introdução

O PHP não está limitado a criar apenas saída em HTML. Ele também pode ser usado para criar e manipular arquivos de imagem em uma diversidade de formatos, incluindo GIF, PNG, JPEG, WBMP, e XPM. E ainda mais convenientemente, o PHP pode enviar fluxos de imagem diretamente para o navegador. É necessário compilar o PHP com a biblioteca GD de funções de imagens para que isto funcione. GD e o PHP podem também requerer outras bibliotecas, dependendo de quais formatos de imagens serão trabalhados.

Pode-se usar as funções de imagem no PHP para obter o tamanho de imagens JPEG, GIF, PNG, SWF, TIFF e JPEG2000.

Com a extensão exif, pode-se trabalhar com informações armazenadas nos cabeçalhos de imagens JPEG e TIFF. Desta forma, pode-se ler metadados gerados por câmeras digitais. As funções exif não requerem a biblioteca GD.

Nota: Leia a seção de requerimentos sobre como expandir a capacidade de leitura, escrita e modificação de imagens. Para ler metadados de fotografias tiradas de uma câmera digital, é necessária a extensão exif mencionada acima.

Nota: A função getimagesize() não requqer a extensão GD.

Cuidado

Enquanto que a versão da biblioteca GD fornecida com o PHP usa o gerenciador de memória Zend para alocar memória, as versões de sistema não o fazem, de forma que memory_limit não se aplica.

GD suporta uma diversidade de formatos. Veja abaixo uma lista de formatos suportados por GD e notas sobre suas disponibilidades incluindo suporte a leitura/escrita.

Formatos suportados por GD

Formato Suporte a leitura Suporte a escrita Notas

JPEG true true

PNG true true

GIF true true

XBM true true

XPM true false

WBMP true true

WebP true true

BMP true true Disponível a partir do PHP 7.2.0

**Formatos suportados por GD**
Formato	Suporte a leitura	Suporte a escrita	Notas
JPEG	`true`	`true`
PNG	`true`	`true`
GIF	`true`	`true`
XBM	`true`	`true`
XPM	`true`	`false`
WBMP	`true`	`true`
WebP	`true`	`true`
BMP	`true`	`true`	Disponível a partir do PHP 7.2.0

Embora a maioria dos formatos esteja disponível para leitura e escrita na tabela acima, isto não significa que o PHP foi compilado com suporte a eles. Para descobrir quais formatos estavam disponíveis para o GD durante a compilação, use a função gd_info(). Para mais informação sobre compilação de suporte a um ou mais formantos, consulte o capítulo sobre instalação.

Instalação/Configuração
Constantes predefinidas
Exemplos
Funções de GD e Image
- gd_info — Obtém informações sobre a biblioteca GD instalada atualmente
- getimagesize — Obtém o tamanho de uma imagem
- getimagesizefromstring — Obtém o tamanho de uma imagem a partir de uma string
- image_type_to_extension — Obtém a extensão de arquivo para o tipo da imagem
- image_type_to_mime_type — Obtém o Mime-Type para o tipo de imagem retornado por getimagesize, exif_read_data, exif_thumbnail e exif_imagetype
- image2wbmp — Envia a imagem para o navegador ou para um arquivo
- imageaffine — Retorna uma imagem contendo a imagem fonte com transformação afim, usando uma área de recorte opcional
- imageaffinematrixconcat — Concatena duas matrizes de transformação afim
- imageaffinematrixget — Obtém uma matriz de transformação afim
- imagealphablending — Define o modo de combinação para uma imagem
- imageantialias — Define se as funções de suavização de serrilhado devem ser usadas ou não
- imagearc — Desenha um arco
- imageavif — Envia a imagem para o navegador ou para um arquivo
- imagebmp — Mostra ou grava uma imagem BMP
- imagechar — Desenha um caractere horizontalmente
- imagecharup — Desenha um caractere verticalmente
- imagecolorallocate — Aloca uma cor para uma imagem
- imagecolorallocatealpha — Aloca uma cor para uma imagem
- imagecolorat — Obtém o índica da cor de um pixel
- imagecolorclosest — Obtém o índice da cor mais próxima à especificada
- imagecolorclosestalpha — Obtém o índice da cor mais próxima à especificada (incluindo alfa)
- imagecolorclosesthwb — Obtém o índice da cor que tem a matiz, brancura e negritude mais próximas de uma cor informada
- imagecolordeallocate — Desaloca uma cor de uma imagem
- imagecolorexact — Obtém o índice da cor especificada
- imagecolorexactalpha — Obtém o índice da cor e alfa especificados
- imagecolormatch — Faz com que as cores da versão em paleta da imagem fiquem mais próximas da versão em cores verdadeiras
- imagecolorresolve — Obtém o índice da cor especificada ou a alternativa mais próxima
- imagecolorresolvealpha — Obtém o índice da cor + alfa especificados ou a alternativa mais próxima
- imagecolorset — Define a cor para o índice da paleta especificado
- imagecolorsforindex — Obtém as cores para um índice
- imagecolorstotal — Obtém o número de cores em uma paleta de imagem
- imagecolortransparent — Define uma cor como transparente
- imageconvolution — Aplica uma matriz de convolução 3x3, usando coeficiente e deslocamento
- imagecopy — Copia uma parte de uma imagem
- imagecopymerge — Copia e funde parte de uma imagem
- imagecopymergegray — Copia e funde parte de uma imagem com escala de cinza
- imagecopyresampled — Copia e redimensiona parte de uma imagem com reamostragem
- imagecopyresized — Copia e redimensiona parte de uma imagem
- imagecreate — Crie uma nova imagem baseada em paleta
- imagecreatefromavif — Cria uma nova imagem a partir de um arquivo ou URL
- imagecreatefrombmp — Cria uma nova imagem a partir de um arquivo ou URL
- imagecreatefromgd — Cria uma nova imagem a partir de um arquivo GD ou URL
- imagecreatefromgd2 — Cria uma nova imagem a partir de um arquivo GD2 ou URL
- imagecreatefromgd2part — Cria uma nova imagem a partir de uma parte de um arquivo GD2 ou URL
- imagecreatefromgif — Cria uma nova imagem a partir de um arquivo ou URL
- imagecreatefromjpeg — Cria uma nova imagem a partir de um arquivo ou URL
- imagecreatefrompng — Cria uma nova imagem a partir de um arquivo ou URL
- imagecreatefromstring — Cria uma nova imagem a partir de um fluxo de imagem na string
- imagecreatefromtga — Cria uma nova imagem a partir de um arquivo ou URL
- imagecreatefromwbmp — Cria uma nova imagem a partir de um arquivo ou URL
- imagecreatefromwebp — Cria uma nova imagem a partir de um arquivo ou URL
- imagecreatefromxbm — Cria uma nova imagem a partir de um arquivo ou URL
- imagecreatefromxpm — Cria uma nova imagem a partir de um arquivo ou URL
- imagecreatetruecolor — Cria uma nova imagem em cores verdadeiras
- imagecrop — Recorta uma imagem no retângulo informado
- imagecropauto — Recorta uma imagem automaticamente usando um dos modos disponíveis
- imagedashedline — Desenha uma linha tracejada
- imagedestroy — Destrói uma imagem
- imageellipse — Desenha uma elipse
- imagefill — Preenchimento
- imagefilledarc — Desenha um arco parcial preenchido
- imagefilledellipse — Desenha uma elipse preenchida
- imagefilledpolygon — Desenha um polígono preenchido
- imagefilledrectangle — Desenha um retângulo preenchido
- imagefilltoborder — Preenche até encontrar uma cor especificada
- imagefilter — Aplica um filtro a uma imagem
- imageflip — Vira uma imagem usando um modo especificado
- imagefontheight — Obtém a altura da fonte
- imagefontwidth — Obtém a largura da fonte
- imageftbbox — Fornece a caixa limite de um texto usando fontes via freetype2
- imagefttext — Escreve texto em uma imagem usando fontes FreeType 2
- imagegammacorrect — Aplica uma correção de gama a uma imagem GD
- imagegd — Envia uma imagem GD para o navegador ou para um arquivo
- imagegd2 — Envia uma imagem GD2 ao navegador ou a um arquivo
- imagegetclip — Obtém o retângulo de recorte
- imagegetinterpolation — Obtém o método de interpolação
- imagegif — Envia a imagem para o navegador ou para um arquivo
- imagegrabscreen — Captura toda a tela
- imagegrabwindow — Captura uma janela
- imageinterlace — Habilita ou desabilita entrelace
- imageistruecolor — Descobre se uma imagem está em cores verdadeiras
- imagejpeg — Envia a imagem para o navegador ou para um arquivo
- imagelayereffect — Define a opção de mesclagem alfa para usar efeitos de camada
- imageline — Desenha uma linha
- imageloadfont — Carrega uma nova fonte
- imageopenpolygon — Desenha um polígono aberto
- imagepalettecopy — Copia a paleta de uma imagem para outra
- imagepalettetotruecolor — Converte uma imagem baseada em paleta para cores verdadeiras
- imagepng — Envia uma imagem PNG para o navegador ou arquivo
- imagepolygon — Desenha um polígono
- imagerectangle — Desenha um retângulo
- imageresolution — Obtém ou define a resolução da imagem
- imagerotate — Rotaciona uma imagem em um ângulo informado
- imagesavealpha — Informa se a informação de canal alfa deve ser retida ao gravar imagens
- imagescale — Muda a escala de uma imagem usando largura e altura informadas
- imagesetbrush — Define o tipo de pincel para desenho de linhas
- imagesetclip — Define o retângulo de recorte
- imagesetinterpolation — Define o método de interpolação
- imagesetpixel — Desenha um pixel
- imagesetstyle — Define o estilo para desenho de linhas
- imagesetthickness — Define a espessura para desenho de linhas
- imagesettile — Define a imagem de ladrilho para preenchimento
- imagestring — Desenha uma string na horizontal
- imagestringup — Desenha uma string na vertical
- imagesx — Obtém a largura da imagem
- imagesy — Obtém a altura da imagem
- imagetruecolortopalette — Converte uma imagem em cores verdadeiras em uma imagem de paleta
- imagettfbbox — Fornece a os limites retangulares de um texto usando fontes TrueType
- imagettftext — Escreve texto na imagem usando fontes TrueType
- imagetypes — Retorna os tipos de imagens suportados pela instalação do PHP
- imagewbmp — Envia a imagem para o navegador ou para um arquivo
- imagewebp — Mostra uma imagem WebP no navegador ou grava em arquivo
- imagexbm — Mostra uma imagem XBM em um navegador ou grava em arquivo
- iptcembed — Incorpora dados binários IPTC em uma imagem JPEG
- iptcparse — Interpreta um bloco IPTC binário em etiquetas simples
- jpeg2wbmp — Converte arquivo de imagem JPEG para WBMP
- png2wbmp — Converte arquivo de imagem PNG em WBMP
GdImage — A classe GdImage
GdFont — A classe GdFont