Praca z obrazami

Klasa Nette\Utils\Image ułatwia manipulowanie obrazami, takie jak zmiana rozmiaru, przycinanie, wyostrzanie, rysowanie czy łączenie wielu obrazów.

PHP posiada rozbudowany zestaw funkcji do manipulowania obrazami. Jednak ich API nie jest zbyt wygodne. To nie byłby Nette Framework, żeby nie wymyślić seksownego API.

Instalacja:

composer require nette/utils

Wszystkie przykłady zakładają, że alias został utworzony:

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

Tworzenie obrazu

Utwórz nowy obraz w kolorze rzeczywistym, na przykład o wymiarach 100×200:

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

Możesz opcjonalnie określić kolor tła (domyślnie jest to kolor czarny):

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

Albo załadować obraz z pliku:

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

Zapisywanie obrazu

Obraz można zapisać do pliku:

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

Możemy określić jakość kompresji w zakresie 0..100 dla JPEG (domyślnie 85), WEBP (domyślnie 80) i AVIF (domyślnie 30) oraz 0..9 dla PNG (domyślnie 9):

$image->save('resampled.jpg', 80); // JPEG, jakość 80%

Jeśli format nie jest oczywisty na podstawie rozszerzenia pliku, można go określić za pomocą stałej:

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

Obraz może być zapisany do zmiennej zamiast na dysk:

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

lub wysyłane bezpośrednio do przeglądarki z odpowiednim nagłówkiem HTTP Content-Type:

// wysyła nagłówek Content-Type: image/png
$image->send(ImageType::PNG);

Formaty

Obsługiwane formaty to JPEG, PNG, GIF, WebP, AVIF i BMP. Muszą być one jednak również obsługiwane przez daną wersję PHP, co można zweryfikować za pomocą funkcji isTypeSupported(). Animacje nie są obsługiwane.

Formaty są reprezentowane przez stałe ImageType::JPEG, ImageType::PNG, ImageType::GIF, ImageType::WEBP, ImageType::AVIF i ImageType::BMP.

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

Chcesz wykryć format obrazu podczas ładowania? Metoda zwraca go w drugim parametrze:

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

Rzeczywiste wykrywanie bez ładowania obrazu jest wykonywane przez Image::detectTypeFromFile().

Zmień rozmiar

Często wykonywaną operacją jest zmiana rozmiaru obrazu. Rzeczywiste wymiary są zwracane przez metody getWidth() i getHeight().

Metoda resize() służy do zmiany rozmiaru obrazu tak, aby nie przekraczał on 500×300 pikseli (albo szerokość będzie wynosiła dokładnie 500 px, albo wysokość dokładnie 300 px, jeden z wymiarów jest obliczany dla zachowania proporcji):

$image->resize(500, 300);

Możliwe jest określenie tylko jednego wymiaru, a drugi zostanie obliczony:

$image->resize(500, null); // szerokość 500px, wysokość jest obliczana

$image->resize(null, 300); // szerokość obliczona, wysokość 300px

Każdy wymiar może być określony jako procent:

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

Na zachowanie resize mogą wpływać następujące objawy. Wszystkie poza Image::Stretch zachowują proporcje.

Flaga	Opis
`Image::OrSmaller` (domyślnie)	wymiary wynikowe będą mniejsze lub równe żądanym wymiarom
`Image::OrBigger`	wypełnia (i ewentualnie przekracza w jednym wymiarze) obszar docelowy
`Image::Cover`	wypełnia obszar docelowy i przycina to, co go przekracza
`Image::ShrinkOnly`	tylko zmniejszanie (unikanie rozciągania małego obrazu)
`Image::Stretch`	nie zachowuj proporcji

Flagi są podawane jako trzeci argument funkcji:

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

Flagi mogą być łączone:

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

Obrazy można obrócić w pionie lub poziomie, nadając jednemu z wymiarów (lub obu) wartość ujemną:

$flipped = $image->resize(null, '-100%'); // przerzuć w pionie

$flipped = $image->resize('-100%', '-100%'); // obróć o 180°.

$flipped = $image->resize(-125, 500); // zmiana rozmiaru i odwrócenie w poziomie

Po zmniejszeniu obrazu można poprawić jego wygląd poprzez dokładne wyostrzenie:

$image->sharpen();

Uprawa

Do uprawy stosuje się metodę crop():

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

Podobnie jak w przypadku resize(), wszystkie wartości mogą być podane w procentach. Procenty dla $left i $top są obliczane z pozostałej przestrzeni, podobnie jak właściwość CSS background-position:

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

