Opasarkisto: PHP: GD-kirjaston käyttö

Tässä oppaassa kerrotaan, kuinka PHP:llä on mahdollista luoda lennossa kuvia GD-kirjaston avulla. Useimmilta palvelimilta tämä kirjasto nykyisin löytyy, ja jos haluat testata skriptejä omalla koneellasi, voit asentaa kirjaston, ellet niin vielä ole tehnyt.

GD-kirjastosta on olemassa lukuisia versioita, joissa uudemmissa on aina enemmän funktioita. Tästä syystä kaikki tässä oppaassa esitetyt funktiot eivät välttämättä toimi, jos käyttämälläsi palvelimella on vanhempi versio kirjastosta. Mukaan on kuitenkin pyritty ottamaan lähinnä tavallisimpia funktioita.

Esimerkkiskripti

Aloitetaan pienellä esimerkillä, joka luo yksinkertaisen kuvan.

<?php

//lähetetään tunniste selaimelle
header("Content-type: image/png");

//luodaan 200x100-pikselin kokoinen kuva
$kuva=imagecreate(200,100);

//määritetään taustaväri ja kaksi muuta väriä
$tausta=imagecolorallocate($kuva, 255, 255, 255);
$musta=imagecolorallocate($kuva,0,0,0);
$sininen=imagecolorallocate($kuva,0,0,255);

//piirretään kehykset, teksti ja viiva
imagerectangle($kuva,0,0,199,99,$musta);
imagestring($kuva,2,10,10,"GD-kirjasto toimii!",$sininen);
imageline($kuva,10,24,130,80,$sininen);

//lähetetään kuva PNG-muodossa
imagepng($kuva);

//poistetaan kuva muistista
imagedestroy($kuva);
?>

Tämä skripti piirtää seuraavanlaisen kuvan:

Esimerkin toiminta

Ensimmäisellä rivillä header-komento lähettää selaimelle tiedon siitä, että tulossa on PNG-tyyppinen kuva. GD-kirjasto tukee useita kuvaformaatteja, josta käytetyimmät ovat PNG ja JPEG. Vastaavasti JPEG:n tapauksessa header-merkkijono olisi "Content-type: image/jpeg".

Kuva luodaan imagecreate-funktiolla. Parametrit ovat kuvan leveys ja korkeus pikseleinä. Funktio palauttaa kuvan tunnisteen, tässä tapauksessa muuttujaan $kuva, jota käytetään seuraavien piirtofunktioiden kanssa. Kuvan pohjaksi voi ottaa myös toisen kuvan. Tämä tapahtuu formaatista riippuen imagecreatefrompng- ja imagecreatefromjpeg-funktioilla, jolloin parametriksi annetaan kuvatiedoston nimi.

Tämän jälkeen määritellään kolme kuvassa käytettävää väriä imagecolorallocate-funktiolla. Funktio palauttaa arvon, jota voi myöhemmin käyttää piirtofunktioissa. Ensimmäinen määriteltävä väri tulee kuvan taustaväriksi. Värit määritetään RGB-arvona (punaisen, vihreän ja sinisen määrä välillä 0-255).

Seuraavilla riveillä imagerectangle, imagestring ja imageline piirtävät itse kuvan – näistä funktioista pian lisää.

Funktio imagepng lähettää lopullisen kuvan selaimelle PNG-muodossa. Vastaava funktio JPEG-muodossa olisi imagejpeg. Kuvan voi myös tallentaa tiedostoon, jolloin tiedoston nimi on funktion toinen parametri.

Loppuun on hyvä laittaa imagedestroy-funktio, joka poistaa kuvan varaaman tilan muistista.

Muutamia piirtofunktioita

Tässä on joitakin GD-kirjaston kymmenistä piirtofunktioista. Kuvan tunniste tarkoittaa imagecreate-funktion palauttamaa arvoa. X on vaakasuuntainen etäisyys vasemmasta laidasta ja y on pystysuuntainen etäisyys ylälaidasta. Viivan väri on imagecolorallocate-funktion palauttama arvo.

• Funktio imagecolorat palauttaa pisteen värin kuvasta. Parametrit ovat kuvan tunniste sekä pisteen x ja y.
• Funktio imagecopy kopioi osan kuvasta toiseen kuvaan. Parametrit ovat kohde- ja lähdekuvan tunniste, kohdekuvan x ja y, lähdekuvan x ja y sekä kopioitavan osan leveys ja korkeus. imagecopyresized ja imagecopyresampled osaavat lisäksi pienentää tai suurentaa kuvan kokoa, niissä ilmoitetaan sekä lähdekuvan leveys ja korkeus että kohdekuvan leveys ja korkeus.
• Funktio imageellipse piirtää ympyrän tai ellipsin. Parametrit ovat kuvan tunniste, keskipisteen x ja y, ympyrän leveys ja korkeus sekä ympyrän väri.
• Funktio imageline piirtää viivan. Parametrit ovat kuvan tunniste, viivan aloituskohdan x ja y, viivan lopetuskohdan x ja y sekä viivan väri.
• Funktio imagepolygon piirtää monikulmion. Parametrit ovat kuvan tunniste, taulukko pisteistä, pisteiden määrä ja väri. (*)
• Funktio imagerectangle piirtää nelikulmion. Parametrit ovat kuvan tunniste, nelikulmion vasemman ylänurkan x ja y, oikean alanurkan x ja y sekä nelikulmion väri. (*)
• Funktio imagerotate pyörittää kuvaa. Parametrit ovat kuvan tunniste, pyöritettävä kulma asteina ja taustaväri.
• Funktio imagesetpixel piirtää yhden pisteen. Parametrit ovat kuvan tunniste, pisteen x ja y sekä pisteen väri. (*)
• Funktio imagestring kirjoittaa tekstiä. Parametrit ovat kuvan tunniste, tekstin fonttityyppi (1-5), tekstin aloituskohdan x ja y sekä teksti ja tekstin väri.
• Funktiot imagesx ja imagesy palauttavat kuvan leveyden ja korkeuden. Funktioille annetaan parametriksi kuvan tunniste.

Funktiot, joiden perässä on (*), voidaan piirtää myös täytettynä, jolloin image-sanan jälkeen tulee filled (imagerectangle -> imagefilledrectangle).

Loppusanat

Kun kuvien luomisen perusteet alkavat olla hanskassa, kannattaa siirtyä PHP:n manuaalin pariin. Sieltä löytyy mm. kaikkien piirtofunktioiden kuvaukset sekä muuta lisätietoa GD-kirjaston käytöstä. Tämä opas päättyy tähän, kysymyksiä ja palautetta voi lähettää sähköpostilla.