TIP: Přetáhni ikonu na hlavní panel pro připnutí webu
V úvodu jsme si řekli trochu základů o GD knihovně. Nyní se podíváme, jaké jsou způsoby vytvoření obrázku. Můžeme obrázek načíst z již existujícího, případně si vytvořit sami nový.
Podíváme se na hlavní funkce pro vytvoření obrázku z GIF, JPEG, PNG, WBMP. Jako dodatek k této lekci se vám pokusím popsat i další možnosti vytvoření obrázku. V podstatě zde není pomalu o čem psát, ale je to jeden ze základních kamenů pro práci s obrázky v PHP. Pro vytvoření obrázku nám slouží tyto funkce:
- Klasické funkce
imagecreate()imagecreatetruecolor()imagecreatefromgif()imagecreatefromjpeg()imagecreatefrompng()imagecreatefromwbmp()
- Speciální funkce
imagecreatefromxbm()imagecreatefromxpm()imagecreatefromgd2()imagecreatefromgd2part()imagecreatefromgd()imagecreatefromstring()
A nyní si jednu po druhé projdeme.
Vytvoření nového obrázku
Pro vytvoření prázdného nového obrázku nám slouží dvě funkce – imagecreate() a imagecreatetruecolor(). Funkce imagecreate() by měla fungovat vždy, na rozdíl od imagecreatetruecolor(). Tato funkce je závislá na verzi PHP a GD knihovny, navíc není schopna pracovat s GIF formátem. Obrázek má jako výchozí barvu pozadí černou.
- POPIS FUNKCE:
resource imagecreate ( int $sirka, int $vyska)- Proměnné:
vyska → udává výšku obrázku v pixelech
sirka → udává šířku obrázku v pixelech - Návratové hodnoty:
V případě úspěchu vrací identifikátor, v případě selhání vrací FALSE.
- Proměnné:
- POPIS FUNKCE:
resource imagecreatetruecolor ( int $sirka, int $vyska )- Proměnné:
vyska → udává výšku obrázku v pixelech
sirka → udává šířku obrázku v pixelech - Návratové hodnoty:
V případě úspěchu vrací identifikátor, v případě selhání vrací FALSE. - Poznámka:
Tato funkce vyžaduje GD 2.0.1 nebo novější (doporučena verze 2.0.28 nebo novější).
- Proměnné:
Vytvoření obrázku z GIF souboru
Dále je možno vytvořit obrázek z GIF souboru a dále jej upravovat. Ale nesmí to být přímo animace. Pokud takto načtete GIF animaci a potom se ji pokusíte upravit, dojde k tomu, že se vám obrázek rozmaže a vzniknou různé barevné čáry.
- POPIS FUNKCE:
resource imagecreatefromgif ( string $soubor )- Proměnné:
soubor → udává cestu souboru - Návratové hodnoty:
V případě úspěchu vrací identifikátor, v případě selhání vrací FALSE.
- Proměnné:
Vytvoření obrázku z JPEG souboru
Asi jedna z nejpoužívanějších funkcí, vytváří obrázek z JPEG souborů. Tato funkce je velmi dobrá pro fotogalerie, což si ukážeme v některém z pozdějších dílů.
- POPIS FUNKCE:
resource imagecreatefromjpeg ( string $soubor )- Proměnné:
soubor → udává cestu souboru - Návratové hodnoty:
V případě úspěchu vrací identifikátor, v případě selhání vrací FALSE.
- Proměnné:
Vytvoření obrázku z PNG souboru
Zde funkce slouží pro načtení PNG souboru. Dá se velmi dobře použít pro různé ikonky, ovládací prvky a podobné věci.
- POPIS FUNKCE:
resource imagecreatefrompng ( string $soubor )- Proměnné:
soubor → udává cestu souboru - Návratové hodnoty:
V případě úspěchu vrací identifikátor, v případě selhání vrací FALSE.
- Proměnné:
Vytvoření obrázku z WBMP souboru
WBMP formátu je formát užívaný na WAP-u.
- POPIS FUNKCE:
resource imagecreatefromwbmp ( string $soubor )- Proměnné:
soubor → udává cestu souboru - Návratové hodnoty:
V případě úspěchu vrací identifikátor, v případě selhání vrací FALSE.
- Proměnné:
Návratové hodnoty
Většina GD funkcí vrací ukazatel (handler) na daný prvek. V případě, že funkce selže vrací FALSE. Ale i zde nejsou výjimkou funkce, které vrací v případě úspěchu TRUE. Proto doporučuji dát každé provedení funkce do podmínky a testovat tím, zda byla funkce správně provedena. Pokud nebyla, tak skript ukončit.
Zobrazení a uložení
Pro zobrazení, případně uložení obrázku se využívá funkcí imagejpeg(), imagegif(), imagepng(), imagewbmp(). Tyto funkce uloží nebo vytisknou obsah zdrojového objektu. Nejméně vstupních parametrů má GIF. Dále se mohou parametry různě lišit. Kvalita, tento parametr udává procentuální hodnotu kvality komprimace. Čím je toto číslo větší, tím je kvalita vyšší, ale současně rozste i velikost souboru.
- POPIS FUNKCÍ:
bool imagejpeg ( resource $obrazek [, string $soubor [, int $kvalita ]] )
bool imagegif ( resource $obrazek [, string $soubor ] )
bool imagepng ( resource $obrazek [, string $soubor [, int $kvalita [, int $filtry ]]] )
bool imagewbmp ( resource $obrazek [, string $soubor [, int $popredi ]] )- Proměnné:
obrazek → udává obrázek
soubor → udává cestu k souboru, kam má být obrázek uložen
kvalita (nepovinné) → udává kvalitu uloženého obrázku (JPEG: 0-100; PNG: 0-9)
filtry (nepovinné) → možnost použití některého z filtrů
popredi (nepovinné) → možnost volby barvy popředí - Návratové hodnoty:
V případě zdárného provedení vrací TRUE, v případě chyby vrací FALSE.
- Proměnné:
Jak jsem již naznačil, jsou tyto funkce schopny buď ukládat do souborů, případně rovnou zobrazovat na obrazovku. Chcete-li obrázek uložit, zadejte cestu k souboru, kam jej chcete uložit. Cílový soubor nemusí existovat, ale důležité je oprávnění zápisu do složky. Nebude-li v atributech složky nastaveno, že je do ní možno zapisovat, obrázek se neuloží. V případě, že chcete obrázek pouze zobrazit, musíte před touto funkcí použít header() a určit formát zobrazovaného obrázku.
//nacteni obrazku ze souboru JPEG
if(!$im=imagecreatefromjpeg("priklad.jpg")){
echo "Chyba při načtení souboru";
exit;
}
//prime zobrazeni
header("Content-type: image/jpeg"); //deklarovani typu souboru
/*
hlavicky podle typu souboru:
imagejpeg() -> header("Content-type: image/jpeg");
imagegif() -> header("Content-type: image/gif");
imagepng() -> header("Content-type: image/png");
imagewbmp() -> header("Content-type: image/vnd.wap.wbmp");
*/
imagejpeg($im, "", 100); //odeslani $im na vystup s kvalitou 100 %
/*
Obrazek odesleme primo na vystup tim, ze uvedeme pouze zdroj
a dalsi parametry vynechame, pripadne druhy parametr
zadame jako prazdny.
*/
//ulozeni do souboru s kvalitou 100 %
imagejpeg($im, "priklad-vysledek.jpg", 100);Stejně jako drtivá většina funkcí PHP jsou i tyto funkce závislé na verzi PHP, případně GD knihovny. Pro upřesnění zde uvádím souhrn možností:
imagejpeg()
GD 1.8 a novější: podpora JPEG formátu
imagepng()
PHP 5.1.2: přidání parametru kvalita
PHP 5.1.3: přidání parametru filtry
imagewbmp()
GD 1.8 a pozdější: podpora WBMP formátu