Obraz można również przyciąć automatycznie, na przykład przycinając czarne obramowania:

$image->cropAuto(IMG_CROP_BLACK);

Metoda cropAuto() jest obiektowym zamiennikiem funkcji imagecropauto(), więcej informacji można znaleźć w jej dokumentacji.

Kolory

Metoda ImageColor::rgb() umożliwia zdefiniowanie koloru przy użyciu wartości czerwonego, zielonego i niebieskiego (RGB). Opcjonalnie można również określić wartość przezroczystości w zakresie od 0 (całkowicie przezroczysty) do 1 (całkowicie nieprzezroczysty), podobnie jak w CSS.

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

Metoda ImageColor::hex() umożliwia zdefiniowanie koloru przy użyciu formatu szesnastkowego, podobnie jak w CSS. Obsługuje formaty #rgb, #rrggbb, #rgba i #rrggbbaa:

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

Kolory mogą być używane w innych metodach, takich jak ellipse(), fill(), itp.

Rysowanie i edycja

Możesz rysować, możesz pisać, możesz używać wszystkich funkcji PHP do manipulacji obrazem, patrz Przegląd metod, ale w opakowaniu obiektowym:

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

Ponieważ funkcje PHP do rysowania prostokątów są niepraktyczne ze względu na konieczność określania współrzędnych, klasa Image oferuje ich zamienniki w postaci funkcji rectangleWH ( ) i filledRectangleWH().

Łączenie wielu obrazów

Możesz łatwo wstawić inny obraz do obrazu:

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

// współrzędne mogą być ponownie podane w procentach
$blank->place($logo, '80%', '80%'); // wstawiamy w pobliżu prawego dolnego rogu

Alfabet jest respektowany podczas wstawiania, a my możemy wpływać na przezroczystość wstawianego obrazu (tworzymy znak wodny):

$blank->place($image, '80%', '80%', 25); // przezroczystość wynosi 25%

To API to prawdziwa radość z użytkowania!

Przegląd metod

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

Tworzy nowy obraz w kolorze rzeczywistym o podanych wymiarach. Domyślnym kolorem jest czarny.

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

Odczytuje obraz z pliku i zwraca jego typ w $detectedFormat.

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

Odczytuje obraz z ciągu znaków i zwraca jego typ w $detectedFormat.

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

Funkcja ta została zastąpiona przez klasę ImageColor, patrz kolory.

static typeToExtension(int $type): string

Zwraca rozszerzenie pliku dla podanego typu.

static typeToMimeType(int $type): string

Zwraca typ mime dla podanego typu.

static extensionToType(string $extension): int

Zwraca typ obrazu zgodnie z rozszerzeniem pliku.

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

Zwraca typ pliku obrazu, a w parametrach $width i $height także jego wymiary.

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

Zwraca typ obrazu z ciągu znaków, a w parametrach $width i $height również jego wymiary.

static isTypeSupported(int $type): bool

Określa, czy dany typ obrazu jest obsługiwany.

static getSupportedTypes(): array

Zwraca tablicę obsługiwanych typów obrazów (stałe ImageType::XXX).

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

Oblicza wymiary prostokąta otaczającego tekst o określonej czcionce i rozmiarze. Zwraca tablicę asocjacyjną zawierającą klucze left, top, width, height. Lewy margines może być ujemny, jeśli tekst zaczyna się od lewego nawisu.

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

Zwróć obraz zawierający affine-transformed src image używając opcjonalnego regionu przycinania (więcej).

affineMatrixConcat(array $m1, array $m2): array

Zwraca konkatenację dwóch macierzy przekształceń afinicznych, co jest przydatne, gdy do tego samego obrazu należy zastosować wiele przekształceń jednocześnie. (więcej)

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

Zwraca macierz przekształcenia macierzy (więcej).

alphaBlending(bool $on): void

Umożliwia dwa różne tryby rysowania w obrazach truecolor. W trybie mieszania składowa kanału alfa koloru używanego we wszystkich funkcjach rysunkowych, takich jak setPixel(), określa, w jakim stopniu należy pozwolić, aby kolor podstawowy prześwitywał. W rezultacie w tym momencie istniejący kolor jest automatycznie mieszany z kolorem rysunku, a wynik jest zapisywany w obrazie. Powstały w ten sposób piksel jest nieprzezroczysty. W trybie nie mieszania, kolor kreskówki jest kopiowany dosłownie z informacją o kanale alfa i zastępowany pikselem docelowym. Tryb blend nie jest dostępny podczas rysowania na obrazkach paletowych. (więcej)

