Práce s obrázky - Jet\Data_Image
Třída je určena pro práci s obrázky ve smyslu jejich validace, změn velikosti a vytváření náhledů.
Přehled metod
Metoda | Význam |
---|---|
public __construct( string $path ) |
Na základě cesty provede konstruktor základní ověření obrázku (zda soubor existuje, je čitelný a jedná se o podporovaný typ obrázku) a načte si o obrázku informace (typ a rozměry obrázku). V případě neúspěchu vyhazuje výjimku Jet\Data_Image_Exception. Při práci s obrázky je tedy žádoucí operaci uzavřít do try{}catch. |
public getPath( ) : string |
Vrátí celou cestu k souboru obrázku. |
public getDirectory( ) : string |
Vrátí cestu k adresáři, kde se obrázek nalézá. |
public getFileName( ) : string |
Vrátí název souboru obrázku (bez adresáře). |
public getWidth( ) : int |
Vrátí šířku obrázku. |
public getHeight( ) : int |
Vrátí výšku obrázku. |
public getImgType( ) : int |
Vrátí číslo typu obrázku tak jak je zná a používá PHP. |
public getMimeType( ) : string |
Vrátí MIME typ obrázku. |
public getImageQuality( ) : int |
Pro účel dalšího zpracování nastavuje kvalitu obrázku (pro typy souborů obrázků, kde to má význam). |
public setImageQuality( int $image_quality ) : void |
Vrací kvalitu obrázku nastavenou pro další zpracování. |
public createThumbnail( string $target_path, int $maximal_width, int $maximal_height, ?int $target_img_type=null ) : static |
Vytvoří náhled - zmenšeninu obrázku o daných maximálních rozměrech se zachováním poměru stran a uloží jej na určenou cestu. Typ výsledného obrázku může být zachován, nebo může být použita adekvátní PHP konstanta typu obrázku. Výsledný obrázek vrátí v podobě instance třídy Jet\Data_Image a je tedy možné s výsledným obrázkem ihned dále operovat. |
public saveAs( string $target_path, ?int $new_width=null, ?int $new_height=null, ?int $target_img_type=null ) : static |
Změní velikost obrázku na přesně dané údaje (neřeší poměry stran) a uloží jej na danou cestu. Typ výsledného obrázku může být zachován, nebo může být použita adekvátní PHP konstanta typu obrázku. Výsledný obrázek vrátí v podobě instance třídy Jet\Data_Image a je tedy možné s výsledným obrázkem ihned dále operovat. |