PHPBuilder.com, the best resource for PHP tutorials, templates, PHP manuals, content management systems, scripts, classes and more.

Index: phpdoc/hu/functions/image.xml diff -u /dev/null phpdoc/hu/functions/image.xml:1.5 --- /dev/null Thu Aug 30 14:39:14 2001 +++ phpdoc/hu/functions/image.xml Thu Aug 30 14:39:14 2001 @@ -0,0 +1,2081 @@ + + + + + Image functions + Graphics + + + + A PHP k�pmanipul�l� f�ggv�nyeit haszn�lhatod + JPEG, GIF, + PNG �s SWF k�pek m�reteinek + lek�rdez�s�re, �s ha van GD k�nyvt�rad, mely + a &url.gd; c�men �rhet� el, + tudsz vele k�peket k�sz�teni �s manipul�lni. + + + + + + GetImageSize + Egy GIF, JPEG, PNG vagy SWF k�p m�ret�t adja vissza + + + Le�r�s + + + array getimagesize + string filename + array + imageinfo + + + + + A GetImageSize f�ggv�ny meg�llap�tja a + m�ret�t b�rmely + GIF, JPG, + PNG vagy SWF filenak + �s visszaadja a k�p m�reteit along with a file type and a height/width + text string to be used inside a normal HTML + IMG tag. + + + Egy 4 elem� t�mbbel t�r vissza. A t�mb els� eleme (indexe 0) a k�p + sz�less�ge pixelben. A k�vetkez� a k�p magass�ga. A harmadik + pedig egy flag, amely a k�p t�pus�ra utal. + 1 = GIF, 2 = JPG, 3 = PNG, 4 = SWF. + A negyedik pedig egy string, amely tartalmazza a megfelel� + "height=xxx width=xxx" string, amit egy az egyben bele tudsz + �rni egy IMG tagbe. + + GetImageSize + +<?php $size = GetImageSize ("img/flag.jpg"); ?> +<IMG SRC="img/flag.jpg" <?php echo $size[3]; ?> + + + + + Az opcion�lis imageinfo param�ter lehet�v� + teszi n�h�ny plusz inform�ci� kinyer�s�t a fileb�l ['''''''] + Jelenleg ez a k�l�nb�z� + JPG APP jelz�seket asszociat�v t�mb form�j�ban + adja vissza. N�h�ny program ezeket az APP jelz�seket haszn�lja, + hogy sz�veges inform�ci�t rejtsen a k�pekbe. + A legismertebb az IPTC + &url.iptc; inform�ci� belarak�sa + az APP13 jelz�sbe. Az iptcparse funkci�t + haszn�lhatod arra, hogy a bin�ris APP13 jelz�st valami olvashat�v� + alak�tsd. + + IPTC inform�ci� kinyer�se a GetImageSize seg�ts�g�vel + +<?php + $size = GetImageSize ("testimg.jpg",&$info); + if (isset ($info["APP13"])) { + $iptc = iptcparse ($info["APP13"]); + var_dump ($iptc); + } +?> + + + + + Ehhez a f�ggv�nyhez nem kell a GD k�nyvt�r. + + + + + + + + + ImageArc + Egy ellipszisdarabot rajzol + + + Le�r�s + + + int imagearc + int im + int cx + int cy + int w + int h + int s + int e + int col + + + + Az ImageArc f�ggv�ny egy ellipszisdarabot + rajzol az im-mel azonos�tott k�pre cx, + cy k�z�pponttal (a k�p bal fels� sz�le a 0, 0). + A w [kis w!] �s a h + param�terek az ellipszis sz�less�g�t illetve magass�g�t hat�rozz�k + meg. Az ellipszisdarab kezd� �s v�gpontj�t fokban a + s �s a e[nincs pont] + adj�k meg. + + + + + + + ImageChar + Egy karaktert rajzol v�zszintesen + + + Le�r�s + + + int imagechar + int im + int font + int x + int y + string c + int col + + + + Az ImageChar f�ggv�ny megrajzolja a + c string els� bet�j�t col + sz�nnel az id-vel azonos�tott k�pen a bet� bal + fels� sark�t az x,y + koordin�t�hoz igaz�tva (a k�p bal fels� sz�le a 0, 0 pont). + with a color . Ha font[kell parameter] + �rt�ke 1, 2, 3, 4 vagy 5, egy be�p�tett font ker�l haszn�latra + (nagyobb sz�m nagyobb fontot jelent). + + + L�sd m�g az imageloadfont funkci�t. + + + + + + + ImageCharUp + Egy karaktert rajzol f�gg�legesen + + + Le�r�s + + + int imagechar + int im + int font + int x + int y + string c + int col + + + + Az ImageChar f�ggv�ny megrajzolja a + c string els� bet�j�t col + sz�nnel az id-vel azonos�tott k�pen a bet� bal + fels� sark�t az x,y + koordin�t�hoz igaz�tva (a k�p bal fels� sz�le a 0, 0 pont). + with a color . Ha font[kell parameter] + �rt�ke 1, 2, 3, 4 vagy 5, egy be�p�tett font ker�l haszn�latra + (nagyobb sz�m nagyobb fontot jelent). + + + L�sd m�g az imageloadfont funkci�t. + + + + + + + ImageColorAllocate + Egy sz�nt foglal le egy k�pben + + + Le�r�s + + + int imagecolorallocate + int im + int red + int green + int blue + + + + Az ImageColorAllocate egy sz�nk�ddal t�r vissza, + amelyet a f�gg�ny a megadotott RGB komponensekb�l + [....] + Az im param�ter az + imagecreate funkci� �ltal visszaadott �rt�k. + [Ez m�g k�ne bele... + A red, green �s + blue param�terek a sz�n v�r�s, z�ld �s a k�k + komponenseit hat�rozz�k meg. A komponensek �rt�kei 0 �s 255 k�z�tti + eg�sz sz�mok. + ] + Az ImageColorAllocate f�ggv�nyt meg kell + h�vnod az �sszes olyan sz�nre, amelyet az im-mel + azonos�tott k�pben haszn�lni akarsz. + + + +$feher = ImageColorAllocate ($im, 255, 255, 255); +$fekete = ImageColorAllocate ($im, 0, 0, 0); + + + + + + + + + ImageColorDeAllocate + + Egy sz�nt szabad�t fel egy k�pb�l + + + + Le�r�s + + + int + imagecolordeallocate + + int + im + + int + index + + + + + Az ImageColorDeAllocate funkci� felszabad�t + egy kor�bban az ImageColorAllocate �ltal + lefoglalt sz�nt. + + +$feher = ImageColorAllocate($im, 255, 255, 255); +ImageColorDeAllocate($im, $feher); + + + + + + + + + ImageColorAt + Egy k�ppont sz�n�nek index�t adja vissza + + + Le�r�s + + + int imagecolorat + int im + int x + int y + + + + A param�terek �ltal meghat�rozott k�pen �s helyen l�v� k�ppont + sz�n�nek index�vel t�r vissza. + + + L�sd m�g a imagecolorset �s a + imagecolorsforindex f�ggv�nyeket. + + + + + + + ImageColorClosest + + Az adott sz�nhez legk�zelebb �ll� sz�n index�t adja vissza + + + + Le�r�s + + + int imagecolorclosest + int im + int red + int green + int blue + + + + A k�p palett�j�nak azon index�t adja vissza, amely a param�terekben + megadott RGB �rt�khez a "legk�zelebb" van. + + + A "t�vols�g" a k�v�nt sz�n �s a t�bbi palettasz�n k�z�tt �gy ker�l + meghat�roz�sra, mintha a sz�nek RGB komponens�t + egy h�romdimenzi�s t�rben �br�zoln�nk, s a k�zt�k lev� t�vols�got + m�rn�nk. + + + L�sd m�g a imagecolorexact f�ggv�nyt. + + + + + + + ImageColorExact + A megadott sz�n palettabeli index�t adja vissza + + + Le�r�s + + + int imagecolorexact + int im + int red + int green + int blue + + + + Az adott sz�n palettablei index�t adja vissza. + image. + + + Ha a sz�n nem szerepel a k�p palett�j�ban, -1-gyel t�r vissza. + + + L�sd m�g a imagecolorclosest f�ggv�nyt. + + + + + + + ImageColorResolve + + Az adott sz�n, vagy ahhoz legk�zelebbi sz�n + palettaindex�t adja vissza. + + + + Le�r�s + + + int imagecolorresolve + int im + int red + int green + int blue + + + + A f�ggv�ny garant�ltan visszaad egy indexet a k�v�nt sz�nre v�laszul, + vagy a sz�n palettaindex�t, vagy a legk�zelebbi lehets�ges alternat�v��t. + + + L�sd m�g a imagecolorclosest f�ggv�nyt. + + + + + + + ImageGammaCorrect + + A GD k�pre gamma korrekci�t alkalmaz + + + + Le�r�s + + + int + imagegammacorrect + + int + im + + double + inputgamma + + double + outputgamma + + + + + A ImageGammaCorrect f�ggv�ny gamma korrekci�t alkalmaz + egy gd k�pfolyamra (im). A korrekci� m�rt�k�t a + bemeneti �s a kimeneti gamma �rt�ke hat�rozza meg + (inputgamma �s az outputgamma). + + + + + + + ImageColorSet + + Adott index� palettasz�n megv�ltoztat�sa + + + + Le�r�s + + + bool imagecolorset + int im + int index + int red + int green + int blue + + + + A f�ggv�ny az adott palettaindex� sz�nt a param�terekben + megadott sz�n�v� v�ltoztatja. Hasznos kit�lt�sszer� + m�veletekhez indexelt szervez�s� k�pekben, mert nem kell + a t�nyleges kit�lt�shez sz�ks�ges plusz m�veleteket v�grehajtani. + + + L�sd m�g a imagecolorat f�ggv�nyt. + + + + + + + ImageColorsForIndex + Adott index� sz�n RGB komponensei + + + Le�r�s + + + array imagecolorsforindex + int im + int index + + + + Egy asszociat�v t�mbbel t�r vissza, mely az adott index� paletta + v�r�s, z�ld �s k�k komponenseit tartalmazza. + + + L�sd m�g a imagecolorat �s + imagecolorexact f�ggv�nyeket. + + + + + + + ImageColorsTotal + + A k�p palett�j�ban lev� sz�nek sz�m�t adja + + + + Le�r�s + + + int imagecolorstotal + int im + + + + A megadott k�p sz�neinek sz�m�t adja vissza. + + + L�sd m�g a imagecolorat �s a + imagecolorsforindex f�ggv�nyeket. + + + + + + + ImageColorTransparent + Egy sz�nt �tl�tsz�nak defini�l + + + Le�r�s + + + int imagecolortransparent + int im + int + col + + + + + Az ImageColorTransparent az + im k�pben az �tl�tsz� sz�nt + col-ra �ll�tja. + Az im az + ImageCreate �ltal visszaadott �rt�k �s + col pedig egy + ImageColorAllocate �ltal visszaadott + azonos�t�. + + + Az �j (vagy az aktu�lis, ha m�g nincs[ez �gy h�lyes�g!]) �tl�tsz� sz�n azonos�t�j�val t�r vissza. + + + + + + + ImageCopy + + K�p egy r�sz�t m�solja + + + + Le�r�s + + + int + ImageCopy + + int + dst_im + + int + src_im + + int + dst_x + + int + dst_y + + int + src_x + + int + src_y + + int + src_w + + int + src_h + + + + + A src_im k�p egy r�sz�t dst_im-be + m�solja, a r�szlet m�sol�s�t a src_x, src_y + koordin�t�kkal kezd�dik, a k�pr�szlet sz�less�ge + src_w, magass�ga + src_h. + A r�szlet bal fels� sarka a dst_x, + dst_y koordin�t�ra ker�l. + + + + + + + ImageCopyResized + M�solja �s �tm�retezni egy k�p r�szlet�t + + + Le�r�s + + + int imagecopyresized + int dst_im + int src_im + int dstX + int dstY + int srcX + int srcY + int dstW + int dstH + int srcW + int srcH + + + + Az ImageCopyResized f�ggv�ny egy k�p t�glalap + alak� r�sz�t m�solja �t egy m�sik k�pbe. + Dst_im a t�rgyk�p, + src_im a forr�sk�p azonos�t�ja. + Ha a forr�s �s a c�lk�p koordin�t�i, sz�less�ge, magass�ga k�l�nb�zik, + a k�pdarabon ny�jt�s, �sszenyom�s hajt�dik v�gre. + A koordin�t�k a k�pdarabok bal fels� koordin�t�i. + Ezt a funkci�t egyazon k�pen bel�li m�sol�sra is lehet haszn�lni + (ha a dst_im �s a src_im + prarm�ter azonos), de ha az egyes r�szletek �tfedik egym�st, + az eredm�ny kisz�m�thatatlan. + + + + + + + ImageCreate + Egy �j k�pet hoz l�tre + + + Le�r�s + + + int imagecreate + int x_size + int y_size + + + + Az ImageCreate f�ggv�ny egy k�pazonos�t�val + t�r vissza, mely �res, �s m�rete x_size * + y_size. + + + + + + + ImageCreateFromGif + Fileb�l vagy URL-b�l �j k�pet hoz l�tre + + + Le�r�s + + + int imagecreatefromgif + string filename + + + + Az ImageCreateFromGif egy k�pazonos�t�val t�r vissza, + mely az adott filen�vb�l l�trehozott k�pet tartalmazza. + + + Az ImageCreateFromGif �res stringgel t�r vissza + hiba eset�n. Hiba�zenetet is ad, amit hib�s linkk�nt l�tunk a b�ng�sz�ben [???] + A nyomk�vet�s megk�nny�t�s�re a k�vetkez� p�lda egy hib�t jelz� GIF-et �ll�t el�. + + + L�trehoz�s k�zbeni hiba kezel�se (vic <email protected> j�volt�b�l) + + +function LoadGif ($imgname) { + $im = <email protected> ($imgname); /* K�s�rlet a megnyit�sra */ + if ($im == "") { /* Megn�zz�k, hogy siker�lt-e */ + $im = ImageCreate (150, 30); /* �res k�p l�trehoz�sa */ + $bgc = ImageColorAllocate ($im, 255, 255, 255); + $tc = ImageColorAllocate ($im, 0, 0, 0); + ImageFilledRectangle ($im, 0, 0, 150, 30, $bgc); + /* Hiba�zenet */ + ImageString($im, 1, 5, 5, "Hiba $imgname k�p bet�lt�s�n�l", $tc); + } + return $im; +} + + + + + Mivel mindenf�le GIF t�mogat�st az 1.6-os verzi�ban t�r�ltek, + ez a funkci� nem el�rhet�, ha �pp azt a verzi�t haszn�lod. + + + + + + + + + ImageCreateFromJpeg + Fileb�l vagy URL-b�l �j k�pet hoz l�tre + + + Le�r�s + + + int imagecreatefromjpeg + string filename + + + + Az ImageCreateFromJpeg egy k�pazonos�t�val t�r vissza, + mely az adott filen�vb�l l�trehozott k�pet tartalmazza. + + + Az ImageCreateFromJpeg �res stringgel t�r vissza + hiba eset�n. Hiba�zenetet is ad, amit hib�s linkk�nt l�tunk a b�ng�sz�ben [???] + A nyomk�vet�s megk�nny�t�s�re a k�vetkez� p�lda egy hib�t jelz� JPEG-et �ll�t el�. + + + L�trehoz�s k�zbeni hiba kezel�se (vic <email protected> j�volt�b�l) + + +function LoadJpeg ($imgname) { + $im = <email protected> ($imgname); /* K�s�rlet a megnyit�sra */ + if ($im == "") { /* Megn�zz�k, hogy siker�lt-e */ + $im = ImageCreate (150, 30); /* �res k�p l�trehoz�sa */ + $bgc = ImageColorAllocate ($im, 255, 255, 255); + $tc = ImageColorAllocate ($im, 0, 0, 0); + ImageFilledRectangle ($im, 0, 0, 150, 30, $bgc); + /* Hiba�zenet */ + ImageString($im, 1, 5, 5, "Hiba $imgname k�p bet�lt�s�n�l", $tc); + } + return $im; +} + + + + + + + + + ImageCreateFromPng + F�jlb�l vagy URL-b�l �j k�pet hoz l�tre + + + Le�r�s + + + int imagecreatefrompng + string filename + + + + Az ImageCreateFromPng egy k�pazonos�t�val t�r vissza, + mely az adott filen�vb�l l�trehozott k�pet tartalmazza. + + + Az ImageCreateFromPng �res stringgel t�r vissza + hiba eset�n. Hiba�zenetet is ad, amit hib�s linkk�nt l�tunk a b�ng�sz�ben [???] + A nyomk�vet�s megk�nny�t�s�re a k�vetkez� p�lda egy hib�t jelz� PNG-t �ll�t el�. + + + L�trehoz�s k�zbeni hiba kezel�se (vic <email protected> j�volt�b�l) + + +function LoadPNG ($imgname) { + $im = <email protected> ($imgname); /* K�s�rlet a megnyit�sra */ + if ($im == "") { /* Megn�zz�k, hogy siker�lt-e */ + $im = ImageCreate (150, 30); /* �res k�p l�trehoz�sa */ + $bgc = ImageColorAllocate ($im, 255, 255, 255); + $tc = ImageColorAllocate ($im, 0, 0, 0); + ImageFilledRectangle ($im, 0, 0, 150, 30, $bgc); + /* Hiba�zenet */ + ImageString($im, 1, 5, 5, "Hiba $imgname k�p bet�lt�s�n�l", $tc); + } + return $im; +} + + + + + + + + + + ImageDashedLine + Szaggatott vonalat rajzol + + + Le�r�s + + + int imagedashedline + int im + int x1 + int y1 + int x2 + int y2 + int col + + + + Az ImageDashedLine f�ggv�ny szaggatott vonalat + rajzol az x1, y1 pontb�l az + x2, y2 pontba az + im k�pen col sz�nnel. + (A k�p bal fels� sarka a 0, 0 koordin�t�j� pont.) + + + L�sd m�g az ImageLine f�ggv�nyt. + + + + + + + ImageDestroy + Megsemmis�t egy k�pet + + + Le�r�s + + + int imagedestroy + int im + + + + Az ImageDestroy f�ggv�ny felszabad�tja az + im k�p �ltal lefoglalt mem�ri�t. + Im egy ImageCreate f�ggv�ny + �ltal visszaadott k�p azonos�t�. + + + + + + + ImageFill + Z�rt ter�let kifest�se + + + Le�r�s + + + int imagefill + int im + int x + int y + int col + + + + Az ImageFill f�ggv�ny az + x, y koordin�t�t�l kezdve + �tsz�nez egy z�rt ter�letet az im k�pen + col sz�n�v�. + (A k�p bal fels� sarka a 0, 0 koordin�t�j� pont.) + + + + + + + ImageFilledPolygon + Kit�lt�tt soksz�get rajzol + + + Le�r�s + + + int imagefilledpolygon + int im + array points + int num_points + int col + + + + Az ImageFilledPolygon f�ggv�ny az + im k�pre egy kit�lt�tt soksz�get rajzol. + A points egy PHP t�mb, amely a soksz�g + cs�cspontjait tartalmazza. P�ld�ul: + points[0] = x0, points[1] = y0, points[2] = x1, points[3] = y1, stb. + Num_points a soksz�g cs�csainak sz�ma. + + + + + + + ImageFilledRectangle + Kit�lt�tt t�glalapot rajzol + + + Le�r�s + + + int imagefilledrectangle + int im + int x1 + int y1 + int x2 + int y2 + int col + + + + Az ImageFilledRectangle f�ggv�ny egy + col sz�n� kit�lt�tt t�glalapot rajzol az + im k�pre. A t�glalap bal fels� koordin�t�ja + x1, y1, jobb als� + koordin�t�ja pedig x2, y2. + (A k�p bal fels� sarka a 0, 0 koordin�t�j� pont.) + + + + Ha nem bal fels� �s jobb als� koordin�t�kat adsz meg, akkor lehal a + program, �s a k�pb�l semmit sem fogsz l�tni!!![angol doksiba!] + + + + + + + + ImageFillToBorder + Kit�lt�s adott hat�rol� sz�nig + + + Le�r�s + + + int imagefilltoborder + int im + int x + int y + int border + int col + + + + Az ImageFillToBorder f�ggv�ny a + border sz�n el�r�s�ig kit�lt egy ter�letet. + A kit�lt�st az x, y + koordin�t�ban kezdi, a kit�lt�s sz�ne col lesz. + (A k�p bal fels� sarka a 0, 0 koordin�t�j� pont.) + + + + + + + ImageFontHeight + Adott bet�t�pus magass�ga + + + Le�r�s + + + int imagefontheight + int font + + + + A f�ggv�ny a megadott bet�k�szlet egy karakter�nek magass�g�t adja vissza + pixelben. + + + L�sd m�g a ImageFontWidth �s a + ImageLoadFont f�ggv�nyeket! + + + + + + + ImageFontWidth + Adott bet�t�pus sz�less�ge + + + Le�r�s + + + int imagefontwidth + int font + + + + A f�ggv�ny a megadott bet�k�szlet egy karakter�nek sz�less�g�t adja vissza + pixelben. + + + L�sd m�g a ImageFontHeight �s a + ImageLoadFont f�ggv�nyeket. + + + + + + + ImageGIF + Kirajzol egy k�pet, vagy f�jlba menti + + + Le�r�s + + + int imagegif + int im + string + filename + + + + + Az ImageGIF f�ggv�ny egy filename nev� + GIF f�jlt hoz l�tre az im + k�pb�l. Az im param�ter az + imagecreate f�ggv�ny �ltal visszaadott azonos�t�. + + + A k�p form�tuma GIF87a lesz, ha a k�p nem tartalmaz + ImageColorTransparent f�ggv�nnyel l�trehozott + �tl�tsz� sz�nt �s GIF89a form�tum�, ha tartalmaz + �tl�tsz� sz�nt. + + + A filename param�ter opcion�lis, ha nem adod meg, akkor a k�p k�zvetlen�l + a kimenetre ker�l. Ha a lap tartalm�t a header + f�ggv�nnyel image/gif-re �ll�tod, akkor a PHP lap k�zvetlen�l egy + GIF t�pus� k�pet jelen�t meg. + + + Mivel minden GIF t�mogat�st a + GD k�nyvt�r 1.6-os verzi�j�b�l elt�vol�tottak, �gy + ez a f�ggv�ny nem el�rhet�, ha a GD e v�ltozat�t + haszn�lod. + + + + + + + + + ImagePng + + Kirajzol PNG egy k�pet, vagy f�jlba menti + + + + Le�r�s + + + int + imagepng + + int im + string filename + + + + Az ImagePng f�ggv�ny az im + k�pet �rja ki a szabv�nyos kimenetre (a b�ng�sz�be), vagy, ha + filename param�tert is megadt�l, akkor a k�p + tartalma abba a f�jlba ker�l. + + +$im = ImageCreateFromPng("test.png"); +ImagePng($im); + + + + + + + + + ImageJPEG + Kirajzol egy k�pet, vagy f�jlba menti + + + Le�r�s + + + int imagejpeg + int im + string + filename + + int + quality + + + + + Az ImageJPEG f�ggv�ny egy + JPEG f�jlt hoz l�tre az im + k�pb�l. Az im param�ter a + ImageCreate f�ggv�ny �ltal visszaadott azonos�t�. + + + Ha a filename param�ter elmarad, akkor a k�p a szabv�nyos kimenetre + ker�l. Ha szeretn�d megadni a k�p min�s�g�t akkor, amikor a k�pet a + kimenetre szeretn�d k�ldeni, akkor a k�p nev�nek �res karakterl�ncot ('') + adj meg! Ha egy image/jpg �rt�k� content-type fejl�cet �rsz ki a + header f�ggv�nnyel, akkor a JPEG + t�pus� k�p k�zvetlen�l a kimenetre k�ldhet�. + + + A JPEG t�mogat�s csak akkor el�rhet�, ha a PHP-t GD-1.8 (vagy k�s�bbi) + v�ltozat�val ford�tod. + + + + + + + + + ImageInterlace + Enable or disable interlace + + + Le�r�s + + + int imageinterlace + int im + int + interlace + + + + + ImageInterlace turns a interlace bit on or off. + If interlace is 1 a im image will be interlaced, and if interlace + is 0 a interlace bit is turned off. + + + This functions returns whether a interlace bit is set for a + image. + + + + + + + ImageLine + Vonalat rajzol + + + Le�r�s + + + int imageline + int im + int x1 + int y1 + int x2 + int y2 + int col + + + + Az ImageLine f�ggv�ny vonalat rajzol az + x1, y1 pontb�l az + x2, y2 pontba + col sz�nnel. + (A k�p bal fels� sarka a 0, 0 koordin�t�j� pont.) + + + L�sd m�g az ImageCreate �s a + ImageColorAllocate f�ggv�nyeket! + + + + + + + ImageLoadFont + Bet�lt egy bet�k�szletet + + + Le�r�s + + + int imageloadfont + string file + + + + Az ImageLoadFont f�ggv�ny egy felhaszn�l�i + pixelgrafikus bet�k�szletet t�lt be �s a bet�lt�tt bet�t�pus azonos�t�j�t + adja vissza. (Ez mindig nagyobb, mint 5, hogy a be�p�tett + bet�k�szletekkel ne �tk�zz�n.) + + + A font file form�tuma jelenleg bin�ris �s g�pf�gg�. Ez azt jelenti, hogy + a bet�k�szletet azon a g�pen kell l�trehozni, mint amilyen t�pus� CPU-n + fog futni a PHP, ami a bet�k�szletet haszn�lja. + + +

+ Bet�k�szletek form�tuma + + + + byte poz�ci� + C adatt�pus + le�r�s + + + + + byte 0-3 + int + a bet�t�pusban lev� karakterek sz�ma + + + byte 4-7 + int + + az els� karakter k�dja (gyakran 32, ez a sz�k�z k�dja) + + + + byte 8-11 + int + egy karakter sz�less�ge + + + byte 12-15 + int + egy karakter magass�ga + + + byte 16- + char + + t�mb, amely az egyes karakterek adatait tartalmazza. Minden karakter + egy pontot reprezent�l, �gy az eg�sz t�mb hossza + (nchars*width*height) byte hossz�. + + + + +

+ + + L�sd m�g az ImageFontWidth �s a + ImageFontHeight f�ggv�nyeket! + + + + + + + ImagePolygon + Soksz�get rajzol + + + Le�r�s + + + int imagepolygon + int im + array points + int num_points + int col + + + + Az ImagePolygon f�ggv�ny az id azonos�t�j� k�pre egy + soksz�get rajzol. + A Points t�mb tartalmazza a soksz�g cs�csait a + k�vetkez�k�pp: points[0] = x0, points[1] = y0, points[2] + = x1, points[3] = y1, stb. A Num_points adja meg + a cs�cspontok sz�m�t. + + + L�sd m�g az imagecreate f�ggv�nyt! + + + + + + + ImagePSBBox + + Sz�veg k�r� rajzolt legkisebb t�glalap m�reteit adja PostScript Type1 + bet�k�szletet haszn�lva + + + + Le�r�s + + + array imagepsbbox + string text + int font + int size + int space + int tightness + float angle + + + + A Size pixelben �rtend�. + + + A Space param�ter seg�ts�g�vel megv�ltoztathatjuk + a bet�t�pus alap�rtelmezett sz�k�z�t. Ez az �rt�k a norm�l �rt�khez + hozz�ad�dik, �gy van �rtelme negat�v �rt�ket is megadni. + + + A Tightness param�terrel pedig a bet�k k�z�tti + t�vols�got v�ltoztathatjuk. A param�ter �rt�ke a karakter m�ret�hez + hozz�ad�dik, �gy lehet negat�v is. + + + Az Angle param�tert fokban kell megadni. + + + A space �s a + tightness param�terek m�rt�kegys�ge egy ezred em. + (ennek az em-nek az m bet� magass�g�hoz van k�ze) + + + A space, tightness �s a + angle param�terek elhagyhat�k. + + + A hat�rol� doboz m�reteit a f�ggv�ny a fontb�l sz�m�tja, �s sajnos n�ha + el�gg� k�l�nb�zik ez az �rt�k a t�nylegesen megrajzolt sz�veg m�ret�t�l. + Ha a megadott sz�g 0 fok, akkor el�fordulhat, hogy a sz�veg a val�s�gban + 1 pixelllel nagyobb lesz mindk�t ir�nyban. + + + A f�ggv�ny egy t�mb�t ad vissza, melynek elemei: + + + + + 0 + bal als� x-koordin�ta + + + 1 + bal als� y-koordin�ta + + + 2 + jobb fels� x-koordin�ta + + + 3 + jobb fels� y-koordin�ta + + + + + + + L�sd m�g az imagepstext f�ggv�nyt! + + + + + + + + + ImagePSEncodeFont + + Megv�ltoztatja a bet�k�szlet egy karakterk�dol�si vektor�t + + + + Le�r�s + + + int imagepsencodefont + string encodingfile + + + + F�jlb�l bet�lt egy karakter-k�dol�si vektort �s a font k�dol�si-vektor�t + erre v�ltoztatja. Mivel a PostScript bet�k�szletek alap�rtelmezett + vektor�ban a legt�bb 127 feletti karakter m�shol van, mint szeretn�d, �gy + musz�j lesz megv�ltoztatnod, hacsak nem az angol nyelvet haszn�lod [nem + azt haszn�lod, mert ezt a magyar le�r�st haszn�lod]. Ennek a bet�ltend� + f�jlnak a pontos form�tuma megtal�lhat� a T1libs dokument�ci�j�ban. [Aki + nem hiszi, annak ut�naj�runk :)] A T1lib k�t haszn�lhat� f�jllal rukkolt + ki: az IsoLatin1.enc �s az IsoLatin2.enc nev�ekkel. [�kes anyanyelv�nk + lelkes h�veinek az ut�bbit aj�nlom!] + + + Ha azon kapod magad, hogy folyton ezt a f�ggv�nyt haszn�lod, akkor jobban + j�rsz, ha a k�dol�st a ps.default_encoding-ot a + konfigur�ci�s f�jlban a + megfelel� k�dol�si f�jlra �ll�tod, �gy bet�k�szleteid automatikusan j� + k�dol�s�ak lesznek. + + + + + + + ImagePSFreeFont + Egy PostScript Type 1 bet�t�pus �ltal haszn�lt mem�ri�t + szabad�t fel + + + Le�r�s + + + void imagepsfreefont + int fontindex + + + + L�sd m�g a ImagePSLoadFont f�ggv�nyt! + + + + + + + ImagePSLoadFont + F�jlb�l bet�lt egy PostScript Type 1 bet�t�pust + + + Le�r�s + + + int imagepsloadfont + string filename + + + + Ha minden j�l megy, akkor egy �rv�nyes bet�t�pus-azonos�t�t kapsz vissza. + Ha nincs szerencs�d, a f�ggv�ny hamissal t�r vissza, �s ki�rja, hogy mi a + baj. [ennek nem sok haszn�t veszed, hiszen a kimenet t�pusa k�p...] + + + L�sd m�g a ImagePSFreeFont f�ggv�nyt! + + + + + + + ImagePsExtendFont + + Extend or condense a font + + + + Le�r�s + + + bool + imagepsextendfont + + int + font_index + + double + extend + + + + + Extend or condense a font (font_index), if a + value of a extend parameter is less than one + you will be condensing a font. + + + + + + + ImagePsSlantFont + + Slant a font + + + + Le�r�s + + + bool + imagepsslantfont + + int + font_index + + double + slant + + + + + Slant a font given by a font_index parameter with a slant of + a value of a slant parameter. + + + + + + + ImagePSText + + Egy k�pbe PostScript Type1 t�pus� sz�veget �r + + + + Le�r�s + + + array imagepstext + int image + string text + int font + int size + int foreground + int background + int x + int y + int + + space + + + int + + tightness + + + float + + angle + + + int + + antialias_steps + + + + + + Size pixelben. + + + A foreground az a sz�n, amivel a sz�veg ki�r�dik. + A background az a sz�n, amelyet h�tt�rsz�nnek + felt�telez a rajzol�algoritmus (antialiasing miatt kell). A f�ggv�ny + egyetlen background sz�n� pontot sem fog rajzolni, + �gy a h�tt�rnek nem kell egysz�n�nek lennie. + + + Az + x, y �ltal adott + param�terek fogj�k a sz�veg kezdet�t meghat�rozni (durv�n az els� + karakter bal als� sark�t). Ez egy k�l�nbs�g a + ImageString, f�ggv�nyt�l, ahol az + x, y param�terek az els� + karakter jobb fels� [tal�n bal fels�] sark�t hat�rozz�k meg. Ha nem + �rted, hogy mi�rt �gy rajzol a f�ggv�ny, olvasd a PostScript + dokument�ci�j�t a bet�k�szletekkel meg a koordin�tarendszerekkel + kapcsolatban! + + + A space param�ter seg�ts�g�vel a bet�k�szlet + alap�rtelmezett t�rk�z�nek m�ret�t tudod szab�lyozni. A megadott + mennyis�g a norm�l t�rk�zh�z hozz�ad�dik, �gy van �rtelme negat�v t�rk�zt + is megadni. + + + A tightness param�ter seg�ts�g�vel a bet�k k�z�tti + t�rk�z nagys�g�n tudsz v�ltoztatni. A megadott mennyis�g a norm�l + t�rk�zh�z hozz�ad�dik, �gy negat�v is lehet. + + + A angle param�ter fokban �rtend�. + + + Az antialias_steps param�ter seg�ts�g�vel az + antialiasing-hoz haszn�lt sz�nek sz�m�t tudod szab�lyozni. A megengedett + �rt�kek: 4 �s 16. 20-n�l kisebb bet�m�ret eset�n a nagyobb �rt�ket + c�lszer� haszn�lni. Nagyobb bet�kre haszn�lj 4-et, mert �gy gyorsabb a + bet�k rajzol�sa! + + + A space �s a + tightness param�terek egys�ge a "karakter t�vols�g + egys�g", ami ezrede az em-nek [0.001em, j�l mondom?]. + + + A space, + tightness, angle + �s a antialias param�terek elhagyhat�k. + + + A f�ggv�ny egy t�mbbel t�r vissza, melynek az al�bbi elemei vannak: + + + + + 0 + bal als� x-koordin�ta + + + 1 + bal als� y-koordin�ta + + + 2 + jobb fels� x-koordin�ta + + + 3 + jobb fels� y-koordin�ta + + + + + + L�sd m�g az imagepsbbox f�ggv�nyt! + + + + + + + ImageRectangle + T�glalapot rajzol + + + Le�r�s + + + int imagerectangle + int im + int x1 + int y1 + int x2 + int y2 + int col + + + + A ImageRectangle f�ggv�ny egy col sz�n� t�glalapot + rajzol az im k�pre. A t�glalap bal fels� koordin�t�i x1, y1, a jobb als� + koordin�t�k pedig x2, y2. A k�p bal fels� sarka a 0,0 koordin�ta. + + + + + + + ImageSetPixel + Egy pont sz�n�t megv�ltoztatja + + + Le�r�s + + + int imagesetpixel + int im + int x + int y + int col + + + + A ImageSetPixel f�ggv�ny az + im k�pben + x, y pont + (A k�p bal fels� sarka a 0,0 pont) sz�n�t a + col sz�n�re v�ltoztatja. + + + L�sd m�g a ImageCreate �s a + ImageColorAllocate f�ggv�nyeket. + + + + + + + ImageString + Karakterl�ncot �r ki (v�zszintesen) + + + Le�r�s + + + int imagestring + int im + int font + int x + int y + string s + int col + + + + Az ImageString f�ggv�ny ki�rja az + s karakterl�ncot az + im k�pen az + x, y (a bal fels� sarok a + 0, 0 pont) pontt�l col sz�nnel. Ha a + font �rt�ke 1, 2, 3, + 4 vagy 5, egy be�p�tett bet�k�szlet ker�l felhaszn�l�sra. + + + L�sd m�g az ImageLoadFont f�ggv�nyt! + + + + + + + ImageStringUp + Ki�r egy karakterl�ncot lentr�l fel [mint ahogy a :-)-t kell + n�zni] + + + Le�r�s + + + int imagestringup + int im + int font + int x + int y + string s + int col + + + + Az ImageStringUp f�ggv�ny ki�rja az + s karakterl�ncot f�gg�legesen az + im k�pen az + x, y (a bal fels� sarok a + 0, 0 pont) pontt�l col sz�nnel. Ha a + font �rt�ke 1, 2, 3, + 4 vagy 5, egy be�p�tett bet�k�szlet ker�l felhaszn�l�sra. + + + L�sd m�g az ImageLoadFont f�ggv�nyt! + + + + + + + ImageSX + K�p sz�less�ge + + + Le�r�s + + + int imagesx + int im + + + + Az ImageSX f�ggv�ny az + im �lala azonos�tott k�p sz�less�g�t adja vissza. + + + L�sd m�g a ImageCreate �s a + ImageSY f�ggv�nyeket! + + + + + + + ImageSY + K�p magass�ga + + + Le�r�s + + + int imagesy + int im + + + + Az ImageSY f�ggv�ny az + im �lala azonos�tott k�p magass�g�t adja vissza. + + + L�sd m�g a ImageCreate �s a + ImageSX f�ggv�nyeket! + + + + + + + ImageTTFBBox + + TruType bet�t�pus� sz�veg befoglal� t�glalapj�t adja vissza. + + + + Le�r�s + + + array imagettfbbox + int size + int angle + string fontfile + string text + + + + A f�ggv�ny kisz�m�tja �s visszaadja a TrueType sz�veg befoglal� + t�glalap m�ret�t (k�ppontban). + + + + text + + + a megm�rend� sz�veg + + + + + size + + + a bet�k nagys�ga + + + + + fontfile + + + + A TrueType bet�t�pus f�jl neve. (Lehet URL is) + + + + + + angle + + + + Angle in degrees in which text will be + measured. [???] + + + + + Az ImageTTFBBox f�ggv�ny egy 8-elem� t�mbbel t�r + vissza, amely a befoglal� n�gy pont koordin�t�it tartalmazza: + + + + + 0 + bal als� sarok, X koordin�ta + + + 1 + bal als� sarok, Y koordin�ta + + + 2 + jobb als� sarok, X koordin�ta + + + 3 + jobb als� sarok, Y koordin�ta + + + 4 + jobb fels� sarok, X koordin�ta + + + 5 + jobb fels� sarok, Y koordin�ta + + + 6 + bal fels� sarok, X koordin�ta + + + 7 + bal fels� sarok, Y koordin�ta + + + + + A pontok a sz�veghez k�pest �rtend�k, teh�t a "bal + fels�" azt jelenti, hogy a sz�veget norm�lisan n�zve bal fels�. + + + E f�ggv�ny haszn�lat�hoz a GD �s a FreeType k�nyvt�rak is kellenek. + + + L�sd m�g az ImageTTFText f�ggv�nyt! + + + + + + + ImageTTFText + + TrueType t�pus� sz�veget �r ki egy k�pre + + + + Le�r�s + + + array imagettftext + int im + int size + int angle + int x + int y + int col + string fontfile + string text + + + + A ImageTTFText f�ggv�ny az + im k�pre �rja ki a + text sz�veget az + x, y koordin�t�kra + angle sz�ggel elforgatva + col sz�nnel a + fontfile bet�t�pust felhaszn�lva. + + + Az + x, y �ltal adott + param�terek fogj�k a sz�veg kezdet�t meghat�rozni (durv�n az els� + karakter bal als� sark�t). Ez egy k�l�nbs�g a + ImageString, f�ggv�nyt�l, ahol az + x, y param�terek az els� + karakter jobb fels� [tal�n bal fels�] sark�t hat�rozz�k meg. + + + Az angle param�ter �rt�ke fokban �rtend�. Ha + �rt�ke 0, a sz�veg "norm�lis" balr�l-jobbra olvashat� sz�veg. Pozit�v + �rt�kek a sz�veget pozit�v (�ramutat� j�r�s�val ellent�tes) ir�nyba + forgatja. (Pl.: 90-es elforgat�sn�l a sz�veget lentr�l felfel� kell + olvasni) + + + A fontfile param�ter egy TrueType bet�t�pus teljes + el�r�si �tvonala. + + + A text param�ter a sz�veg, mely tartalmazhat UTF-8 + karaktersorozatokat ({ form�ban) a 255 feletti k�d� karakterek + el�r�s�hez. + + + A col param�ter egy sz�n-index. Ha �rt�ke negat�v, + az kikapcsolja az antialiasing-ot. + + + Az ImageTTFText f�ggv�ny egy 8-elem� t�mb�t ad + vissza, mely a sz�veget befoglal� 4 pont koordin�t�it tartalmazza. A + pontok sorrendje: bal fels�, jobb fels�, jobb als�, bal als�. A pontok a + sz�veghez k�pest relat�vok, vagyis a sz�veget olvasva �rtend�k. + + + Az al�bbi p�ldaprogram egy fekete 400x30-as GIF k�pet eredm�nyez egy + feh�r Arial t�pus� "Pr�ba" kezdet� sz�veggel. [Felt�ve, ha nem t�l �j a + GD-d mert a gif t�mogat�st kiszedt�k :(] + + ImageTTFText + +<?php +Header ("Content-type: image/gif"); +$im = imagecreate (400, 30); +$black = ImageColorAllocate ($im, 0, 0, 0); +$white = ImageColorAllocate ($im, 255, 255, 255); +ImageTTFText ($im, 20, 0, 10, 20, $white, "/path/arial.ttf", + "Pr�ba Omega: Ω"); +ImageGif ($im); +ImageDestroy ($im); +?> + + + + + A f�ggv�ny haszn�lat�hoz a GD k�nyvt�ron k�v�l a FreeType k�nyvt�r is sz�ks�ges. + + + L�sd m�g a ImageTTFBBox f�ggv�nyt! + + + + + + +