antialias(bool $on): void

Aktywuj rysowanie linii wygładzonych i wielokątów. Nie obsługuje kanałów alfa. Działa tylko z obrazami truecolor.

Użycie antyaliasowanego prymitywu z przezroczystym kolorem tła może skończyć się nieoczekiwanymi rezultatami. Metoda blend wykorzystuje kolor tła jak każdy inny kolor. (więcej)

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

Rysuje łuk okręgu o środku w podanych współrzędnych. (więcej)

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

Zwraca identyfikator koloru reprezentujący kolor złożony z podanych składowych RGB. Musi być wywołany, aby stworzyć każdy kolor, który ma być użyty w obrazie. (więcej)

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

Zachowuje się tak samo jak colorAllocate() z dodaniem parametru przejrzystości $alpha. (więcej)

colorAt(int $x, int $y): int

Zwraca indeks koloru piksela w określonym miejscu obrazu. Jeśli obraz jest truecolor, funkcja zwraca wartość RGB tego piksela jako liczbę całkowitą. Użyj przesunięcia bitów i maskowania bitów, aby uzyskać dostęp do oddzielnych wartości dla składowej czerwonej, zielonej i niebieskiej: (więcej)

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

Zwraca indeks koloru w palecie obrazów, który jest “najbliższy” określonej wartości RGB. “Odległość” między pożądanym kolorem a każdym kolorem w palecie jest obliczana tak, jakby wartości RGB reprezentowały punkty w przestrzeni trójwymiarowej. (więcej)

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

Zwraca indeks koloru w palecie obrazów, który jest “najbliższy” podanej wartości RGB i poziomu $alpha. (więcej)

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

Uzyskaj indeks koloru, który ma odcień, biel i czerń najbliższe podanemu kolorowi. (więcej)

colorDeallocate(int $color): void

De-allocates a color previously assigned by colorAllocate() or colorAllocateAlpha(). (więcej)

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

Zwraca indeks określonego koloru w palecie obrazów. (więcej)

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

Zwraca indeks określonego koloru + alfa w palecie obrazów. (więcej)

colorMatch(Image $image2): void

Dopasowuje kolory palety do drugiego panelu. (więcej)

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

Zwraca indeks koloru dla żądanego koloru, albo dokładny kolor, albo najbliższą możliwą alternatywę. (więcej)

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

Zwraca indeks koloru dla żądanego koloru, albo dokładny kolor, albo najbliższą możliwą alternatywę. (więcej)

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

Ustawia określony indeks w palecie na określony kolor. (więcej)

colorsForIndex(int $index): array

Uzyskuje kolor określonego indeksu (więcej).

colorsTotal(): int

Zwraca liczbę kolorów w palecie obrazów. (więcej)

colorTransparent(int $color=null): int

Uzyskuje lub ustawia kolor przezroczysty w obrazie. (więcej)

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

Stosuje macierz konwolucji do obrazu, używając danego współczynnika i przesunięcia. (więcej)

Wymaga obecności rozszerzenia Bundled GD, więc może nie działać wszędzie.

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

Kopiuje fragment strony $src do obrazu rozpoczynającego się na współrzędnych $srcX, $srcY o szerokości $srcW i wysokości $srcH. Zdefiniowana część zostanie skopiowana do współrzędnych $dstX i $dstY. (więcej)

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

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

Funkcja ta jest identyczna jak copyMerge() z tym wyjątkiem, że zachowuje źródłowy odcień podczas scalania poprzez konwersję pikseli docelowych do skali szarości przed operacją kopiowania. (więcej)

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

Kopiuje prostokątny fragment jednego obrazu do drugiego, płynnie interpolując wartości pikseli, dzięki czemu, zwłaszcza przy zmniejszaniu rozmiaru, obraz nadal zachowuje dużą wyrazistość.

Innymi słowy, copyResampled() pobiera prostokątny region z $src o szerokości $srcW i wysokości $srcH w pozycji ($srcX, $srcY) i umieszcza go w prostokątnym regionie obrazu o szerokości $dstW i wysokości $dstH w pozycji ($dstX, $dstY).

