TImageCropper

O TImageCropper é um componente para carregar e cortar imagens (derivado da classe TField). Ele permite ajustes finos e manipulações, como zoom, rotação e escala.

__construct

Construtor da classe TImageCropper.

Parâmetros:

Exemplo de código:

$cortadorImagem = new TImageCropper('imagemPerfil');

setSize

Define o tamanho do campo de entrada para o carregador de imagens.

Parâmetros:

Exemplo de código:

$cortadorImagem = new TImageCropper('imagemPerfil');
$cortadorImagem->setSize(320, 180);

getSize

Retorna as dimensões do campo de entrada.

Exemplo de código:

$cortadorImagem = new TImageCropper('imagemPerfil');
$cortadorImagem->setSize(256, 144);
$tamanho = $cortadorImagem->getSize(); // (256, 144)

setValue

Define o valor inicial da imagem, podendo ser uma URL ou uma imagem em base64.

Parâmetros:

Exemplo de código:

$cortadorImagem = new TImageCropper('imagemPerfil');
$cortadorImagem->setValue('caminho/para/imagem.jpg');

setImagePlaceholder

Define uma imagem de placeholder.

Parâmetros:

Exemplo de código:

$cortadorImagem = new TImageCropper('imagemPerfil');
$cortadorImagem->setImagePlaceholder(new TImage('caminho/para/placeholder.png'));

setWindowTitle

Define o título da janela do cortador de imagem.

Parâmetros:

Exemplo de código:

$cortadorImagem = new TImageCropper('imagemPerfil');
$cortadorImagem->setWindowTitle('Ajuste sua Imagem');

setButtonLabel

Define o texto do botão de corte.

Parâmetros:

Exemplo de código:

$cortadorImagem = new TImageCropper('imagemPerfil');
$cortadorImagem->setButtonLabel('Cortar Imagem');

setAspectRatio

Define a proporção da área de corte.

Parâmetros:

Exemplo de código:

$cortadorImagem = new TImageCropper('imagemPerfil');
$cortadorImagem->setAspectRatio(9/16);

Ou utilizando uma das proporções pré-configuradas (16/9, 4/3, 1/1 e 2/3):

$cortadorImagem = new TImageCropper('imagemPerfil');
$cortadorImagem->setAspectRatio(TImageCropper::CROPPER_RATIO_16_9);

enableBase64

Ativa o suporte para imagens em formato base64.

Exemplo de código:

$cortadorImagem = new TImageCropper('imagemPerfil');
$cortadorImagem->enableBase64();

enableWebCam

Ativa o suporte para captura de imagens diretamente da webcam.

Exemplo de código:

$cortadorImagem = new TImageCropper('imagemPerfil');
$cortadorImagem->enableWebCam();

setAllowedExtensions

Define as extensões de arquivo permitidas para o upload.

Parâmetros:

Exemplo de código:

$cortadorImagem = new TImageCropper('imagemPerfil');
$cortadorImagem->setAllowedExtensions(['jpg', 'png']);

getAllowedExtensions

Obtém as extensões de arquivo permitidas.

Exemplo de código:

$cortadorImagem = new TImageCropper('imagemPerfil');
$cortadorImagem->setAllowedExtensions(['jpg', 'jpeg', 'png']);
$extensoesPermitidas = $cortadorImagem->getAllowedExtensions();

enableFileHandling

Ativa o manuseio de arquivos no componente.

Exemplo de código:

$cortadorImagem = new TImageCropper('imagemPerfil');
$cortadorImagem->enableFileHandling();

disableButtonsDrag

Desativa os botões de arrastar no componente.

Exemplo de código:

$cortadorImagem = new TImageCropper('imagemPerfil');
$cortadorImagem->disableButtonsDrag();

disableButtonsZoom

Desativa os botões de zoom no componente.

Exemplo de código:

$cortadorImagem = new TImageCropper('imagemPerfil');
$cortadorImagem->disableButtonsZoom();

disableButtonsScale

Desativa os botões de escala no componente.

Exemplo de código:

$cortadorImagem = new TImageCropper('imagemPerfil');
$cortadorImagem->disableButtonsScale();

disableButtonReset

Desativa o botão de reset no componente.

Exemplo de código:

$cortadorImagem = new TImageCropper('imagemPerfil');
$cortadorImagem->disableButtonReset();

disableButtonsRotate

Desativa os botões de rotação no componente.

Exemplo de código:

$cortadorImagem = new TImageCropper('imagemPerfil');
$cortadorImagem->disableButtonsRotate();

setCropSize

Define o tamanho da área de corte.

Parâmetros:

Exemplo de código:

$cortadorImagem = new TImageCropper('imagemPerfil');
$cortadorImagem->setCropSize(300, 200);

setService

Define a classe de serviço para lidar com o upload de imagens.

Parâmetros:

Exemplo de código:

$cortadorImagem = new TImageCropper('imagemPerfil');
$cortadorImagem->setService('ImageUploadService');

getOptions

Retorna as opções específicas do componente em formato JSON.

Exemplo de código:

$cortadorImagem = new TImageCropper('imagemPerfil');
$opcoes = $cortadorImagem->getOptions();