Image

class AeonDigital\Tools\Image
Coleção de métodos estáticos para a manipulação de imagens.

Methods

public static AeonDigital\Tools\Image::transform($absoluteSystemPathToOriginalImage, $absoluteSystemPathToNewImage=null, $resizeType="auto", $imgMaxWidth=null, $imgMaxHeight=null, $imgCrop=null, $imgCropWidth=null, $imgCropHeight=null, $imgCropX=null, $imgCropY=null)
Efetua a transformação de uma imagem conforme os parametros de configuração.
Parameters:
  • ‹ string › $absoluteSystemPathToOriginalImage
    Caminho completo até a imagem.

  • ‹ string › $absoluteSystemPathToNewImage
    Caminho completo até o local onde a nova imagem será armazenada. Se não for definido a imagem original será alterada.

  • ‹ string › $resizeType
    Tipo de ajuste que será feito.

    Os seguintes valores são aceitos:

    exact : redimenciona a imagem exatamente na medida definida em $imgMaxWidth e $imgMaxHeight. Se um deste valores não for definido, manterá o valor inicial da imagem.

    portrait : redimensiona (verticalmente) a imagem parando quando encontra chegar na altura máxima definida em $imgMaxHeight.

    landscape : redimensiona (horizontalmente) a imagem parando quando encontra chegar na largura máxima definida em $imgMaxWidth.

    auto : redimensiona a imagem até que uma das dimensões encontre um dos valores máximos definidos por $imgMaxWidth e $imgMaxHeight.

  • ‹ ?int › $imgMaxWidth
    Largura máxima que a imagem deverá ter. Se não for definido, este valor será calculado conforme o tipo $resizeType.

  • ‹ ?int › $imgMaxHeight
    Altura máxima que a imagem deverá ter. Se não for definido, este valor será calculado conforme o tipo $resizeType.

  • ‹ ?bool › $imgCrop
    Quando true, irá, após redimencionar a imagem, efetuar um crop(corte) na imagem resultante e salvará este corte ao invés da imagem como um todo.

    Para evitar que um crop exceda os limites de uma imagem que será redimencionada por um método dinâmico (portrait | landscape | auto) é recomendavel, mas não obrigatório, que esta opção seja usada em conjunto com o método exact.

  • ‹ ?int › $imgCropWidth
    Largura do crop que será feito. Apenas surte efeito se $resizeType for definido como crop.

  • ‹ ?int › $imgCropHeight
    Altura do crop que será feito. Apenas surte efeito se $resizeType for definido como crop.

  • ‹ ?int › $imgCropX
    Posição no eixo X a partir de onde o corte da imagem deve ocorrer. Apenas surte efeito se $resizeType for definido como crop.

  • ‹ ?int › $imgCropY
    Posição no eixo Y a partir de onde o corte da imagem deve ocorrer. Apenas surte efeito se $resizeType for definido como crop.

Returns:

‹ bool ›

public static AeonDigital\Tools\Image::resize($absoluteSystemPathToOriginalImage, $absoluteSystemPathToNewImage=null, $resizeType="auto", $imgMaxWidth=null, $imgMaxHeight=null)
Efetua o redimensionamento de uma imagem conforme os parametros de configuração.
Parameters:
  • ‹ string › $absoluteSystemPathToOriginalImage
    Caminho completo até a imagem.

  • ‹ string › $absoluteSystemPathToNewImage
    Caminho completo até o local onde a nova imagem será armazenada. Se não for definido a imagem original será alterada.

  • ‹ string › $resizeType
    Tipo de ajuste que será feito.

    Os seguintes valores são aceitos:

    exact : redimenciona a imagem exatamente na medida definida em $imgMaxWidth e $imgMaxHeight. Se um deste valores não for definido, manterá o valor inicial da imagem.

    portrait : redimensiona (verticalmente) a imagem parando quando encontra chegar na altura máxima definida em $imgMaxHeight.

    landscape : redimensiona (horizontalmente) a imagem parando quando encontra chegar na largura máxima definida em $imgMaxWidth.

    auto : redimensiona a imagem até que uma das dimensões encontre um dos valores máximos definidos por $imgMaxWidth e $imgMaxHeight.

  • ‹ ?int › $imgMaxWidth
    Largura máxima que a imagem deverá ter. Se não for definido, este valor será calculado conforme o tipo $resizeType.

  • ‹ ?int › $imgMaxHeight
    Altura máxima que a imagem deverá ter. Se não for definido, este valor será calculado conforme o tipo $resizeType.

Returns:

‹ bool ›

public static AeonDigital\Tools\Image::crop($absoluteSystemPathToOriginalImage, $absoluteSystemPathToNewImage=null, $imgCropWidth=null, $imgCropHeight=null, $imgCropX=null, $imgCropY=null)
Efetua o crop de uma imagem conforme os parametros de configuração.
Parameters:
  • ‹ string › $absoluteSystemPathToOriginalImage
    Caminho completo até a imagem.
  • ‹ string › $absoluteSystemPathToNewImage
    Caminho completo até o local onde a nova imagem será armazenada. Se não for definido a imagem original será alterada.
  • ‹ ?int › $imgCropWidth
    Largura do crop que será feito. Apenas surte efeito se $resizeType for definido como crop.
  • ‹ ?int › $imgCropHeight
    Altura do crop que será feito. Apenas surte efeito se $resizeType for definido como crop
  • ‹ ?int › $imgCropX
    Posição no eixo X a partir de onde o corte da imagem deve ocorrer. Apenas surte efeito se $resizeType for definido como crop
  • ‹ ?int › $imgCropY
    Posição no eixo Y a partir de onde o corte da imagem deve ocorrer. Apenas surte efeito se $resizeType for definido como crop
Returns:

‹ bool ›