Jeśli współrzędne źródła i miejsca docelowego, szerokość i wysokość są różne, fragment obrazu jest odpowiednio rozciągany lub zmniejszany. Współrzędne odnoszą się do lewego górnego rogu. Funkcja ta może być używana do kopiowania obszarów na tym samym obrazie, ale jeśli obszary będą się nakładać, wyniki nie będą przewidywalne. (więcej)

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

Kopiuje prostokątny fragment jednego obrazu do innego obrazu. Innymi słowy, copyResized() pobiera prostokątny region z $src o szerokości $srcW i wysokości $srcH w pozycji ($srcX, $srcY) i umieszcza go w prostokątnym regionie obrazu o szerokości $dstW ] i wysokości $dstH w pozycji ($dstX, $dstY).

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

Przycina obraz do zadanego prostokątnego obszaru. Wymiary mogą być określone jako liczby całkowite w pikselach lub ciągi znaków w procentach (na przykład '50%').

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

Automatycznie przycina obraz zgodnie z podanym $mode. (więcej)

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

Rysuje elipsę wyśrodkowaną na podanych współrzędnych. (więcej)

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

Wypełnia obszar zaczynający się na podanej współrzędnej (lewa górna to 0, 0) podaną $color. (więcej)

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

Rysuje częściowy łuk o środku w podanych współrzędnych. (więcej)

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

Rysuje elipsę wyśrodkowaną na podanych współrzędnych. (więcej)

filledPolygon(array $points, ImageColor $color): void

Tworzy wypełniony wielokąt w obrazie. (więcej)

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

Tworzy prostokąt wypełniony $color na obrazie, zaczynając od $x1 i $y1, a kończąc na $x2 i $y2. Punkt 0, 0 to lewy górny róg obrazu. (więcej)

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

Tworzy prostokąt wypełniony $color na obrazie, zaczynając od punktów $left i $top o szerokości $width i wysokości $height. Punkt 0, 0 to lewy górny róg obrazu.

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

Tworzy wypełnienie, którego kolor jest określony przez $border. Punktem początkowym wypełnienia jest $x, $y (lewa górna część to 0, 0), a obszar jest wypełniony kolorem $color. (więcej)

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

Stosuje podany filtr $filtertype do obrazu. (więcej)

flip(int $mode): void

Odwraca obraz za pomocą podanego $mode. (więcej)

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

Wpisz tekst na obrazku. (więcej)

gammaCorrect(float $inputgamma, float $outputgamma): void

Zastosuj korekcję gamma do obrazu względem gamma wejściowego i wyjściowego. (więcej)

getClip(): array

Zwraca aktualny crop, czyli obszar, poza którym nie będą rysowane piksele. (więcej)

getHeight(): int

Zwraca wysokość obrazu.

getImageResource(): resource|GdImage

Zwraca oryginalny zasób.

getWidth(): int

Zwraca szerokość obrazu.

interlace(int $interlace=null): int

Włącza lub wyłącza tryb przeplotu. Jeśli ustawiony jest tryb z przeplotem, a obraz jest zapisywany jako JPEG, zostanie on zapisany jako JPEG progresywny. (więcej)

isTrueColor(): bool

Określ, czy obraz jest truecolor (więcej).

layerEffect(int $effect): void

Ustaw flagę alfa blend, aby użyć efektów warstwowych. (więcej)

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

Rysuje linię pomiędzy dwoma podanymi punktami. (więcej)

openPolygon(array $points, ImageColor $color): void

Rysuje na obrazie otwarty wielokąt. W odróżnieniu od polygon(), między ostatnim a pierwszym punktem nie rysuje się linii. (więcej)

paletteCopy(Image $source): void

Kopiuje paletę z $source do obrazu. (więcej)

paletteToTrueColor(): void

Konwertuje obraz oparty na paletach na obraz w pełnym kolorze. (więcej)

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

Kopiuje stronę $image do obrazu na współrzędnych $left i $top. Współrzędne mogą być określone jako liczby całkowite w pikselach lub łańcuchy w procentach (na przykład '50%').

polygon(array $points, ImageColor $color): void

Tworzy wielokąt w obrazie. (więcej)

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

Tworzy prostokąt na podanych współrzędnych (więcej).

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

Tworzy prostokąt o podanych współrzędnych.

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

Zmienia rozmiar obrazu, więcej informacji. Wymiary mogą być określone jako liczby całkowite w pikselach lub ciągi znaków w procentach (na przykład '50%').

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

