Praca z obrazami
****************

.[perex]
Klasa [api:Nette\Utils\Image] upraszcza manipulowanie obrazami, na przykład zmianę rozmiaru, kadrowanie, wyostrzanie, rysowanie czy łączenie kilku obrazów.


PHP ma obszerny zestaw funkcji do manipulowania obrazami. Ich API nie jest jednak zbyt przyjazne. To nie byłby Nette Framework, gdyby nie przyszedł z rozkosznym API.

Instalacja:

```shell
composer require nette/utils
```

Poniższe przykłady zakładają, że zdefiniowany jest następujący alias klasy:

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


Tworzenie obrazu
================

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

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

Opcjonalnie możesz podać kolor tła (domyślnie jest czarny):

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

Albo wczytaj obraz z pliku:

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


Zapis obrazu
============

Obraz można zapisać do pliku:

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

Możesz podać jakość kompresji z zakresu 0-100 dla JPEG (domyślnie 85), WEBP (domyślnie 80) i AVIF (domyślnie 30) oraz 0-9 dla PNG (domyślnie 9):

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

Jeśli format nie wynika jednoznacznie z rozszerzenia pliku, można go podać za pomocą [stałej |#Formaty]:

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

Zamiast zapisu na dysk obraz można zapisać do zmiennej:

```php
$data = $image->toString(ImageType::JPEG, 80); // JPEG, jakość 80%
```

albo wysłać bezpośrednio do przeglądarki wraz z odpowiednim nagłówkiem HTTP `Content-Type`:

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


Formaty
=======

Obsługiwane formaty to JPEG, PNG, GIF, WebP, AVIF i BMP. Twoja wersja PHP musi je jednak również obsługiwać, co sprawdzisz funkcją [#isTypeSupported()]. Animacje nie są obsługiwane.

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

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

Potrzebujesz wykryć format obrazu przy wczytywaniu? Metoda zwraca go w drugim parametrze:

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

Wykrycie bez wczytywania samego obrazu umożliwia `Image::detectTypeFromFile()`.


Zmiana rozmiaru
===============

Częstą operacją jest zmiana rozmiaru obrazu. Bieżące wymiary zwracają metody `getWidth()` i `getHeight()`.

Do zmiany rozmiaru służy metoda `resize()`. Przykład proporcjonalnej zmiany rozmiaru tak, aby obraz nie przekroczył 500x300 pikseli (albo szerokość będzie dokładnie 500px, albo wysokość dokładnie 300px; drugi wymiar obliczany jest tak, aby zachować proporcje):

```php
$image->resize(500, 300);
```

Można podać tylko jeden wymiar, a drugi zostanie obliczony automatycznie:

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

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

Każdy z wymiarów można podać także w procentach:

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

Na zachowanie `resize()` można wpłynąć poniższymi flagami. Wszystkie flagi z wyjątkiem `Image::Stretch` zachowują proporcje.

|---------------------------------------------------------------------------------------
| Flaga                 | Opis
|---------------------------------------------------------------------------------------
| `Image::OrSmaller` (domyślna) | wynikowe wymiary będą mniejsze lub równe żądanym
| `Image::OrBigger`         | wypełnia obszar docelowy (i ewentualnie przekracza go w jednym wymiarze)
| `Image::Cover`            | wypełnia obszar docelowy i przycina wszystko, co go przekracza
| `Image::ShrinkOnly`       | tylko zmniejsza (zapobiega rozciąganiu małego obrazu)
| `Image::Stretch`          | nie zachowuje proporcji


Flagi przekazuje się jako trzeci argument metody:

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

Flagi można łączyć:

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

Obrazy można odbić w pionie albo w poziomie, podając jeden z wymiarów (albo oba) jako liczbę ujemną:

```php
$flipped = $image->resize(null, '-100%'); // odbicie w pionie

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

$flipped = $image->resize(-125, 500); // zmiana rozmiaru i odbicie w poziomie
```

Po zmianie rozmiaru obrazu możesz poprawić jego wygląd delikatnym wyostrzeniem:

```php
$image->sharpen();
```


Kadrowanie
==========

Do kadrowania służy metoda `crop()`:

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

Podobnie jak przy `resize()`, wszystkie wartości można podać w procentach. Procenty dla `$left` i `$top` liczone są z pozostałej przestrzeni, podobnie jak przy właściwości CSS `background-position`:

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

[* crop.svg *]


Obraz można też skadrować automatycznie, na przykład aby usunąć czarne obramowanie:

```php
$image->cropAuto(IMG_CROP_BLACK);
```

Metoda `cropAuto()` to obiektowy wrapper funkcji `imagecropauto()`; więcej informacji znajdziesz w [jej dokumentacji|https://www.php.net/manual/en/function.imagecropauto].


Kolory .{data-version:4.0.2}
============================

Metoda `ImageColor::rgb()` pozwala zdefiniować kolor za pomocą wartości czerwonej, zielonej i niebieskiej (RGB). Opcjonalnie możesz podać także wartość przezroczystości z zakresu od 0 (całkowicie przezroczysty) do 1 (całkowicie nieprzezroczysty), tak jak w CSS.

```php
$color = ImageColor::rgb(255, 0, 0); // czerwony
$transparentBlue = ImageColor::rgb(0, 0, 255, 0.5); // półprzezroczysty niebieski
```

Metoda `ImageColor::hex()` pozwala zdefiniować kolor w formacie szesnastkowym, podobnie jak w CSS. Obsługuje formaty `#rgb`, `#rrggbb`, `#rgba` i `#rrggbbaa`:

```php
$color = ImageColor::hex("#F00"); // czerwony
$transparentGreen = ImageColor::hex("#00FF0080"); // półprzezroczysty zielony
```

Kolorów można używać w innych metodach, takich jak `ellipse()`, `fill()` itd.


Rysowanie i edycja
==================

Masz do dyspozycji wszystkie funkcje PHP do manipulowania obrazami, zobacz [#Przegląd metod], ale opakowane w styl obiektowy:

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

Ponieważ natywne funkcje PHP do rysowania prostokątów są nieco niepraktyczne przez sposób podawania współrzędnych, klasa `Image` oferuje zamienniki: [#rectangleWH()] i [#filledRectangleWH()].


Łączenie kilku obrazów
======================

Na bieżący obraz łatwo umieścisz inny obraz:

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

// współrzędne można podać także w procentach
$blank->place($logo, '80%', '80%'); // umieszcza w pobliżu prawego dolnego rogu
```

Przy umieszczaniu respektowany jest kanał alfa. Ponadto możesz wpłynąć na przezroczystość umieszczanego obrazu (tworząc znak wodny):

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

Używanie takiego API to prawdziwa przyjemność!


Przegląd metod
==============


static fromBlank(int $width, int $height, ?ImageColor $color=null): Image .[method]
-----------------------------------------------------------------------------------
Tworzy nowy obraz truecolor o podanych wymiarach. Domyślnym kolorem jest czarny.


static fromFile(string $file, int &$detectedFormat=null, string &$warnings=null): Image .[method]
-------------------------------------------------------------------------------------------------
Wczytuje obraz z pliku i zwraca jego [typ |#Formaty] w `$detectedFormat`. Jeśli przekażesz `$warnings`, wszelkie niekrytyczne ostrzeżenia dekodera obrazu zostaną w nim zapisane, zamiast zostać zgłoszone jako ostrzeżenie PHP; pozostaje `null`, gdy żadnych nie ma.


static fromString(string $s, int &$detectedFormat=null, string &$warnings=null): Image .[method]
------------------------------------------------------------------------------------------------
Wczytuje obraz ze stringa i zwraca jego [typ |#Formaty] w `$detectedFormat`. Jeśli przekażesz `$warnings`, wszelkie niekrytyczne ostrzeżenia dekodera obrazu zostaną w nim zapisane, zamiast zostać zgłoszone jako ostrzeżenie PHP; pozostaje `null`, gdy żadnych nie ma.


static rgb(int $red, int $green, int $blue, int $transparency=0): array .[method][deprecated]
---------------------------------------------------------------------------------------------
Tę funkcję zastąpiła klasa `ImageColor`, zobacz [#Kolory].


static typeToExtension(int $type): string .[method]
---------------------------------------------------
Zwraca rozszerzenie pliku dla podanego [typu |#Formaty].


static typeToMimeType(int $type): string .[method]
--------------------------------------------------
Zwraca typ MIME dla podanego [typu |#Formaty].


static extensionToType(string $extension): int .[method]
--------------------------------------------------------
Zwraca [typ |#Formaty] obrazu na podstawie rozszerzenia pliku.


static detectTypeFromFile(string $file, int &$width=null, int &$height=null): ?int .[method]
--------------------------------------------------------------------------------------------
Zwraca [typ |#Formaty] pliku obrazu, a w parametrach `$width` i `$height` również jego wymiary.


static detectTypeFromString(string $s, int &$width=null, int &$height=null): ?int .[method]
-------------------------------------------------------------------------------------------
Zwraca [typ |#Formaty] obrazu ze stringa, a w parametrach `$width` i `$height` również jego wymiary.


static isTypeSupported(int $type): bool .[method]
-------------------------------------------------
Sprawdza, czy podany [typ |#Formaty] obrazu jest obsługiwany.


static getSupportedTypes(): array .[method]{data-version:4.0.4}
---------------------------------------------------------------
Zwraca tablicę obsługiwanych [typów |#Formaty] obrazów.


static calculateTextBox(string $text, string $fontFile, float $size, float $angle=0, array $options=[]): array .[method]
------------------------------------------------------------------------------------------------------------------------
Oblicza wymiary prostokąta otaczającego tekst w określonym foncie i rozmiarze. Zwraca tablicę asocjacyjną zawierającą klucze `left`, `top`, `width`, `height`. Lewy margines może być ujemny, jeśli tekst zaczyna się lewym nawisem kerningu.


affine(array $affine, ?array $clip=null): Image .[method]
---------------------------------------------------------
Zwraca obraz zawierający przekształcony afinicznie obraz źródłowy, z opcjonalnym obszarem przycięcia. ([więcej |https://www.php.net/manual/en/function.imageaffine]).


alphaBlending(bool $on): void .[method]
---------------------------------------
Umożliwia dwa różne tryby rysowania na obrazach truecolor. W trybie mieszania składowa kanału alfa koloru podanego wszystkim funkcjom rysującym, takim jak `setPixel()`, decyduje o tym, ile leżącego pod spodem koloru ma prześwitywać. W efekcie automatycznie miesza istniejący w tym punkcie kolor z kolorem rysowania i zapisuje wynik w obrazie. Wynikowy piksel jest nieprzezroczysty. W trybie bez mieszania kolor rysowania kopiowany jest dosłownie, wraz z informacją o kanale alfa, i zastępuje piksel docelowy. Tryb mieszania nie jest dostępny przy rysowaniu na obrazach paletowych. ([więcej |https://www.php.net/manual/en/function.imagealphablending])


antialias(bool $on): void .[method]
-----------------------------------
Włącza szybkie metody antyaliasowanego rysowania linii i wielokątów szkieletowych. Nie obsługuje składowych alfa. Działa przez bezpośrednią operację mieszania. Działa wyłącznie z obrazami truecolor.

Używanie prymitywów z antyaliasingiem przy przezroczystym kolorze tła może dać nieoczekiwane wyniki. Metoda mieszania traktuje kolor tła jak każdy inny kolor. Brak obsługi składowej alfa nie pozwala na metodę antyaliasingu opartą na alfie. ([więcej |https://www.php.net/manual/en/function.imageantialias])


arc(int $centerX, int $centerY, int $width, int $height, int $startAngle, int $endAngle, ImageColor $color): void .[method]
---------------------------------------------------------------------------------------------------------------------------
Rysuje łuk okręgu o środku w podanych współrzędnych. ([więcej |https://www.php.net/manual/en/function.imagearc])


colorAllocate(int $red, int $green, int $blue): int .[method]
-------------------------------------------------------------
Zwraca identyfikator koloru reprezentujący kolor złożony z podanych składowych RGB. Musi zostać wywołana, aby utworzyć każdy kolor, który ma być użyty w obrazie. ([więcej |https://www.php.net/manual/en/function.imagecolorallocate])


colorAllocateAlpha(int $red, int $green, int $blue, int $alpha): int .[method]
------------------------------------------------------------------------------
Zachowuje się identycznie jak `colorAllocate()`, z dodatkiem parametru przezroczystości `$alpha`. ([więcej |https://www.php.net/manual/en/function.imagecolorallocatealpha])


colorAt(int $x, int $y): int .[method]
--------------------------------------
Zwraca indeks koloru piksela w podanym miejscu obrazu. Jeśli obraz jest typu truecolor, funkcja zwraca wartość RGB tego piksela jako liczbę całkowitą. Aby sięgnąć po poszczególne składowe czerwoną, zieloną i niebieską, użyj przesunięć bitowych i maskowania: ([więcej |https://www.php.net/manual/en/function.imagecolorat])


colorClosest(int $red, int $green, int $blue): int .[method]
------------------------------------------------------------
Zwraca indeks koloru w palecie obrazu, który jest "najbliższy" podanej wartości RGB. "Odległość" między pożądanym kolorem a każdym kolorem palety obliczana jest tak, jakby wartości RGB reprezentowały punkty w przestrzeni trójwymiarowej. ([więcej |https://www.php.net/manual/en/function.imagecolorclosest])


colorClosestAlpha(int $red, int $green, int $blue, int $alpha): int .[method]
-----------------------------------------------------------------------------
Zwraca indeks koloru w palecie obrazu, który jest "najbliższy" podanej wartości RGB i poziomowi `$alpha`. ([więcej |https://www.php.net/manual/en/function.imagecolorclosestalpha])


colorClosestHWB(int $red, int $green, int $blue): int .[method]
---------------------------------------------------------------
Zwraca indeks koloru o odcieniu, bieli i czerni najbliższych podanemu kolorowi. ([więcej |https://www.php.net/manual/en/function.imagecolorclosesthwb])


colorDeallocate(int $color): void .[method]
-------------------------------------------
Zwalnia kolor przydzielony wcześniej przez `colorAllocate()` albo `colorAllocateAlpha()`. ([więcej |https://www.php.net/manual/en/function.imagecolordeallocate])


colorExact(int $red, int $green, int $blue): int .[method]
----------------------------------------------------------
Zwraca indeks podanego koloru w palecie obrazu. ([więcej |https://www.php.net/manual/en/function.imagecolorexact])


colorExactAlpha(int $red, int $green, int $blue, int $alpha): int .[method]
---------------------------------------------------------------------------
Zwraca indeks podanego koloru wraz z alfą w palecie obrazu. ([więcej |https://www.php.net/manual/en/function.imagecolorexactalpha])


colorMatch(Image $image2): void .[method]
-----------------------------------------
Sprawia, że kolory paletowej wersji obrazu bardziej odpowiadają wersji truecolor. ([więcej |https://www.php.net/manual/en/function.imagecolormatch])


colorResolve(int $red, int $green, int $blue): int .[method]
------------------------------------------------------------
Zwraca indeks koloru dla żądanego koloru, albo dokładnego, albo najbliższej możliwej alternatywy. ([więcej |https://www.php.net/manual/en/function.imagecolorresolve])


colorResolveAlpha(int $red, int $green, int $blue, int $alpha): int .[method]
-----------------------------------------------------------------------------
Zwraca indeks koloru dla żądanego koloru, albo dokładnego, albo najbliższej możliwej alternatywy. ([więcej |https://www.php.net/manual/en/function.imagecolorresolvealpha])


colorSet(int $index, int $red, int $green, int $blue, int $alpha=0): void .[method]
-----------------------------------------------------------------------------------
Ustawia podany indeks palety na podany kolor. ([więcej |https://www.php.net/manual/en/function.imagecolorset])


colorsForIndex(int $index): array .[method]
-------------------------------------------
Zwraca kolor dla podanego indeksu. ([więcej |https://www.php.net/manual/en/function.imagecolorsforindex])


colorsTotal(): int .[method]
----------------------------
Zwraca liczbę kolorów w palecie obrazu. ([więcej |https://www.php.net/manual/en/function.imagecolorstotal])


colorTransparent(?int $color=null): int .[method]
-------------------------------------------------
Pobiera albo ustawia kolor przezroczysty w obrazie. ([więcej |https://www.php.net/manual/en/function.imagecolortransparent])


convolution(array $matrix, float $div, float $offset): void .[method]
---------------------------------------------------------------------
Stosuje do obrazu macierz splotu, używając podanego współczynnika i przesunięcia. ([więcej |https://www.php.net/manual/en/function.imageconvolution])

.[note]
Wymaga *Bundled GD extension*, 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 .[method]
--------------------------------------------------------------------------------------------------
Kopiuje część `$src` na obraz, zaczynając od współrzędnych `$srcX`, `$srcY`, o szerokości `$srcW` i wysokości `$srcH`. Zdefiniowany fragment zostanie skopiowany na współrzędne `$dstX` i `$dstY`. ([więcej |https://www.php.net/manual/en/function.imagecopy])


copyMerge(Image $src, int $dstX, int $dstY, int $srcX, int $srcY, int $srcW, int $srcH, int $opacity): void .[method]
---------------------------------------------------------------------------------------------------------------------
Kopiuje część `$src` na obraz, zaczynając od współrzędnych `$srcX`, `$srcY`, o szerokości `$srcW` i wysokości `$srcH`. Zdefiniowany fragment zostanie skopiowany na współrzędne `$dstX` i `$dstY`. ([więcej |https://www.php.net/manual/en/function.imagecopymerge])


copyMergeGray(Image $src, int $dstX, int $dstY, int $srcX, int $srcY, int $srcW, int $srcH, int $opacity): void .[method]
-------------------------------------------------------------------------------------------------------------------------
Kopiuje część `$src` na obraz, zaczynając od współrzędnych `$srcX`, `$srcY`, o szerokości `$srcW` i wysokości `$srcH`. Zdefiniowany fragment zostanie skopiowany na współrzędne `$dstX` i `$dstY`.

Funkcja ta jest identyczna z `copyMerge()`, z tą różnicą, że przy łączeniu zachowuje odcień źródła, konwertując przed operacją kopiowania piksele docelowe do skali szarości. ([więcej |https://www.php.net/manual/en/function.imagecopymergegray])


copyResampled(Image $src, int $dstX, int $dstY, int $srcX, int $srcY, int $dstW, int $dstH, int $srcW, int $srcH): void .[method]
---------------------------------------------------------------------------------------------------------------------------------
Kopiuje prostokątny fragment jednego obrazu do drugiego, płynnie interpolując wartości pikseli, dzięki czemu zwłaszcza zmniejszenie rozmiaru obrazu nadal zachowuje sporo ostrości.

Innymi słowy, `copyResampled()` weźmie z `$src` prostokątny obszar o szerokości `$srcW` i wysokości `$srcH` na pozycji (`$srcX`,`$srcY`) i umieści go w prostokątnym obszarze obrazu o szerokości `$dstW` i wysokości `$dstH` na pozycji (`$dstX`,`$dstY`).

Jeśli współrzędne oraz szerokości i wysokości źródła i celu się różnią, fragment obrazu zostanie odpowiednio rozciągnięty albo zmniejszony. Współrzędne odnoszą się do lewego górnego rogu. Funkcji można użyć do kopiowania obszarów w obrębie tego samego obrazu, ale jeśli obszary się nakładają, wyniki będą nieprzewidywalne. ([więcej |https://www.php.net/manual/en/function.imagecopyresampled])


copyResized(Image $src, int $dstX, int $dstY, int $srcX, int $srcY, int $dstW, int $dstH, int $srcW, int $srcH): void .[method]
-------------------------------------------------------------------------------------------------------------------------------
Kopiuje prostokątny fragment jednego obrazu do drugiego. Innymi słowy, `copyResized()` weźmie z `$src` prostokątny obszar o szerokości `$srcW` i wysokości `$srcH` na pozycji (`$srcX`,`$srcY`) i umieści go w prostokątnym obszarze obrazu o szerokości `$dstW` i wysokości `$dstH` na pozycji (`$dstX`,`$dstY`).

Jeśli współrzędne oraz szerokości i wysokości źródła i celu się różnią, fragment obrazu zostanie odpowiednio rozciągnięty albo zmniejszony. Współrzędne odnoszą się do lewego górnego rogu. Funkcji można użyć do kopiowania obszarów w obrębie tego samego obrazu, ale jeśli obszary się nakładają, wyniki będą nieprzewidywalne. ([więcej |https://www.php.net/manual/en/function.imagecopyresized])


crop(int|string $left, int|string $top, int|string $width, int|string $height): Image .[method]
-----------------------------------------------------------------------------------------------
Kadruje obraz do podanego obszaru prostokątnego. Wymiary można podać jako liczby całkowite w pikselach albo jako stringi w procentach (np. `'50%'`).


cropAuto(int $mode=0, float $threshold=.5, ?ImageColor $color=null): Image .[method]
------------------------------------------------------------------------------------
Automatycznie kadruje obraz zgodnie z podanym `$mode`. ([więcej |https://www.php.net/manual/en/function.imagecropauto])


ellipse(int $centerX, int $centerY, int $width, int $height, ImageColor $color): void .[method]
-----------------------------------------------------------------------------------------------
Rysuje elipsę o środku w podanych współrzędnych. ([więcej |https://www.php.net/manual/en/function.imageellipse])


fill(int $x, int $y, ImageColor $color): void .[method]
-------------------------------------------------------
Wykonuje wypełnienie powodziowe, zaczynając od podanych współrzędnych (lewy górny róg to 0, 0), kolorem `$color`. ([więcej |https://www.php.net/manual/en/function.imagefill])


filledArc(int $centerX, int $centerY, int $width, int $height, int $startAngle, int $endAngle, ImageColor $color, int $style): void .[method]
---------------------------------------------------------------------------------------------------------------------------------------------
Rysuje wycinek łuku o środku w podanych współrzędnych. ([więcej |https://www.php.net/manual/en/function.imagefilledarc])


filledEllipse(int $centerX, int $centerY, int $width, int $height, ImageColor $color): void .[method]
-----------------------------------------------------------------------------------------------------
Rysuje elipsę o środku w podanych współrzędnych. ([więcej |https://www.php.net/manual/en/function.imagefilledellipse])


filledPolygon(array $points, ImageColor $color): void .[method]
---------------------------------------------------------------
Tworzy w obrazie wypełniony wielokąt. ([więcej |https://www.php.net/manual/en/function.imagefilledpolygon])


filledRectangle(int $x1, int $y1, int $x2, int $y2, ImageColor $color): void .[method]
--------------------------------------------------------------------------------------
Tworzy w obrazie prostokąt wypełniony kolorem `$color`, zaczynający się w punkcie (`$x1`, `$y1`) i kończący w (`$x2`, `$y2`). Punkt (0, 0) to lewy górny róg obrazu. ([więcej |https://www.php.net/manual/en/function.imagefilledrectangle])


filledRectangleWH(int $x, int $y, int $width, int $height, ImageColor $color): void .[method]
---------------------------------------------------------------------------------------------
Tworzy w obrazie prostokąt wypełniony kolorem `$color`, zaczynający się w punkcie (`$x`, `$y`), o szerokości `$width` i wysokości `$height`. Punkt (0, 0) to lewy górny róg obrazu.


fillToBorder(int $x, int $y, ImageColor $borderColor, ImageColor $color): void .[method]
----------------------------------------------------------------------------------------
Wykonuje wypełnienie powodziowe, którego kolor granicy określa `$borderColor`. Punktem startowym wypełnienia jest (`$x`, `$y`) (lewy górny róg to 0, 0), a obszar wypełniany jest kolorem `$color`. ([więcej |https://www.php.net/manual/en/function.imagefilltoborder])


filter(int $filtertype, int ...$args): void .[method]
-----------------------------------------------------
Stosuje do obrazu podany filtr `$filtertype`. ([więcej |https://www.php.net/manual/en/function.imagefilter])


flip(int $mode): void .[method]
-------------------------------
Odbija obraz zgodnie z podanym `$mode`. ([więcej |https://www.php.net/manual/en/function.imageflip])


ftText(float $size, float $angle, int $x, int $y, ImageColor $color, string $fontFile, string $text, array $options=[]): array .[method]
----------------------------------------------------------------------------------------------------------------------------------------
Zapisuje tekst do obrazu. ([więcej |https://www.php.net/manual/en/function.imagefttext])


gammaCorrect(float $inputgamma, float $outputgamma): void .[method]
-------------------------------------------------------------------
Stosuje do obrazu korekcję gamma na podstawie gammy wejściowej i wyjściowej. ([więcej |https://www.php.net/manual/en/function.imagegammacorrect])


getClip(): array .[method]
--------------------------
Pobiera bieżący prostokąt przycięcia, czyli obszar, poza którym nie będą rysowane żadne piksele. ([więcej |https://www.php.net/manual/en/function.imagegetclip])


getHeight(): int .[method]
--------------------------
Zwraca wysokość obrazu.


getImageResource(): GdImage .[method]
-------------------------------------
Zwraca leżący u podstaw zasób obrazu GD.


getWidth(): int .[method]
-------------------------
Zwraca szerokość obrazu.


interlace(?int $interlace=null): int .[method]
----------------------------------------------
Włącza albo wyłącza przeplot. Jeśli przeplot jest włączony, a obraz zapisywany jest jako JPEG, zostanie zapisany jako progresywny JPEG. ([więcej |https://www.php.net/manual/en/function.imageinterlace])


isTrueColor(): bool .[method]
-----------------------------
Sprawdza, czy obraz jest typu truecolor. ([więcej |https://www.php.net/manual/en/function.imageistruecolor])


layerEffect(int $effect): void .[method]
----------------------------------------
Ustawia flagę mieszania alfa, aby używać efektów warstwowych. ([więcej |https://www.php.net/manual/en/function.imagelayereffect])


line(int $x1, int $y1, int $x2, int $y2, ImageColor $color): void .[method]
---------------------------------------------------------------------------
Rysuje linię między dwoma podanymi punktami. ([więcej |https://www.php.net/manual/en/function.imageline])


openPolygon(array $points, ImageColor $color): void .[method]
-------------------------------------------------------------
Rysuje w obrazie otwarty wielokąt. W odróżnieniu od `polygon()` nie rysuje linii między ostatnim a pierwszym punktem. ([więcej |https://www.php.net/manual/en/function.imageopenpolygon])


paletteCopy(Image $source): void .[method]
------------------------------------------
Kopiuje paletę z `$source` do obrazu. ([więcej |https://www.php.net/manual/en/function.imagepalettecopy])


paletteToTrueColor(): void .[method]
------------------------------------
Konwertuje obraz paletowy na obraz truecolor. ([więcej |https://www.php.net/manual/en/function.imagepalettetotruecolor])


place(Image $image, int|string $left=0, int|string $top=0, int $opacity=100): Image .[method]
---------------------------------------------------------------------------------------------
Kopiuje `$image` na bieżący obraz na współrzędnych (`$left`, `$top`). Współrzędne można podać jako liczby całkowite w pikselach albo jako stringi w procentach (np. `'50%'`).


polygon(array $points, ImageColor $color): void .[method]
---------------------------------------------------------
Tworzy w obrazie wielokąt. ([więcej |https://www.php.net/manual/en/function.imagepolygon])


rectangle(int $x1, int $y1, int $x2, int $y2, ImageColor $color): void .[method]
--------------------------------------------------------------------------------
Tworzy prostokąt o podanych współrzędnych. ([więcej |https://www.php.net/manual/en/function.imagerectangle])


rectangleWH(int $x, int $y, int $width, int $height, ImageColor $color): void .[method]
---------------------------------------------------------------------------------------
Tworzy prostokąt o podanych współrzędnych, używając szerokości i wysokości.


resize(int|string $width, int|string $height, int $mode=Image::OrSmaller): Image .[method]
------------------------------------------------------------------------------------------
Zmienia rozmiar obrazu, zobacz [więcej informacji |#Zmiana rozmiaru]. Wymiary można podać jako liczby całkowite w pikselach albo jako stringi w procentach (np. `'50%'`).


resolution(?int $resX=null, ?int $resY=null): mixed .[method]
-------------------------------------------------------------
Pozwala ustawić i pobrać rozdzielczość obrazu w DPI (punktach na cal). Jeśli nie podano żadnego z opcjonalnych parametrów, bieżąca rozdzielczość zwracana jest jako tablica indeksowana. Jeśli podano tylko `$resX`, rozdzielczość pozioma i pionowa ustawiane są na tę wartość. Jeśli podano oba opcjonalne parametry, rozdzielczość pozioma i pionowa ustawiane są odpowiednio na te wartości.

Rozdzielczość używana jest wyłącznie jako metainformacja, gdy obrazy odczytywane są z formatów wspierających tego rodzaju informacje i do nich zapisywane (obecnie PNG i JPEG). Nie wpływa na żadne operacje rysowania. Domyślną rozdzielczością nowych obrazów jest 96 DPI. ([więcej |https://www.php.net/manual/en/function.imageresolution])


rotate(float $angle, ImageColor $backgroundColor): Image .[method]
------------------------------------------------------------------
Obraca obraz o podany kąt `$angle` w stopniach. Środkiem obrotu jest środek obrazu, a obrócony obraz może mieć inne wymiary niż oryginał. ([więcej |https://www.php.net/manual/en/function.imagerotate])

.[note]
Wymaga *Bundled GD extension*, więc może nie działać wszędzie.


save(string $file, ?int $quality=null, ?int $type=null): void .[method]
-----------------------------------------------------------------------
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 wynika jednoznacznie z rozszerzenia pliku, możesz podać go za pomocą jednej ze stałych `ImageType`.


saveAlpha(bool $saveflag): void .[method]
-----------------------------------------
Ustawia flagę decydującą o tym, czy przy zapisywaniu obrazów PNG zapisywać pełną informację o kanale alfa (w przeciwieństwie do przezroczystości jednokolorowej).

Nette włącza tę flagę w konstruktorze `Image`, więc obraz wczytany albo utworzony przez `fromFile()`, `fromString()` czy `fromBlank()` zachowuje swój kanał alfa. Zwróć uwagę, że przy domyślnym trybie mieszania alfa rysowanego koloru służy tylko do zmieszania wyniku i nie jest zapisywana, więc jeśli rysowana przezroczystość ma przetrwać, wywołaj najpierw `alphaBlending(false)`. ([więcej |https://www.php.net/manual/en/function.imagesavealpha])


scale(int $newWidth, int $newHeight=-1, int $mode=IMG_BILINEAR_FIXED): Image .[method]
--------------------------------------------------------------------------------------
Skaluje obraz podanym algorytmem interpolacji. ([więcej |https://www.php.net/manual/en/function.imagescale])


send(int $type=ImageType::JPEG, ?int $quality=null): void .[method]
-------------------------------------------------------------------
Wysyła 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 .[method]
--------------------------------------
Ustawia obraz pędzla używany przez wszystkie funkcje rysujące linie (takie jak `line()` i `polygon()`) przy rysowaniu specjalnymi kolorami `IMG_COLOR_BRUSHED` albo `IMG_COLOR_STYLEDBRUSHED`. ([więcej |https://www.php.net/manual/en/function.imagesetbrush])


setClip(int $x1, int $y1, int $x2, int $y2): void .[method]
-----------------------------------------------------------
Ustawia bieżący prostokąt przycięcia, czyli obszar, poza którym nie będą rysowane żadne piksele. ([więcej |https://www.php.net/manual/en/function.imagesetclip])


setInterpolation(int $method=IMG_BILINEAR_FIXED): void .[method]
----------------------------------------------------------------
Ustawia metodę interpolacji, która wpływa na metody `rotate()` i `affine()`. ([więcej |https://www.php.net/manual/en/function.imagesetinterpolation])


getInterpolation(): int .[method]
---------------------------------
Zwraca bieżącą metodę interpolacji używaną przez metody `rotate()` i `affine()`.


setPixel(int $x, int $y, ImageColor $color): void .[method]
-----------------------------------------------------------
Rysuje piksel o podanych współrzędnych. ([więcej |https://www.php.net/manual/en/function.imagesetpixel])


setStyle(array $style): void .[method]
--------------------------------------
Ustawia styl używany przez wszystkie funkcje rysujące linie (takie jak `line()` i `polygon()`) przy rysowaniu specjalnym kolorem `IMG_COLOR_STYLED` albo linii obrazów kolorem `IMG_COLOR_STYLEDBRUSHED`. ([więcej |https://www.php.net/manual/en/function.imagesetstyle])


setThickness(int $thickness): void .[method]
--------------------------------------------
Ustawia grubość linii rysowanych przy rysowaniu prostokątów, wielokątów, łuków itd. na `$thickness` pikseli. ([więcej |https://www.php.net/manual/en/function.imagesetthickness])


setTile(Image $tile): void .[method]
------------------------------------
Ustawia obraz kafelka używany przez wszystkie funkcje wypełniające obszary (takie jak `fill()` i `filledPolygon()`) przy wypełnianiu specjalnym kolorem `IMG_COLOR_TILED`.

Kafelek to obraz służący do wypełnienia obszaru powtarzanym wzorem. Kafelkiem może być dowolny obraz, a ustawiając indeks koloru przezroczystego obrazu kafelka przez `colorTransparent()`, można stworzyć kafelek pozwalający prześwitywać pewnym częściom obszaru pod spodem. ([więcej |https://www.php.net/manual/en/function.imagesettile])


sharpen(): Image .[method]
--------------------------
Wyostrza obraz.

.[note]
Wymaga *Bundled GD extension*, więc może nie działać wszędzie.


toString(int $type=ImageType::JPEG, ?int $quality=null): string .[method]
-------------------------------------------------------------------------
Zwraca obraz jako string.

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 .[method]
--------------------------------------------------------------
Konwertuje obraz truecolor na obraz paletowy. ([więcej |https://www.php.net/manual/en/function.imagetruecolortopalette])


ttfText(float $size, float $angle, int $x, int $y, ImageColor $color, string $fontFile, string $text, array $options=[]): array .[method]
-----------------------------------------------------------------------------------------------------------------------------------------
Zapisuje podany tekst do obrazu. ([więcej |https://www.php.net/manual/en/function.imagettftext])