Funzioni di immagine

La classe Nette\Utils\Image semplifica la manipolazione delle immagini, come il ridimensionamento, il ritaglio, la nitidezza, il disegno o la fusione di più immagini.

PHP dispone di un'ampia serie di funzioni per la manipolazione delle immagini. Ma l'API non è molto bella. Non sarebbe un Neat Framework a proporre un'API sexy.

Installazione:

composer require nette/utils

Gli esempi seguenti presuppongono che sia stato definito il seguente alias di classe:

use Nette\Utils\Image;
use Nette\Utils\ImageColor;
use Nette\Utils\ImageType;

Creare un'immagine

Creeremo una nuova immagine a colori reali, ad esempio con dimensioni 100×200:

$image = Image::fromBlank(100, 200);

Opzionalmente, è possibile specificare un colore di sfondo (l'impostazione predefinita è il nero):

$image = Image::fromBlank(100, 200, ImageColor::rgb(125, 0, 0));

Oppure si carica l'immagine da un file:

$image = Image::fromFile('nette.jpg');

Salvare l'immagine

L'immagine può essere salvata in un file:

$image->save('resampled.jpg');

È possibile specificare la qualità di compressione nell'intervallo 0..100 per JPEG (valore predefinito 85), WEBP (valore predefinito 80) e AVIF (valore predefinito 30) e 0..9 per PNG (valore predefinito 9):

$image->save('resampled.jpg', 80); // JPEG, qualità 80%

Se il formato non è evidente dall'estensione del file, può essere specificato con una costante:

$image->save('resampled.tmp', null, ImageType::JPEG);

L'immagine può essere scritta in una variabile invece che su disco:

$data = $image->toString(ImageType::JPEG, 80); // JPEG, quality 80%

o inviare direttamente al browser con l'intestazione HTTP appropriata Content-Type:

// invia l'intestazione Content-Type: image/png
$image->send(ImageType::PNG);

Formati

I formati supportati sono JPEG, PNG, GIF, WebP, AVIF e BMP. Tuttavia, devono essere supportati anche dalla versione di PHP in uso, il che può essere verificato con la funzione isTypeSupported(). Le animazioni non sono supportate.

I formati sono rappresentati dalle costanti ImageType::JPEG, ImageType::PNG, ImageType::GIF, ImageType::WEBP, ImageType::AVIF e ImageType::BMP.

$supported = Image::isTypeSupported(ImageType::JPEG);

È necessario rilevare il formato di un'immagine al momento del caricamento? Il metodo lo restituisce nel secondo parametro:

$image = Image::fromFile('nette.jpg', $type);

Il rilevamento effettivo senza caricare l'immagine viene eseguito da Image::detectTypeFromFile().

Ridimensionamento dell'immagine

Un'operazione comune è il ridimensionamento di un'immagine. Le dimensioni correnti sono restituite dai metodi getWidth() e getHeight().

Per il ridimensionamento viene utilizzato il metodo resize(). Questo è un esempio di modifica proporzionale delle dimensioni, in modo che non superi i 500×300 pixel (o la larghezza sarà esattamente 500px o l'altezza sarà esattamente 300px, una delle dimensioni è calcolata per mantenere il rapporto di aspetto):

$image->resize(500, 300);

È possibile impostare solo una dimensione e la seconda verrà calcolata:

$image->resize(500, null); // larghezza 500px, altezza auto

$image->resize(null, 300); // larghezza auto, altezza 300px

Qualsiasi dimensione può essere specificata in percentuale:

$image->resize('75%', 300); // 75% × 300px

Il comportamento di resize può essere influenzato dai seguenti flag. Tutti, tranne Image::Stretch, conservano il rapporto d'aspetto.

Flag Descrizione
Image::OrSmaller (default) le dimensioni risultanti saranno minori o uguali a quelle specificate
Image::OrBigger riempie l'area di destinazione ed eventualmente la estende in una direzione
Image::Cover riempie l'intera area e taglia ciò che la supera
Image::ShrinkOnly si limita a ridimensionare (non estende un'immagine piccola)
Image::Stretch non mantiene il rapporto d'aspetto

I flag vengono passati come terzo argomento della funzione:

$image->resize(500, 300, Image::OrBigger);

I flag possono essere combinati:

$image->resize(500, 300, Image::ShrinkOnly | Image::Stretch);

Le immagini possono essere capovolte verticalmente o orizzontalmente specificando una delle dimensioni (o entrambe) come numero negativo:

$flipped = $image->resize(null, '-100%'); // flip verticale

$flipped = $image->resize('-100%', '-100%'); // ruota di 180°

$flipped = $image->resize(-125, 500); // ridimensionamento e capovolgimento orizzontale

Dopo aver ridotto l'immagine, possiamo migliorarla con la nitidezza:

$image->sharpen();

Ritaglio

Il metodo crop() è utilizzato per le coltivazioni:

$image->crop($left, $top, $width, $height);

Come per resize(), tutti i valori possono essere specificati in percentuale. Le percentuali per $left e $top sono calcolate dallo spazio rimanente, in modo simile alla proprietà CSS background-position:

$image->crop('100%', '50%', '80%', '80%');

L'immagine può anche essere ritagliata automaticamente, ad esempio ritagliando i bordi neri:

$image->cropAuto(IMG_CROP_BLACK);

Il metodo cropAuto() è un oggetto che incapsula la funzione imagecropauto(); per ulteriori informazioni, consultare la relativa documentazione.

Colori

Il metodo ImageColor::rgb() consente di definire un colore utilizzando i valori rosso, verde e blu (RGB). Opzionalmente, si può anche specificare un valore di trasparenza che va da 0 (completamente trasparente) a 1 (completamente opaco), proprio come nei CSS.

$color = ImageColor::rgb(255, 0, 0); // Red
$transparentBlue = ImageColor::rgb(0, 0, 255, 0.5); // Semi-transparent blue

Il metodo ImageColor::hex() consente di definire un colore utilizzando il formato esadecimale, come nei CSS. Supporta i formati #rgb, #rrggbb, #rgba e #rrggbbaa:

$color = ImageColor::hex("#F00"); // Red
$transparentGreen = ImageColor::hex("#00FF0080"); // Semi-transparent green

I colori possono essere utilizzati in altri metodi, come ellipse(), fill(), ecc.

Disegno e modifica

Si può disegnare, si può scrivere, si possono usare tutte le funzioni PHP per la manipolazione delle immagini, vedi Panoramica dei metodi, ma in un involucro orientato agli oggetti:

$image->filledEllipse($centerX, $centerY, $width, $height, ImageColor::rgb(255, 0, 0));

Poiché le funzioni PHP per disegnare i rettangoli sono poco pratiche a causa della necessità di specificare le coordinate, la classe Image le sostituisce con le funzioni rectangleWH() e filledRectangleWH().

Unire più immagini

È possibile inserire facilmente un'altra immagine nell'immagine:

$logo = Image::fromFile('logo.png');
$blank = Image::fromBlank(320, 240, ImageColor::rgb(52, 132, 210));

// le coordinate possono essere impostate anche in percentuale
$blank->place($logo, '80%', '80%'); // vicino all'angolo destro in basso

Quando si incolla, il canale alfa viene rispettato; inoltre, possiamo influenzare la trasparenza dell'immagine inserita (creeremo una cosiddetta filigrana):

$blank->place($image, '80%', '80%', 25); // la trasparenza è del 25%.

Questa API è davvero un piacere da usare, non è vero?

Panoramica dei metodi

static fromBlank (int $width, int $height, ?ImageColor $color=null)Image

Crea una nuova immagine a colori reali delle dimensioni indicate. Il colore predefinito è il nero.

static fromFile (string $file, int &$detectedFormat=null)Image

Legge un'immagine da un file e ne restituisce il tipo in $detectedFormat.

static fromString (string $s, int &$detectedFormat=null)Image

Legge un'immagine da una stringa e ne restituisce il tipo in $detectedFormat.

static rgb (int $red, int $green, int $blue, int $transparency=0)array

Questa funzione è stata sostituita dalla classe ImageColor, vedi colori.

static typeToExtension (int $type)string

Restituisce l'estensione del file per il tipo dato.

static typeToMimeType (int $type)string

Restituisce il tipo di mime per il tipo dato.

static extensionToType (string $extension)int

Restituisce il tipo di immagine in base all'estensione del file.

static detectTypeFromFile (string $file, int &$width=null, int &$height=null)?int

Restituisce il tipo di file immagine e nei parametri $width e $height anche le sue dimensioni.

static detectTypeFromString (string $s, int &$width=null, int &$height=null)?int

Restituisce il tipo di immagine dalla stringa e nei parametri $width e $height anche le sue dimensioni.

static isTypeSupported (int $type)bool

Determina se il tipo di immagine dato è supportato.

static getSupportedTypes(): array

Restituisce un array di tipi di immagine supportati (costanti ImageType::XXX).

static calculateTextBox (string $text, string $fontFile, float $size, float $angle=0, array $options=[])array

Calcola le dimensioni del rettangolo che racchiude il testo in un font e in una dimensione specificati. Restituisce un array associativo contenente le chiavi left, top, width, height. Il margine sinistro può essere negativo se il testo inizia con una sporgenza a sinistra.

affine (array $affine, ?array $clip=null)Image

Restituisce un'immagine contenente l'immagine src trasformata affine, utilizzando un'area di ritaglio opzionale. (altro).

affineMatrixConcat (array $m1, array $m2)array

Restituisce la concatenazione di due matrici di trasformazione affine, utile se si vogliono applicare più trasformazioni alla stessa immagine in una sola volta. (altro)

affineMatrixGet (int $type, ?mixed $options=null)array

Restituisce una matrice di trasformazione affine. (altro)

alphaBlending (bool $on)void

Consente di disegnare in due modi diversi sulle immagini truecolor. In modalità di fusione, la componente del canale alfa del colore fornito a tutte le funzioni di disegno, come ad esempio setPixel(), determina la quantità di colore sottostante da lasciar trasparire. Di conseguenza, fonde automaticamente il colore esistente in quel punto con il colore del disegno e memorizza il risultato nell'immagine. Il pixel risultante è opaco. In modalità non sfumata, il colore del disegno viene copiato letteralmente con le informazioni del suo canale alfa, sostituendo il pixel di destinazione. La modalità di fusione non è disponibile quando si disegna sulle immagini della tavolozza. (altro)

antialias (bool $on): void

Attivare i metodi di disegno rapido antialias per linee e poligoni cablati. Non supporta i componenti alfa. Funziona con un'operazione di miscelazione diretta. Funziona solo con immagini in vero colore.

L'uso di primitive con antialias e colore di sfondo trasparente può portare a risultati inaspettati. Il metodo blend utilizza il colore di sfondo come qualsiasi altro colore. La mancanza del supporto per i componenti alfa non consente un metodo di antialiasing basato su alfa. (altro)

arc (int $centerX, int $centerY, int $width, int $height, int $startAngle, int $endAngle, ImageColor $color)void

Disegna un arco di cerchio centrato sulle coordinate date. (altro)

colorAllocate (int $red, int $green, int $blue)int

Restituisce un identificatore di colore che rappresenta il colore composto dalle componenti RGB indicate. Deve essere richiamato per creare ogni colore da utilizzare nell'immagine. (altro)

colorAllocateAlpha (int $red, int $green, int $blue, int $alpha)int

Si comporta in modo identico a colorAllocate() con l'aggiunta del parametro di trasparenza $alpha. (altro)

colorAt (int $x, int $y)int

Restituisce l'indice del colore del pixel nella posizione specificata dell'immagine. Se l'immagine è a colori, questa funzione restituisce il valore RGB del pixel come numero intero. Utilizzare il bitshifting e il mascheramento per accedere ai valori distinti dei componenti rosso, verde e blu: (continua)

colorClosest (int $red, int $green, int $blue)int

Restituisce l'indice del colore nella tavolozza dell'immagine più “vicino” al valore RGB specificato. La “distanza” tra il colore desiderato e ciascun colore della tavolozza viene calcolata come se i valori RGB rappresentassero dei punti nello spazio tridimensionale. (altro)

colorClosestAlpha (int $red, int $green, int $blue, int $alpha)int

Restituisce l'indice del colore nella tavolozza dell'immagine più “vicino” al valore RGB e al livello $alpha specificati. (altro)

colorClosestHWB (int $red, int $green, int $blue)int

Ottiene l'indice del colore che ha la tinta, il bianco e il nero più vicini al colore dato. (altro)

colorDeallocate (int $color)void

Disalloca un colore precedentemente assegnato con colorAllocate() o colorAllocateAlpha(). (altro)

colorExact (int $red, int $green, int $blue)int

Restituisce l'indice del colore specificato nella tavolozza dell'immagine. (altro)

colorExactAlpha (int $red, int $green, int $blue, int $alpha)int

Restituisce l'indice del colore+alfa specificato nella tavolozza dell'immagine. (altro)

colorMatch (Image $image2)void

Rende i colori della versione palette di un'immagine più simili alla versione a colori reali. (altro)

colorResolve (int $red, int $green, int $blue)int

Restituisce un indice di colore per un colore richiesto, il colore esatto o l'alternativa più vicina possibile. (altro)

colorResolveAlpha (int $red, int $green, int $blue, int $alpha)int

Restituisce un indice di colore per un colore richiesto, il colore esatto o l'alternativa più vicina possibile. (altro)

colorSet (int $index, int $red, int $green, int $blue)void

Imposta l'indice specificato nella tavolozza al colore specificato. (altro)

colorsForIndex (int $index)array

Ottiene il colore per un indice specificato. (altro)

colorsTotal(): int

Restituisce il numero di colori in una tavolozza di immagini (more).

colorTransparent (?int $color=null)int

Ottiene o imposta il colore trasparente dell'immagine. (altro)

convolution (array $matrix, float $div, float $offset)void

Applica una matrice di convoluzione all'immagine, utilizzando il coefficiente e l'offset indicati. (altro)

Richiede l'estensione Bundled GD, quindi non è sicuro che funzioni ovunque.

copy (Image $src, int $dstX, int $dstY, int $srcX, int $srcY, int $srcW, int $srcH)void

Copia una parte di $src sull'immagine a partire dalle coordinate $srcX, $srcY con una larghezza di $srcW e un'altezza di $srcH. La porzione definita verrà copiata sulle coordinate $dstX e $dstY. (altro)

copyMerge (Image $src, int $dstX, int $dstY, int $srcX, int $srcY, int $srcW, int $srcH, int $opacity)void

Copia una parte di $src sull'immagine a partire dalle coordinate $srcX, $srcY con una larghezza di $srcW e un'altezza di $srcH. La porzione definita verrà copiata sulle coordinate $dstX e $dstY. (altro)

copyMergeGray (Image $src, int $dstX, int $dstY, int $srcX, int $srcY, int $srcW, int $srcH, int $opacity)void

Copia una parte di $src sull'immagine a partire dalle coordinate $srcX, $srcY con una larghezza di $srcW e un'altezza di $srcH. La porzione definita verrà copiata sulle coordinate $dstX e $dstY.

Questa funzione è identica a copyMerge(), tranne che per il fatto che durante la fusione preserva la tonalità dell'origine convertendo i pixel di destinazione in scala di grigi prima dell'operazione di copia. (altro)

copyResampled (Image $src, int $dstX, int $dstY, int $srcX, int $srcY, int $dstW, int $dstH, int $srcW, int $srcH)void

Copia una porzione rettangolare di un'immagine in un'altra immagine, interpolando in modo fluido i valori dei pixel in modo che, in particolare, la riduzione delle dimensioni di un'immagine conservi una grande chiarezza.

In altre parole, copyResampled() prenderà un'area rettangolare da $src di larghezza $srcW e altezza $srcH in posizione ($srcX,$srcY) e la collocherà in un'area rettangolare dell'immagine di larghezza $dstW e altezza $dstH in posizione ($dstX,$dstY).

Se le coordinate di origine e di destinazione, la larghezza e l'altezza differiscono, verrà eseguito un allungamento o un restringimento appropriato del frammento di immagine. Le coordinate si riferiscono all'angolo superiore sinistro. Questa funzione può essere utilizzata per copiare regioni all'interno della stessa immagine, ma se le regioni si sovrappongono i risultati saranno imprevedibili. (altro)

copyResized (Image $src, int $dstX, int $dstY, int $srcX, int $srcY, int $dstW, int $dstH, int $srcW, int $srcH)void

Copia una porzione rettangolare di un'immagine in un'altra immagine. In altre parole, copyResized() prenderà un'area rettangolare da $src di larghezza $srcW e altezza $srcH in posizione ($srcX,$srcY) e la collocherà in un'area rettangolare dell'immagine di larghezza $dstW e altezza $dstH in posizione ($dstX,$dstY).

Se le coordinate di origine e di destinazione, la larghezza e l'altezza differiscono, verrà eseguito un allungamento o un restringimento appropriato del frammento di immagine. Le coordinate si riferiscono all'angolo superiore sinistro. Questa funzione può essere utilizzata per copiare regioni all'interno della stessa immagine, ma se le regioni si sovrappongono i risultati saranno imprevedibili. (altro)

crop (int|string $left, int|string $top, int|string $width, int|string $height)Image

Ritaglia un'immagine nell'area rettangolare indicata. Le dimensioni possono essere passate come numeri interi in pixel o come stringhe in percentuale (ad esempio '50%').

cropAuto (int $mode=-1, float $threshold=.5, ?ImageColor $color=null)Image

Ritaglia automaticamente un'immagine in base all'indirizzo $mode. (altro)

ellipse (int $centerX, int $centerY, int $width, int $height, ImageColor $color)void

Disegna un'ellisse centrata sulle coordinate specificate. (altro)

fill (int $x, int $y, ImageColor $color)void

Esegue un riempimento a tappeto a partire dalla coordinata data (in alto a sinistra è 0, 0) con il dato $color nell'immagine. (altro)

filledArc (int $centerX, int $centerY, int $width, int $height, int $startAngle, int $endAngle, ImageColor $color, int $style)void

Disegna un arco parziale centrato nella coordinata specificata dell'immagine. (altro)

filledEllipse (int $centerX, int $centerY, int $width, int $height, ImageColor $color)void

Disegna un'ellisse centrata sulla coordinata specificata nell'immagine. (altro)

filledPolygon (array $points, ImageColor $color)void

Crea un poligono riempito nell'immagine $. (altro)

filledRectangle (int $x1, int $y1, int $x2, int $y2, ImageColor $color)void

Crea un rettangolo riempito con $color nell'immagine che inizia con $x1 e $y1 e termina con $x2 e $y2. Il punto 0, 0 è l'angolo superiore sinistro dell'immagine. (altro)

filledRectangleWH (int $left, int $top, int $width, int $height, ImageColor $color)void

Crea un rettangolo riempito con $color nell'immagine a partire dai punti $left e $top con larghezza $width e altezza $height. Il punto 0, 0 è l'angolo superiore sinistro dell'immagine.

fillToBorder (int $x, int $y, int $border, ImageColor $color)void

Esegue un riempimento a tappeto il cui colore del bordo è definito da $border. Il punto di partenza per il riempimento è $x, $y (in alto a sinistra 0, 0) e la regione viene riempita con il colore $color. (altro)

filter (int $filtertype, int …$args)void

Applica il filtro indicato $filtertype all'immagine. (altro)

flip (int $mode): void

Capovolge l'immagine utilizzando l'indirizzo $mode. (altro)

ftText (float $size, float $angle, int $x, int $y, ImageColor $color, string $fontFile, string $text, array $options=[])array

Scrivere il testo nell'immagine. (altro)

gammaCorrect (float $inputgamma, float $outputgamma)void

Applica la correzione gamma all'immagine data una gamma di ingresso e una di uscita. (altro)

getClip(): array

Recupera il rettangolo di ritaglio corrente, cioè l'area oltre la quale non verranno disegnati pixel. (altro)

getHeight(): int

Restituisce l'altezza dell'immagine.

getImageResource(): resource|GdImage

Restituisce la risorsa originale.

getWidth(): int

Restituisce la larghezza dell'immagine.

interlace (?int $interlace=null)int

Attiva o disattiva il bit di interlacciamento. Se il bit di interlacciamento è impostato e l'immagine viene utilizzata come immagine JPEG, l'immagine viene creata come JPEG progressivo. (altro)

isTrueColor(): bool

Trova se l'immagine è un colore reale. (altro)

layerEffect (int $effect)void

Impostare il flag di fusione alfa per utilizzare gli effetti di stratificazione. (altro)

line (int $x1, int $y1, int $x2, int $y2, ImageColor $color)void

Disegna una linea tra i due punti dati. (altro)

openPolygon (array $points, ImageColor $color)void

Disegna un poligono aperto sull'immagine. Contrariamente a polygon(), non viene tracciata una linea tra l'ultimo e il primo punto. (altro)

paletteCopy (Image $source)void

Copia la tavolozza da $source all'immagine. (altro)

paletteToTrueColor(): void

Converte un'immagine basata su una tavolozza, creata da funzioni come create(), in un'immagine a colori reali, come createtruecolor(). (altro)

place (Image $image, int|string $left=0, int|string $top=0, int $opacity=100)Image

Copia $image nell'immagine alle coordinate $left e $top. Le coordinate possono essere passate come numeri interi in pixel o come stringhe in percentuale (ad esempio '50%').

polygon (array $points, ImageColor $color)void

Crea un poligono nell'immagine. (altro)

rectangle (int $x1, int $y1, int $x2, int $y2, ImageColor $color)void

Crea un rettangolo a partire dalle coordinate specificate. (altro)

rectangleWH (int $left, int $top, int $width, int $height, ImageColor $color)void

Crea un rettangolo alle coordinate date.

resize (int|string $width, int|string $height, int $flags=Image::OrSmaller)Image

Scala un'immagine, vedi maggiori informazioni. Le dimensioni possono essere passate come numeri interi in pixel o come stringhe in percentuale (ad esempio '50%').

resolution (?int $resX=null, ?int $resY=null)mixed

Permette di impostare e ottenere la risoluzione di un'immagine in DPI (punti per pollice). Se non viene fornito nessuno dei parametri opzionali, la risoluzione corrente viene restituita come array indicizzato. Se viene indicato solo $resX, la risoluzione orizzontale e verticale viene impostata su questo valore. Se vengono forniti entrambi i parametri opzionali, la risoluzione orizzontale e verticale viene impostata rispettivamente su questi valori.

La risoluzione viene utilizzata come meta-informazione solo quando le immagini vengono lette e scritte in formati che supportano questo tipo di informazioni (attualmente PNG e JPEG). Non influisce su nessuna operazione di disegno. La risoluzione predefinita per le nuove immagini è 96 DPI. (altro)

rotate (float $angle, int $backgroundColor)Image

Ruota l'immagine utilizzando l'indirizzo $angle in gradi. Il centro di rotazione è il centro dell'immagine e l'immagine ruotata può avere dimensioni diverse dall'immagine originale. (altro)

Richiede l'estensione Bundled GD, quindi non è sicuro che funzioni ovunque.

save (string $file, ?int $quality=null, ?int $type=null)void

Salva un'immagine in un file.

La qualità di compressione è compresa nell'intervallo 0..100 per JPEG (valore predefinito 85), WEBP (valore predefinito 80) e AVIF (valore predefinito 30) e 0..9 per PNG (valore predefinito 9). Se il tipo non è evidente dall'estensione del file, è possibile specificarlo utilizzando una delle costanti ImageType.

saveAlpha (bool $saveflag)void

Imposta il flag che determina se mantenere le informazioni del canale alfa completo (rispetto alla trasparenza di un solo colore) quando si salvano le immagini PNG.

L'alphablending deve essere disabilitato (alphaBlending(false)) per mantenere il canale alfa. (altro)

scale (int $newWidth, int $newHeight=-1, int $mode=IMG_BILINEAR_FIXED)Image

Ridimensiona un'immagine utilizzando l'algoritmo di interpolazione indicato. (altro)

send (int $type=ImageType::JPEG, ?int $quality=null)void

Invia un'immagine al browser.

La qualità di compressione è compresa nell'intervallo 0..100 per JPEG (valore predefinito 85), WEBP (valore predefinito 80) e AVIF (valore predefinito 30) e 0..9 per PNG (valore predefinito 9).

setBrush (Image $brush)void

Imposta l'immagine del pennello da utilizzare da tutte le funzioni di disegno di linee (come line() e polygon()) quando si disegna con i colori speciali IMG_COLOR_BRUSHED o IMG_COLOR_STYLEDBRUSHED. (altro)

setClip (int $x1, int $y1, int $x2, int $y2)void

Imposta il rettangolo di ritaglio corrente, cioè l'area oltre la quale non verranno disegnati pixel. (altro)

setInterpolation (int $method=IMG_BILINEAR_FIXED)void

Imposta il metodo di interpolazione che influisce sui metodi rotate() e affine(). (altro)

setPixel (int $x, int $y, ImageColor $color)void

Disegna un pixel alla coordinata specificata. (altro)

setStyle (array $style)void

Imposta lo stile da utilizzare da tutte le funzioni di disegno delle linee (come line() e polygon()) quando si disegna con il colore speciale IMG_COLOR_STYLED o linee di immagini con colore IMG_COLOR_STYLEDBRUSHED. (altro)

setThickness (int $thickness)void

Imposta lo spessore delle linee tracciate quando si disegnano rettangoli, poligoni, archi ecc. a $thickness pixel. (altro)

setTile (Image $tile)void

Imposta l'immagine della piastrella da usare da tutte le funzioni di riempimento delle regioni (come fill() e filledPolygon()) quando si riempie con il colore speciale IMG_COLOR_TILED.

Una piastrella è un'immagine utilizzata per riempire un'area con un motivo ripetuto. È possibile utilizzare qualsiasi immagine come piastrella e, impostando l'indice del colore trasparente dell'immagine della piastrella con colorTransparent(), è possibile creare una piastrella che lascia trasparire alcune parti dell'area sottostante. (altro)

sharpen(): Image

Rende l'immagine un po' più nitida.

Richiede l'estensione Bundled GD, quindi non è sicuro che funzioni ovunque.

toString (int $type=ImageType::JPEG, ?int $quality=null)string

Emette un'immagine in stringa.

La qualità di compressione è compresa nell'intervallo 0..100 per JPEG (valore predefinito 85), WEBP (valore predefinito 80) e AVIF (valore predefinito 30) e 0..9 per PNG (valore predefinito 9).

trueColorToPalette (bool $dither, int $ncolors)void

Converte un'immagine truecolor in un'immagine palette. (altro)

ttfText (float $size, float $angle, int $x, int $y, ImageColor $color, string $fontFile, string $text, array $options=[])array

Scrive il testo dato nell'immagine. (altro)

versione: 4.0