Ustawia lub zwraca rozdzielczość obrazu w DPI (punkty na cal). Jeśli żaden z opcjonalnych parametrów nie zostanie określony, bieżąca rozdzielczość jest zwracana jako indeksowane pole. Jeśli określona jest tylko $resX, rozdzielczość pozioma i pionowa są ustawione na tę wartość. Jeśli oba opcjonalne parametry są określone, rozdzielczości pozioma i pionowa są ustawione na te wartości.

Rozdzielczość jest używana jako meta informacja tylko wtedy, gdy obrazy są odczytywane i zapisywane w formatach obsługujących ten rodzaj informacji (obecnie PNG i JPEG). Nie ma to wpływu na żadne operacje rysunkowe. Domyślna rozdzielczość nowych zdjęć to 96 DPI. (więcej)

rotate(float $angle, int $backgroundColor): Image

Obraca obraz przy użyciu określonej $angle w stopniach. Środek obrotu jest środkiem obrazu, a obrócony obraz może mieć inne wymiary niż obraz oryginalny. (więcej)

Wymaga obecności rozszerzenia Bundled GD, więc może nie działać wszędzie.

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

Zapisuje obraz do pliku.

Jakość kompresji mieści się w zakresie 0..100 dla JPEG (domyślnie 85), WEBP (domyślnie 80) i AVIF (domyślnie 30) oraz 0..9 dla PNG (domyślnie 9). Jeśli typ nie jest oczywisty z rozszerzenia pliku, można go określić za pomocą jednej ze stałych ImageType.

saveAlpha(bool $saveflag): void

Ustawia flagę, aby zachować pełną informację o kanale alfa (w przeciwieństwie do przezroczystości monochromatycznej) podczas zapisywania obrazów PNG.

Alfablending musi być wyłączony (alphaBlending(false)), aby zachować kanał alfa w pierwszej kolejności. (więcej)

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

Skalowanie obrazu z wykorzystaniem podanego algorytmu interpolacji. (więcej)

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

Drukuje obraz do przeglądarki.

Jakość kompresji mieści się w zakresie 0..100 dla JPEG (domyślnie 85), WEBP (domyślnie 80) i AVIF (domyślnie 30) oraz 0..9 dla PNG (domyślnie 9).

setBrush(Image $brush): void

Ustawia obraz pędzla, który ma być używany we wszystkich funkcjach rysowania linii (na przykład line() i polygon()) podczas rysowania z użyciem specjalnych kolorów IMG_COLOR_BRUSHED lub IMG_COLOR_STYLEDBRUSHED. (więcej)

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

Ustawia aktualny crop, czyli obszar poza którym nie będą rysowane piksele. (więcej)

setInterpolation(int $method=IMG_BILINEAR_FIXED): void

Ustawia metodę interpolacji, która wpływa na metody rotate() i affine(). (więcej)

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

Rysuje piksel na określonej współrzędnej. (więcej)

setStyle(array $style): void

Ustawia styl, który ma być używany przez wszystkie funkcje rysowania linii (na przykład line() i polygon()) podczas rysowania z kolorem specjalnym IMG_COLOR_STYLED lub linii obrazu z kolorem IMG_COLOR_STYLEDBRUSHED. (więcej)

setThickness(int $thickness): void

Ustawia grubość linii podczas rysowania prostokątów, wielokątów, łuków itp. Na stronie $thickness pikseli (więcej)

setTile(Image $tile): void

Ustawia obraz kafelka, który będzie używany we wszystkich funkcjach wypełniania regionów (na przykład fill() i filledPolygon()), gdy wypełniony jest specjalnym kolorem IMG_COLOR_TILED.

Kafelek jest obrazem używanym do wypełnienia regionu powtarzającym się wzorem. Jako kafelek można użyć dowolnego obrazu, a ustawiając indeks przezroczystego koloru obrazu kafelka za pomocą strony colorTransparent(), można stworzyć kafelek, w którym pewne części bazowego regionu będą prześwitywać. (więcej)

sharpen(): Image

Wyostrza obraz.

Wymaga obecności rozszerzenia Bundled GD, więc może nie działać wszędzie.

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

Zapisuje obraz w postaci ciągu znaków.

Jakość kompresji mieści się w zakresie 0..100 dla JPEG (domyślnie 85), WEBP (domyślnie 80) i AVIF (domyślnie 30) oraz 0..9 dla PNG (domyślnie 9).

trueColorToPalette(bool $dither, int $ncolors): void

Konwertuje obraz truecolor na obraz palety. (więcej)

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

Zapisuje podany tekst na obrazie. (więcej)