Manipulando e redimensionando imagens com PHP
Este artigo está desatualizado. Confira aqui a nova versão da classe.
Quem nunca precisou desenvolver uma galeria de imagens? Ou até mesmo um simples módulo para destaques de um site, com o redimensionamento automático de fotos para a capa? Manipulação de imagens é uma das tarefas mais comuns em sistemas web e pode vir a ser uma tarefa chata caso toda vez você tenha que reinventar a roda e reescrever dezenas de linha de código para adequar a manipulação aos desejos do cliente.
Neste post apresento uma classe desenvolvida na agência web M2BRNET, exclusivamente para o tratamento e manipulação de imagens utilizando PHP e sua extensão GD.
A classe, apelidada de m2brimagem, ainda está em seu estágio inicial, mas já possui métodos para redimensionamento e conversão de formatos, entre outros. Algumas funções foram reaproveitadas e todos os devidos créditos acompanham o arquivo fonte.
Pré-requisitos
Para utilizar a classe, será necessário o download de sua última versão no link abaixo além de um servidor com php instalado com suporte à biblioteca GD.
Exemplo 1
Agora vamos ao que interessa! Neste primeiro exemplo realizaremos um redimensionamento simples, mantendo a proporção da imagem com a opção crop.
teste.php
O primeiro passo é instanciar o objeto da classe imagem, carregando no construtor a imagem que será manipulada:
Logo na sequência validamos a imagem através do método valida. Caso o resultado seja ‘OK’, executamos os métodos para redimensionamento e geramos a nova imagem com saída no navegador. Se a imagem não existir, ou simplesmente não for um arquivo de imagem, o script retornará a mensagem de erro.
Exemplo 2
Vamos agora dar uma leve incrementada em nosso arquivo teste.php, fazendo com que ele passe a receber via parâmetros as novas dimensões da imagem e o nome do arquivo, permitindo assim o redimensionamento on the fly:
A imagem abaixo está sendo redimensionada em tempo real utilizando o exemplo anterior (confira aqui a imagem original).
Exemplo 3
E que tal varrer todo um diretório, criar thumbnails e ao mesmo tempo manter as imagens originais? Alguém aí falou em galeria de imagens?
Voilá! No exemplo acima, o script varre o subdiretório galeria, procura por arquivos do tipo JPG e cria suas miniaturas dentro de galeria/thumbs/.
Exemplos rápidos
Confira alguns outros métodos da classe m2brimagem em ação:
Marca d’água
Flip
Texto / legenda
Como citei no início deste post, a classe ainda está em um estágio inicial do desenvolvimento. Diversas melhorias já estão na nossa lista. Para participar e acompanhar o desenvolvimento, enviar comentários, dúvidas e correções, acesse a página do projeto no Google Code.
Atualizações [26/11/2008]
O leitor Giolvani enviou uma implementação de um método para adicionar marcas d’dágua com posicionamento fixo. Segue o exemplo de uso:
Já nosso amigo CACA-[COBRA] identificou um bug no método de marcas d’água. O parâmetro alfa não estava funcionando corretamente. Na verdade, trata-se de uma limitação da biblioteca GD. Para utilizar transparência na marca d’água, é necessário usar a função imagecopymerge ao invés da imagecopy. O problema é que ela não preserva a transparência original do PNG.
A correção que fiz foi a seguinte: caso você passe um valor para alfa, a classe utilizará a imagecopymerge para criar a marca, gerando uma trasparêcia global para a imagem, mas perdendo o fundo (ou qualquer outra parte) transparente da imagem de marca original. Caso opte por preservar esta transparência original, basta passar o valor de alfa como nulo.
Finalizando, também foram corrigidos alguns bugs, incluindo um que afetava a qualidade de imagens JPEG quando a saída era direta no navegador. O método resize (redimensionamento sem especificar crop ou fill) também foi alterado: agora seu redimensionamento não preserva a proporção, distorcendo a imagem se necessário - para manter a proporção passe somente a altura ou largura.
Atualizações [26/02/2010]
Finalmente dei uma revisada no código. Nessa atualização melhorei alguns métodos e criei duas novas funcionalidades: redimensionamento com porcentagem e crop com as posições x e y definidas manualmente.
Para redimensionar com porcentagem, basta passar a largura ou a altura com o símbolo de %. Por exemplo:
Para definir as posições X e Y do crop na imagem (o padrão é centralizar o crop), utilize o novo método posicaoCrop:
E, por último, a propriedade RGB para preenchimento agora é armazenada via método, recebendo como parâmetro os valores R, G e B (o padrão é 0, 0 e 0 - preto):