cvs: phpdoc /hu/functions image.xml

From:	Kontra Gergely	Date:	Thu, 30 Aug 2001 18:39:14 +0000
Subject:	cvs: phpdoc /hu/functions image.xml
Groups:	php.doc
Request:	Send a blank email to phpdoc+get-969337347@lists.php.net to get a copy of this message

kgergely Thu Aug 30 14:39:14 2001 EDT Modified files: /phpdoc/hu/functions image.xml Log: Adding new hungarian image.xml (Goba shows me how to upload. thx)

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 @@ + <?xml encoding="iso-8859-2"?> +  + + <reference id="ref.image"> + <title>Image functions</title> + <titleabbrev>Graphics</titleabbrev> + + <partintro> + <simpara> + A PHP képmanipuláló függvényeit használhatod + <acronym>JPEG</acronym>, <acronym>GIF</acronym>, + <acronym>PNG</acronym> és <acronym>SWF</acronym> képek méreteinek + lekérdezésére, és ha van <acronym>GD</acronym> könyvtárad, mely + a <ulink url="&url.gd;">&url.gd;</ulink> címen érhetõ el, + tudsz vele képeket készíteni és manipulálni. + </simpara> + </partintro> + + <refentry id="function.getimagesize"> + <refnamediv> + <refname>GetImageSize</refname> + <refpurpose>Egy GIF, JPEG, PNG vagy SWF kép méretét adja vissza</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>array <function>getimagesize</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + <paramdef>array + <parameter><optional>imageinfo</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + A <function>GetImageSize</function> függvény megállapítja a + méretét bármely + <acronym>GIF</acronym>, <acronym>JPG</acronym>, + <acronym>PNG</acronym> vagy <acronym>SWF</acronym> 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 <acronym>HTML</acronym> + <sgmltag>IMG</sgmltag> tag. + </para> + <para> + 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. + <example> + <title>GetImageSize</title> + <programlisting role="php"> +<?php $size = GetImageSize ("img/flag.jpg"); ?> +<IMG SRC="img/flag.jpg" <?php echo $size[3]; ?> + </programlisting> + </example> + </para> + <para> + Az opcionális <parameter>imageinfo</parameter> paraméter lehetõvé + teszi néhány plusz információ kinyerését a fileból ['''''''] + Jelenleg ez a különbözõ + <acronym>JPG</acronym> 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 <acronym>IPTC</acronym> + <ulink url="&url.iptc;">&url.iptc;</ulink> információ belarakása + az APP13 jelzésbe. Az <function>iptcparse</function> funkciót + használhatod arra, hogy a bináris APP13 jelzést valami olvashatóvá + alakítsd. + <example> + <title>IPTC információ kinyerése a GetImageSize segítségével</title> + <programlisting> +<?php + $size = GetImageSize ("testimg.jpg",&$info); + if (isset ($info["APP13"])) { + $iptc = iptcparse ($info["APP13"]); + var_dump ($iptc); + } +?> + </programlisting> + </example> + <note> + <simpara> + Ehhez a függvényhez nem kell a GD könyvtár. + </simpara> + </note> + </para> + </refsect1> + </refentry> + + <refentry id="function.imagearc"> + <refnamediv> + <refname>ImageArc</refname> + <refpurpose>Egy ellipszisdarabot rajzol</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>imagearc</function></funcdef> + <paramdef>int <parameter>im</parameter></paramdef> + <paramdef>int <parameter>cx</parameter></paramdef> + <paramdef>int <parameter>cy</parameter></paramdef> + <paramdef>int <parameter>w</parameter></paramdef> + <paramdef>int <parameter>h</parameter></paramdef> + <paramdef>int <parameter>s</parameter></paramdef> + <paramdef>int <parameter>e</parameter></paramdef> + <paramdef>int <parameter>col</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + Az <function>ImageArc</function> függvény egy ellipszisdarabot + rajzol az im-mel azonosított képre <parameter>cx</parameter>, + <parameter>cy</parameter> középponttal (a kép bal felsõ széle a 0, 0). + A <parameter>w [kis w!]</parameter> és a <parameter>h</parameter> + 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 + <parameter>s</parameter> és a <parameter>e</parameter>[nincs pont] + adják meg. + </para> + </refsect1> + </refentry> + + <refentry id="function.imagechar"> + <refnamediv> + <refname>ImageChar</refname> + <refpurpose>Egy karaktert rajzol vízszintesen</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>imagechar</function></funcdef> + <paramdef>int <parameter>im</parameter></paramdef> + <paramdef>int <parameter>font</parameter></paramdef> + <paramdef>int <parameter>x</parameter></paramdef> + <paramdef>int <parameter>y</parameter></paramdef> + <paramdef>string <parameter>c</parameter></paramdef> + <paramdef>int <parameter>col</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + Az <function>ImageChar</function> függvény megrajzolja a + <parameter>c</parameter> string elsõ betûjét <parameter>col</parameter> + színnel az <parameter>id</parameter>-vel azonosított képen a betû bal + felsõ sarkát az <parameter>x</parameter>,<parameter>y</parameter> + koordinátához igazítva (a kép bal felsõ széle a 0, 0 pont). + with a color . Ha <parameter>font</parameter>[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). + </para> + <para> + Lásd még az <function>imageloadfont</function> funkciót. + </para> + </refsect1> + </refentry> + + <refentry id="function.imagecharup"> + <refnamediv> + <refname>ImageCharUp</refname> + <refpurpose>Egy karaktert rajzol függõlegesen</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>imagechar</function></funcdef> + <paramdef>int <parameter>im</parameter></paramdef> + <paramdef>int <parameter>font</parameter></paramdef> + <paramdef>int <parameter>x</parameter></paramdef> + <paramdef>int <parameter>y</parameter></paramdef> + <paramdef>string <parameter>c</parameter></paramdef> + <paramdef>int <parameter>col</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + Az <function>ImageChar</function> függvény megrajzolja a + <parameter>c</parameter> string elsõ betûjét <parameter>col</parameter> + színnel az <parameter>id</parameter>-vel azonosított képen a betû bal + felsõ sarkát az <parameter>x</parameter>,<parameter>y</parameter> + koordinátához igazítva (a kép bal felsõ széle a 0, 0 pont). + with a color . Ha <parameter>font</parameter>[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). + </para> + <para> + Lásd még az <function>imageloadfont</function> funkciót. + </para> + </refsect1> + </refentry> + + <refentry id="function.imagecolorallocate"> + <refnamediv> + <refname>ImageColorAllocate</refname> + <refpurpose>Egy színt foglal le egy képben</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>imagecolorallocate</function></funcdef> + <paramdef>int <parameter>im</parameter></paramdef> + <paramdef>int <parameter>red</parameter></paramdef> + <paramdef>int <parameter>green</parameter></paramdef> + <paramdef>int <parameter>blue</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + Az <function>ImageColorAllocate</function> egy színkóddal tér vissza, + amelyet a függény a megadotott <acronym>RGB</acronym> komponensekbõl + [....] + Az <parameter>im</parameter> paraméter az + <function>imagecreate</function> funkció által visszaadott érték. + [Ez még kéne bele... + A <parameter>red</parameter>, <parameter>green</parameter> és + <parameter>blue</parameter> 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 <function>ImageColorAllocate</function> függvényt meg kell + hívnod az összes olyan színre, amelyet az <parameter>im</parameter>-mel + azonosított képben használni akarsz. + + <informalexample> + <programlisting role="php"> +$feher = ImageColorAllocate ($im, 255, 255, 255); +$fekete = ImageColorAllocate ($im, 0, 0, 0); + </programlisting> + </informalexample> + </para> + </refsect1> + </refentry> + + <refentry id="function.imagecolordeallocate"> + <refnamediv> + <refname>ImageColorDeAllocate</refname> + <refpurpose> + Egy színt szabadít fel egy képbõl + </refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int + <function>imagecolordeallocate</function> + </funcdef> + <paramdef>int + <parameter>im</parameter> + </paramdef> + <paramdef>int + <parameter>index</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + Az <function>ImageColorDeAllocate</function> funkció felszabadít + egy korábban az <function>ImageColorAllocate</function> által + lefoglalt színt. + <informalexample> + <programlisting role="php"> +$feher = ImageColorAllocate($im, 255, 255, 255); +ImageColorDeAllocate($im, $feher); + </programlisting> + </informalexample> + </para> + </refsect1> + </refentry> + + <refentry id="function.imagecolorat"> + <refnamediv> + <refname>ImageColorAt</refname> + <refpurpose>Egy képpont színének indexét adja vissza</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>imagecolorat</function></funcdef> + <paramdef>int <parameter>im</parameter></paramdef> + <paramdef>int <parameter>x</parameter></paramdef> + <paramdef>int <parameter>y</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + A paraméterek által meghatározott képen és helyen lévõ képpont + színének indexével tér vissza. + </para> + <para> + Lásd még a <function>imagecolorset</function> és a + <function>imagecolorsforindex</function> függvényeket. + </para> + </refsect1> + </refentry> + + <refentry id="function.imagecolorclosest"> + <refnamediv> + <refname>ImageColorClosest</refname> + <refpurpose> + Az adott színhez legközelebb álló szín indexét adja vissza + </refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>imagecolorclosest</function></funcdef> + <paramdef>int <parameter>im</parameter></paramdef> + <paramdef>int <parameter>red</parameter></paramdef> + <paramdef>int <parameter>green</parameter></paramdef> + <paramdef>int <parameter>blue</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + A kép palettájának azon indexét adja vissza, amely a paraméterekben + megadott <acronym>RGB</acronym> értékhez a "legközelebb" van. + </para> + <para> + 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 <acronym>RGB</acronym> komponensét + egy háromdimenziós térben ábrázolnánk, s a köztük levõ távolságot + mérnénk. + </para> + <para> + Lásd még a <function>imagecolorexact</function> függvényt. + </para> + </refsect1> + </refentry> + + <refentry id="function.imagecolorexact"> + <refnamediv> + <refname>ImageColorExact</refname> + <refpurpose>A megadott szín palettabeli indexét adja vissza</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>imagecolorexact</function></funcdef> + <paramdef>int <parameter>im</parameter></paramdef> + <paramdef>int <parameter>red</parameter></paramdef> + <paramdef>int <parameter>green</parameter></paramdef> + <paramdef>int <parameter>blue</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + Az adott szín palettablei indexét adja vissza. + image. + </para> + <para> + Ha a szín nem szerepel a kép palettájában, -1-gyel tér vissza. + </para> + <para> + Lásd még a <function>imagecolorclosest</function> függvényt. + </para> + </refsect1> + </refentry> + + <refentry id="function.imagecolorresolve"> + <refnamediv> + <refname>ImageColorResolve</refname> + <refpurpose> + Az adott szín, vagy ahhoz legközelebbi szín + palettaindexét adja vissza. + </refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>imagecolorresolve</function></funcdef> + <paramdef>int <parameter>im</parameter></paramdef> + <paramdef>int <parameter>red</parameter></paramdef> + <paramdef>int <parameter>green</parameter></paramdef> + <paramdef>int <parameter>blue</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + 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. + </para> + <para> + Lásd még a <function>imagecolorclosest</function> függvényt. + </para> + </refsect1> + </refentry> + + <refentry id="function.imagegammacorrect"> + <refnamediv> + <refname>ImageGammaCorrect</refname> + <refpurpose> + A GD képre gamma korrekciót alkalmaz + </refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int + <function>imagegammacorrect</function> + </funcdef> + <paramdef>int + <parameter>im</parameter> + </paramdef> + <paramdef>double + <parameter>inputgamma</parameter> + </paramdef> + <paramdef>double + <parameter>outputgamma</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + A <function>ImageGammaCorrect</function> függvény gamma korrekciót alkalmaz + egy gd képfolyamra (<parameter>im</parameter>). A korrekció mértékét a + bemeneti és a kimeneti gamma értéke határozza meg + (<parameter>inputgamma</parameter> és az <parameter>outputgamma</parameter>). + </para> + </refsect1> + </refentry> + + <refentry id="function.imagecolorset"> + <refnamediv> + <refname>ImageColorSet</refname> + <refpurpose> + Adott indexû palettaszín megváltoztatása + </refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>imagecolorset</function></funcdef> + <paramdef>int <parameter>im</parameter></paramdef> + <paramdef>int <parameter>index</parameter></paramdef> + <paramdef>int <parameter>red</parameter></paramdef> + <paramdef>int <parameter>green</parameter></paramdef> + <paramdef>int <parameter>blue</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + 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. + </para> + <para> + Lásd még a <function>imagecolorat</function> függvényt. + </para> + </refsect1> + </refentry> + + <refentry id="function.imagecolorsforindex"> + <refnamediv> + <refname>ImageColorsForIndex</refname> + <refpurpose>Adott indexû szín RGB komponensei</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>array <function>imagecolorsforindex</function></funcdef> + <paramdef>int <parameter>im</parameter></paramdef> + <paramdef>int <parameter>index</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + Egy asszociatív tömbbel tér vissza, mely az adott indexû paletta + vörös, zöld és kék komponenseit tartalmazza. + </para> + <para> + Lásd még a <function>imagecolorat</function> és + <function>imagecolorexact</function> függvényeket. + </para> + </refsect1> + </refentry> + + <refentry id="function.imagecolorstotal"> + <refnamediv> + <refname>ImageColorsTotal</refname> + <refpurpose> + A kép palettájában levõ színek számát adja + </refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>imagecolorstotal</function></funcdef> + <paramdef>int <parameter>im</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + A megadott kép színeinek számát adja vissza. + </para> + <para> + Lásd még a <function>imagecolorat</function> és a + <function>imagecolorsforindex</function> függvényeket. + </para> + </refsect1> + </refentry> + + <refentry id="function.imagecolortransparent"> + <refnamediv> + <refname>ImageColorTransparent</refname> + <refpurpose>Egy színt átlátszónak definiál</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>imagecolortransparent</function></funcdef> + <paramdef>int <parameter>im</parameter></paramdef> + <paramdef>int + <parameter><optional>col</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + Az <function>ImageColorTransparent</function> az + <parameter>im</parameter> képben az átlátszó színt + <parameter>col</parameter>-ra állítja. + Az <parameter>im</parameter> az + <function>ImageCreate</function> által visszaadott érték és + <parameter>col</parameter> pedig egy + <function>ImageColorAllocate</function> által visszaadott + azonosító. + </para> + <para> + 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. + </para> + </refsect1> + </refentry> + + <refentry id="function.imagecopy"> + <refnamediv> + <refname>ImageCopy</refname> + <refpurpose> + Kép egy részét másolja + </refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int + <function>ImageCopy</function> + </funcdef> + <paramdef>int + <parameter>dst_im</parameter> + </paramdef> + <paramdef>int + <parameter>src_im</parameter> + </paramdef> + <paramdef>int + <parameter>dst_x</parameter> + </paramdef> + <paramdef>int + <parameter>dst_y</parameter> + </paramdef> + <paramdef>int + <parameter>src_x</parameter> + </paramdef> + <paramdef>int + <parameter>src_y</parameter> + </paramdef> + <paramdef>int + <parameter>src_w</parameter> + </paramdef> + <paramdef>int + <parameter>src_h</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + A <parameter>src_im</parameter> kép egy részét <parameter>dst_im</parameter>-be + másolja, a részlet másolását a <parameter>src_x</parameter>, <parameter>src_y</parameter> + koordinátákkal kezdõdik, a képrészlet szélessége + <parameter>src_w</parameter>, magassága + <parameter>src_h</parameter>. + A részlet bal felsõ sarka a <parameter>dst_x</parameter>, + <parameter>dst_y</parameter> koordinátára kerül. + </para> + </refsect1> + </refentry> + + <refentry id="function.imagecopyresized"> + <refnamediv> + <refname>ImageCopyResized</refname> + <refpurpose>Másolja és átméretezni egy kép részletét</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>imagecopyresized</function></funcdef> + <paramdef>int <parameter>dst_im</parameter></paramdef> + <paramdef>int <parameter>src_im</parameter></paramdef> + <paramdef>int <parameter>dstX</parameter></paramdef> + <paramdef>int <parameter>dstY</parameter></paramdef> + <paramdef>int <parameter>srcX</parameter></paramdef> + <paramdef>int <parameter>srcY</parameter></paramdef> + <paramdef>int <parameter>dstW</parameter></paramdef> + <paramdef>int <parameter>dstH</parameter></paramdef> + <paramdef>int <parameter>srcW</parameter></paramdef> + <paramdef>int <parameter>srcH</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + Az <function>ImageCopyResized</function> függvény egy kép téglalap + alakú részét másolja át egy másik képbe. + <parameter>Dst_im</parameter> a tárgykép, + <parameter>src_im</parameter> 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 <parameter>dst_im</parameter> és a <parameter>src_im</parameter> + prarméter azonos), de ha az egyes részletek átfedik egymást, + az eredmény kiszámíthatatlan. + </para> + </refsect1> + </refentry> + + <refentry id="function.imagecreate"> + <refnamediv> + <refname>ImageCreate</refname> + <refpurpose>Egy új képet hoz létre</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>imagecreate</function></funcdef> + <paramdef>int <parameter>x_size</parameter></paramdef> + <paramdef>int <parameter>y_size</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + Az <function>ImageCreate</function> függvény egy képazonosítóval + tér vissza, mely üres, és mérete <parameter>x_size</parameter> * + <parameter>y_size</parameter>. + </para> + </refsect1> + </refentry> + + <refentry id="function.imagecreatefromgif"> + <refnamediv> + <refname>ImageCreateFromGif</refname> + <refpurpose>Fileból vagy URL-bõl új képet hoz létre</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>imagecreatefromgif</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + Az <function>ImageCreateFromGif</function> egy képazonosítóval tér vissza, + mely az adott filenévbõl létrehozott képet tartalmazza. + </para> + <para> + Az <function>ImageCreateFromGif</function> ü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õ. + <example> + <title> + Létrehozás közbeni hiba kezelése (vic@zymsys.com jóvoltából) + </title> + <programlisting role="php"> +function LoadGif ($imgname) { + $im = @imagecreatefromgif ($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; +} + </programlisting> + </example> + <note> + <para> + 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. + </para> + </note> + </para> + </refsect1> + </refentry> + + <refentry id="function.imagecreatefromjpeg"> + <refnamediv> + <refname>ImageCreateFromJpeg</refname> + <refpurpose>Fileból vagy URL-bõl új képet hoz létre</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>imagecreatefromjpeg</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + Az <function>ImageCreateFromJpeg</function> egy képazonosítóval tér vissza, + mely az adott filenévbõl létrehozott képet tartalmazza. + </para> + <para> + Az <function>ImageCreateFromJpeg</function> ü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õ. + <example> + <title> + Létrehozás közbeni hiba kezelése (vic@zymsys.com jóvoltából) + </title> + <programlisting role="php"> +function LoadJpeg ($imgname) { + $im = @imagecreatefromjpeg ($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; +} + </programlisting> + </example> + </para> + </refsect1> + </refentry> + + <refentry id="function.imagecreatefrompng"> + <refnamediv> + <refname>ImageCreateFromPng</refname> + <refpurpose>Fájlból vagy URL-bõl új képet hoz létre</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>imagecreatefrompng</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + Az <function>ImageCreateFromPng</function> egy képazonosítóval tér vissza, + mely az adott filenévbõl létrehozott képet tartalmazza. + </para> + <para> + Az <function>ImageCreateFromPng</function> ü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õ. + <example> + <title> + Létrehozás közbeni hiba kezelése (vic@zymsys.com jóvoltából) + </title> + <programlisting role="php"> +function LoadPNG ($imgname) { + $im = @imagecreatefrompng ($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; +} + </programlisting> + </example> + </para> + </refsect1> + </refentry> + + + <refentry id="function.imagedashedline"> + <refnamediv> + <refname>ImageDashedLine</refname> + <refpurpose>Szaggatott vonalat rajzol</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>imagedashedline</function></funcdef> + <paramdef>int <parameter>im</parameter></paramdef> + <paramdef>int <parameter>x1</parameter></paramdef> + <paramdef>int <parameter>y1</parameter></paramdef> + <paramdef>int <parameter>x2</parameter></paramdef> + <paramdef>int <parameter>y2</parameter></paramdef> + <paramdef>int <parameter>col</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + Az <function>ImageDashedLine</function> függvény szaggatott vonalat + rajzol az <parameter>x1</parameter>, <parameter>y1</parameter> pontból az + <parameter>x2</parameter>, <parameter>y2</parameter> pontba az + <parameter>im</parameter> képen <parameter>col</parameter> színnel. + (A kép bal felsõ sarka a 0, 0 koordinátájú pont.) + </para> + <para> + Lásd még az <function>ImageLine</function> függvényt. + </para> + </refsect1> + </refentry> + + <refentry id="function.imagedestroy"> + <refnamediv> + <refname>ImageDestroy</refname> + <refpurpose>Megsemmisít egy képet</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>imagedestroy</function></funcdef> + <paramdef>int <parameter>im</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + Az <function>ImageDestroy</function> függvény felszabadítja az + <parameter>im</parameter> kép által lefoglalt memóriát. + <parameter>Im</parameter> egy <function>ImageCreate</function> függvény + által visszaadott kép azonosító. + </para> + </refsect1> + </refentry> + + <refentry id="function.imagefill"> + <refnamediv> + <refname>ImageFill</refname> + <refpurpose>Zárt terület kifestése</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>imagefill</function></funcdef> + <paramdef>int <parameter>im</parameter></paramdef> + <paramdef>int <parameter>x</parameter></paramdef> + <paramdef>int <parameter>y</parameter></paramdef> + <paramdef>int <parameter>col</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + Az <function>ImageFill</function> függvény az + <parameter>x</parameter>, <parameter>y</parameter> koordinátától kezdve + átszínez egy zárt területet az <parameter>im</parameter> képen + <parameter>col</parameter> színûvé. + (A kép bal felsõ sarka a 0, 0 koordinátájú pont.) + </para> + </refsect1> + </refentry> + + <refentry id="function.imagefilledpolygon"> + <refnamediv> + <refname>ImageFilledPolygon</refname> + <refpurpose>Kitöltött sokszöget rajzol</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>imagefilledpolygon</function></funcdef> + <paramdef>int <parameter>im</parameter></paramdef> + <paramdef>array <parameter>points</parameter></paramdef> + <paramdef>int <parameter>num_points</parameter></paramdef> + <paramdef>int <parameter>col</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + Az <function>ImageFilledPolygon</function> függvény az + <parameter>im</parameter> képre egy kitöltött sokszöget rajzol. + A <parameter>points</parameter> 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. + <parameter>Num_points</parameter> a sokszög csúcsainak száma. + </para> + </refsect1> + </refentry> + + <refentry id="function.imagefilledrectangle"> + <refnamediv> + <refname>ImageFilledRectangle</refname> + <refpurpose>Kitöltött téglalapot rajzol</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>imagefilledrectangle</function></funcdef> + <paramdef>int <parameter>im</parameter></paramdef> + <paramdef>int <parameter>x1</parameter></paramdef> + <paramdef>int <parameter>y1</parameter></paramdef> + <paramdef>int <parameter>x2</parameter></paramdef> + <paramdef>int <parameter>y2</parameter></paramdef> + <paramdef>int <parameter>col</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + Az <function>ImageFilledRectangle</function> függvény egy + <function>col</function> színû kitöltött téglalapot rajzol az + <parameter>im</parameter> képre. A téglalap bal felsõ koordinátája + <parameter>x1</parameter>, <parameter>y1</parameter>, jobb alsó + koordinátája pedig <parameter>x2</parameter>, <parameter>y2</parameter>. + (A kép bal felsõ sarka a 0, 0 koordinátájú pont.) + </para> + <para> + <note> + 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!] + </note> + </para> + </refsect1> + </refentry> + + <refentry id="function.imagefilltoborder"> + <refnamediv> + <refname>ImageFillToBorder</refname> + <refpurpose>Kitöltés adott határoló színig</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>imagefilltoborder</function></funcdef> + <paramdef>int <parameter>im</parameter></paramdef> + <paramdef>int <parameter>x</parameter></paramdef> + <paramdef>int <parameter>y</parameter></paramdef> + <paramdef>int <parameter>border</parameter></paramdef> + <paramdef>int <parameter>col</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + Az <function>ImageFillToBorder</function> függvény a + <parameter>border</parameter> szín eléréséig kitölt egy területet. + A kitöltést az <parameter>x</parameter>, <parameter>y</parameter> + koordinátában kezdi, a kitöltés színe <parameter>col</parameter> lesz. + (A kép bal felsõ sarka a 0, 0 koordinátájú pont.) + </para> + </refsect1> + </refentry> + + <refentry id="function.imagefontheight"> + <refnamediv> + <refname>ImageFontHeight</refname> + <refpurpose>Adott betûtípus magassága</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>imagefontheight</function></funcdef> + <paramdef>int <parameter>font</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + A függvény a megadott betûkészlet egy karakterének magasságát adja vissza + pixelben. + </para> + <para> + Lásd még a <function>ImageFontWidth</function> és a + <function>ImageLoadFont</function> függvényeket! + </para> + </refsect1> + </refentry> + + <refentry id="function.imagefontwidth"> + <refnamediv> + <refname>ImageFontWidth</refname> + <refpurpose>Adott betûtípus szélessége</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>imagefontwidth</function></funcdef> + <paramdef>int <parameter>font</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + A függvény a megadott betûkészlet egy karakterének szélességét adja vissza + pixelben. + </para> + <para> + Lásd még a <function>ImageFontHeight</function> és a + <function>ImageLoadFont</function> függvényeket. + </para> + </refsect1> + </refentry> + + <refentry id="function.imagegif"> + <refnamediv> + <refname>ImageGIF</refname> + <refpurpose>Kirajzol egy képet, vagy fájlba menti</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>imagegif</function></funcdef> + <paramdef>int <parameter>im</parameter></paramdef> + <paramdef>string + <parameter><optional>filename</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + Az <function>ImageGIF</function> függvény egy filename nevû + <acronym>GIF</acronym> fájlt hoz létre az <parameter>im</parameter> + képbõl. Az <parameter>im</parameter> paraméter az + <function>imagecreate</function> függvény által visszaadott azonosító. + </para> + <para> + A kép formátuma <acronym>GIF87a</acronym> lesz, ha a kép nem tartalmaz + <function>ImageColorTransparent</function> függvénnyel létrehozott + átlátszó színt és <acronym>GIF89a</acronym> formátumú, ha tartalmaz + átlátszó színt. + </para> + <para> + 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 <function>header</function> + függvénnyel image/gif-re állítod, akkor a PHP lap közvetlenül egy + <acronym>GIF</acronym> típusú képet jelenít meg. + <note> + <para> + Mivel minden <acronym>GIF</acronym> támogatást a + <acronym>GD</acronym> könyvtár 1.6-os verziójából eltávolítottak, így + ez a függvény nem elérhetõ, ha a <acronym>GD</acronym> e változatát + használod. + </para> + </note> + </para> + </refsect1> + </refentry> + + <refentry id="function.imagepng"> + <refnamediv> + <refname>ImagePng</refname> + <refpurpose> + Kirajzol <acronym>PNG</acronym> egy képet, vagy fájlba menti + </refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int + <function>imagepng</function> + </funcdef> + <paramdef>int <parameter>im</parameter></paramdef> + <paramdef>string <parameter><optional>filename</optional></parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + Az <function>ImagePng</function> függvény az <parameter>im</parameter> + képet írja ki a szabványos kimenetre (a böngészõbe), vagy, ha + <parameter>filename</parameter> paramétert is megadtál, akkor a kép + tartalma abba a fájlba kerül. + <informalexample> + <programlisting role="php"> +$im = ImageCreateFromPng("test.png"); +ImagePng($im); + </programlisting> + </informalexample> + </para> + </refsect1> + </refentry> + + <refentry id="function.imagejpeg"> + <refnamediv> + <refname>ImageJPEG</refname> + <refpurpose>Kirajzol egy képet, vagy fájlba menti</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>imagejpeg</function></funcdef> + <paramdef>int <parameter>im</parameter></paramdef> + <paramdef>string + <parameter><optional>filename</optional></parameter> + </paramdef> + <paramdef>int + <parameter><optional>quality</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + Az <function>ImageJPEG</function> függvény egy + <acronym>JPEG</acronym> fájlt hoz létre az <parameter>im</parameter> + képbõl. Az <parameter>im</parameter> paraméter a + <function>ImageCreate</function> függvény által visszaadott azonosító. + </para> + <para> + 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 + <function>header</function> függvénnyel, akkor a <acronym>JPEG</acrony> + típusú kép közvetlenül a kimenetre küldhetõ. + <note> + <para> + 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. + </para> + </note> + </para> + </refsect1> + </refentry> + + <refentry id="function.imageinterlace"> + <refnamediv> + <refname>ImageInterlace</refname> + <refpurpose>Enable or disable interlace</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>imageinterlace</function></funcdef> + <paramdef>int <parameter>im</parameter></paramdef> + <paramdef>int + <parameter><optional>interlace</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ImageInterlace</function> 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. + </para> + <para> + This functions returns whether a interlace bit is set for a + image. + </para> + </refsect1> + </refentry> + + <refentry id="function.imageline"> + <refnamediv> + <refname>ImageLine</refname> + <refpurpose>Vonalat rajzol</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>imageline</function></funcdef> + <paramdef>int <parameter>im</parameter></paramdef> + <paramdef>int <parameter>x1</parameter></paramdef> + <paramdef>int <parameter>y1</parameter></paramdef> + <paramdef>int <parameter>x2</parameter></paramdef> + <paramdef>int <parameter>y2</parameter></paramdef> + <paramdef>int <parameter>col</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + Az <function>ImageLine</function> függvény vonalat rajzol az + <parameter>x1</parameter>, <parameter>y1</parameter> pontból az + <parameter>x2</parameter>, <parameter>y2</parameter> pontba + <parameter>col</parameter> színnel. + (A kép bal felsõ sarka a 0, 0 koordinátájú pont.) + </para> + <para> + Lásd még az <function>ImageCreate</function> és a + <function>ImageColorAllocate</function> függvényeket! + </para> + </refsect1> + </refentry> + + <refentry id="function.imageloadfont"> + <refnamediv> + <refname>ImageLoadFont</refname> + <refpurpose>Betölt egy betûkészletet</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>imageloadfont</function></funcdef> + <paramdef>string <parameter>file</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + Az <function>ImageLoadFont</function> 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.) + </para> + <para> + 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. + </para> + <para> + <table> + <title>Betûkészletek formátuma</title> + <tgroup cols="3"> + <thead> + <row> + <entry>byte pozíció</entry> + <entry>C adattípus</entry> + <entry>leírás</entry> + </row> + </thead> + <tbody> + <row> + <entry>byte 0-3</entry> + <entry>int</entry> + <entry>a betûtípusban levõ karakterek száma</entry> + </row> + <row> + <entry>byte 4-7</entry> + <entry>int</entry> + <entry> + az elsõ karakter kódja (gyakran 32, ez a szóköz kódja) + </entry> + </row> + <row> + <entry>byte 8-11</entry> + <entry>int</entry> + <entry>egy karakter szélessége</entry> + </row> + <row> + <entry>byte 12-15</entry> + <entry>int</entry> + <entry>egy karakter magassága</entry> + </row> + <row> + <entry>byte 16-</entry> + <entry>char</entry> + <entry> + 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ú. + </entry> + </row> + </tbody> + </tgroup> + </table> + </para> + <para> + Lásd még az <function>ImageFontWidth</function> és a + <function>ImageFontHeight</function> függvényeket! + </para> + </refsect1> + </refentry> + + <refentry id="function.imagepolygon"> + <refnamediv> + <refname>ImagePolygon</refname> + <refpurpose>Sokszöget rajzol</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>imagepolygon</function></funcdef> + <paramdef>int <parameter>im</parameter></paramdef> + <paramdef>array <parameter>points</parameter></paramdef> + <paramdef>int <parameter>num_points</parameter></paramdef> + <paramdef>int <parameter>col</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + Az <function>ImagePolygon</function> függvény az id azonosítójú képre egy + sokszöget rajzol. + A <parameter>Points</parameter> 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 <parameter>Num_points</parameter> adja meg + a csúcspontok számát. + </para> + <para> + Lásd még az <function>imagecreate</function> függvényt! + </para> + </refsect1> + </refentry> + + <refentry id="function.imagepsbbox"> + <refnamediv> + <refname>ImagePSBBox</refname> + <refpurpose> + Szöveg köré rajzolt legkisebb téglalap méreteit adja PostScript Type1 + betûkészletet használva + </refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>array <function>imagepsbbox</function></funcdef> + <paramdef>string <parameter>text</parameter></paramdef> + <paramdef>int <parameter>font</parameter></paramdef> + <paramdef>int <parameter>size</parameter></paramdef> + <paramdef>int <parameter><optional>space</optional></parameter></paramdef> + <paramdef>int <parameter><optional>tightness</optional></parameter></paramdef> + <paramdef>float <parameter><optional>angle</optional></parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + A <parameter>Size</parameter> pixelben értendõ. + </para> + <para> + A <parameter>Space</parameter> 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. + </para> + <para> + A <parameter>Tightness</parameter> 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. + </para> + <para> + Az <parameter>Angle</parameter> paramétert fokban kell megadni. + </para> + <para> + A <parameter>space</parameter> és a + <parameter>tightness</parameter> paraméterek mértékegysége egy ezred em. + (ennek az em-nek az m betû magasságához van köze) + </para> + <para> + A <parameter>space</parameter>, <parameter>tightness</parameter> és a + <parameter>angle</parameter> paraméterek elhagyhatók. + </para> + <para> + 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. + </para> + <para> + A függvény egy tömböt ad vissza, melynek elemei: + <informaltable> + <tgroup cols="2"> + <tbody> + <row> + <entry>0</entry> + <entry>bal alsó x-koordináta</entry> + </row> + <row> + <entry>1</entry> + <entry>bal alsó y-koordináta</entry> + </row> + <row> + <entry>2</entry> + <entry>jobb felsõ x-koordináta</entry> + </row> + <row> + <entry>3</entry> + <entry>jobb felsõ y-koordináta</entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + <para> + Lásd még az <function>imagepstext</function> függvényt! + </para> + </refsect1> + </refentry> + + + + <refentry id="function.imagepsencodefont"> + <refnamediv> + <refname>ImagePSEncodeFont</refname> + <refpurpose> + Megváltoztatja a betûkészlet egy karakterkódolási vektorát + </refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>imagepsencodefont</function></funcdef> + <paramdef>string <parameter>encodingfile</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + 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!] + </para> + <para> + 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 + <link linkend="configuration.file">konfigurációs fájlban</link> a + megfelelõ kódolási fájlra állítod, így betûkészleteid automatikusan jó + kódolásúak lesznek. + </para> + </refsect1> + </refentry> + + <refentry id="function.imagepsfreefont"> + <refnamediv> + <refname>ImagePSFreeFont</refname> + <refpurpose>Egy PostScript Type 1 betûtípus által használt memóriát + szabadít fel</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>void <function>imagepsfreefont</function></funcdef> + <paramdef>int <parameter>fontindex</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + Lásd még a <function>ImagePSLoadFont</function> függvényt! + </para> + </refsect1> + </refentry> + + <refentry id="function.imagepsloadfont"> + <refnamediv> + <refname>ImagePSLoadFont</refname> + <refpurpose>Fájlból betölt egy PostScript Type 1 betûtípust</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>imagepsloadfont</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + 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...] + </para> + <para> + Lásd még a <function>ImagePSFreeFont</function> függvényt! + </para> + </refsect1> + </refentry> + + <refentry id="function.imagepsextendfont"> + <refnamediv> + <refname>ImagePsExtendFont</refname> + <refpurpose> + Extend or condense a font + </refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool + <function>imagepsextendfont</function> + </funcdef> + <paramdef>int + <parameter>font_index</parameter> + </paramdef> + <paramdef>double + <parameter>extend</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + Extend or condense a font (<parameter>font_index</parameter>), if a + value of a <parameter>extend</parameter> parameter is less than one + you will be condensing a font. + </para> + </refsect1> + </refentry> + + <refentry id="function.imagepsslantfont"> + <refnamediv> + <refname>ImagePsSlantFont</refname> + <refpurpose> + Slant a font + </refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool + <function>imagepsslantfont</function> + </funcdef> + <paramdef>int + <parameter>font_index</parameter> + </paramdef> + <paramdef>double + <parameter>slant</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + Slant a font given by a <parameter>font_index</parameter> parameter with a slant of + a value of a <parameter>slant</parameter> parameter. + </para> + </refsect1> + </refentry> + + <refentry id="function.imagepstext"> + <refnamediv> + <refname>ImagePSText</refname> + <refpurpose> + Egy képbe PostScript Type1 típusú szöveget ír + </refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>array <function>imagepstext</function></funcdef> + <paramdef>int <parameter>image</parameter></paramdef> + <paramdef>string <parameter>text</parameter></paramdef> + <paramdef>int <parameter>font</parameter></paramdef> + <paramdef>int <parameter>size</parameter></paramdef> + <paramdef>int <parameter>foreground</parameter></paramdef> + <paramdef>int <parameter>background</parameter></paramdef> + <paramdef>int <parameter>x</parameter></paramdef> + <paramdef>int <parameter>y</parameter></paramdef> + <paramdef>int + <parameter> + <optional>space</optional> + </parameter> + </paramdef> + <paramdef>int + <parameter> + <optional>tightness</optional> + </parameter> + </paramdef> + <paramdef>float + <parameter> + <optional>angle</optional> + </parameter> + </paramdef> + <paramdef>int + <parameter> + <optional>antialias_steps</optional> + </parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <parameter>Size</parameter> pixelben. + </para> + <para> + A <parameter>foreground</parameter> az a szín, amivel a szöveg kiíródik. + A <parameter>background</parameter> az a szín, amelyet háttérszínnek + feltételez a rajzolóalgoritmus (antialiasing miatt kell). A függvény + egyetlen <parameter>background</parameter> színû pontot sem fog rajzolni, + így a háttérnek nem kell egyszínûnek lennie. + </para> + <para> + Az + <parameter>x</parameter>, <parameter>y</parameter> á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 + <function>ImageString</function>, függvénytõl, ahol az + <parameter>x</parameter>, <parameter>y</parameter> 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! + </para> + <para> + A <parameter>space</parameter> 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. + </para> + <para> + A <parameter>tightness</parameter> 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. + </para> + <para> + A <parameter>angle</parameter> paraméter fokban értendõ. + </para> + <para> + Az <parameter>antialias_steps</parameter> 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! + </para> + <para> + A <parameter>space</parameter> és a + <parameter>tightness</parameter> paraméterek egysége a "karakter távolság + egység", ami ezrede az em-nek [0.001em, jól mondom?]. + </para> + <para> + A <parameter>space</parameter>, + <parameter>tightness</parameter>, <parameter>angle</parameter> + és a <parameter>antialias</parameter> paraméterek elhagyhatók. + </para> + <para> + A függvény egy tömbbel tér vissza, melynek az alábbi elemei vannak: + <informaltable> + <tgroup cols="2"> + <tbody> + <row> + <entry>0</entry> + <entry>bal alsó x-koordináta</entry> + </row> + <row> + <entry>1</entry> + <entry>bal alsó y-koordináta</entry> + </row> + <row> + <entry>2</entry> + <entry>jobb felsõ x-koordináta</entry> + </row> + <row> + <entry>3</entry> + <entry>jobb felsõ y-koordináta</entry> + </row> + </tbody> + </tgroup> + </informaltable></para> + <para> + Lásd még az <function>imagepsbbox</function> függvényt! + </para> + </refsect1> + </refentry> + + <refentry id="function.imagerectangle"> + <refnamediv> + <refname>ImageRectangle</refname> + <refpurpose>Téglalapot rajzol</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>imagerectangle</function></funcdef> + <paramdef>int <parameter>im</parameter></paramdef> + <paramdef>int <parameter>x1</parameter></paramdef> + <paramdef>int <parameter>y1</parameter></paramdef> + <paramdef>int <parameter>x2</parameter></paramdef> + <paramdef>int <parameter>y2</parameter></paramdef> + <paramdef>int <parameter>col</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + A <function>ImageRectangle</function> 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. + </para> + </refsect1> + </refentry> + + <refentry id="function.imagesetpixel"> + <refnamediv> + <refname>ImageSetPixel</refname> + <refpurpose>Egy pont színét megváltoztatja</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>imagesetpixel</function></funcdef> + <paramdef>int <parameter>im</parameter></paramdef> + <paramdef>int <parameter>x</parameter></paramdef> + <paramdef>int <parameter>y</parameter></paramdef> + <paramdef>int <parameter>col</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + A <function>ImageSetPixel</function> függvény az + <parameter>im</parameter> képben + <parameter>x</parameter>, <parameter>y</parameter> pont + (A kép bal felsõ sarka a 0,0 pont) színét a + <parameter>col</parameter> színûre változtatja. + </para> + <para> + Lásd még a <function>ImageCreate</function> és a + <function>ImageColorAllocate</function> függvényeket. + </para> + </refsect1> + </refentry> + + <refentry id="function.imagestring"> + <refnamediv> + <refname>ImageString</refname> + <refpurpose>Karakterláncot ír ki (vízszintesen)</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>imagestring</function></funcdef> + <paramdef>int <parameter>im</parameter></paramdef> + <paramdef>int <parameter>font</parameter></paramdef> + <paramdef>int <parameter>x</parameter></paramdef> + <paramdef>int <parameter>y</parameter></paramdef> + <paramdef>string <parameter>s</parameter></paramdef> + <paramdef>int <parameter>col</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + Az <function>ImageString</function> függvény kiírja az + <parameter>s</parameter> karakterláncot az + <parameter>im</parameter> képen az + <parameter>x</parameter>, <parameter>y</parameter> (a bal felsõ sarok a + 0, 0 pont) ponttól <parameter>col</parameter> színnel. Ha a + <parameter>font</parameter> értéke 1, 2, 3, + 4 vagy 5, egy beépített betûkészlet kerül felhasználásra. + </para> + <para> + Lásd még az <function>ImageLoadFont</function> függvényt! + </para> + </refsect1> + </refentry> + + <refentry id="function.imagestringup"> + <refnamediv> + <refname>ImageStringUp</refname> + <refpurpose>Kiír egy karakterláncot lentrõl fel [mint ahogy a :-)-t kell + nézni]</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>imagestringup</function></funcdef> + <paramdef>int <parameter>im</parameter></paramdef> + <paramdef>int <parameter>font</parameter></paramdef> + <paramdef>int <parameter>x</parameter></paramdef> + <paramdef>int <parameter>y</parameter></paramdef> + <paramdef>string <parameter>s</parameter></paramdef> + <paramdef>int <parameter>col</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + Az <function>ImageStringUp</function> függvény kiírja az + <parameter>s</parameter> karakterláncot függõlegesen az + <parameter>im</parameter> képen az + <parameter>x</parameter>, <parameter>y</parameter> (a bal felsõ sarok a + 0, 0 pont) ponttól <parameter>col</parameter> színnel. Ha a + <parameter>font</parameter> értéke 1, 2, 3, + 4 vagy 5, egy beépített betûkészlet kerül felhasználásra. + </para> + <para> + Lásd még az <function>ImageLoadFont</function> függvényt! + </para> + </refsect1> + </refentry> + + <refentry id="function.imagesx"> + <refnamediv> + <refname>ImageSX</refname> + <refpurpose>Kép szélessége</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>imagesx</function></funcdef> + <paramdef>int <parameter>im</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + Az <function>ImageSX</function> függvény az + <parameter>im</parameter> álala azonosított kép szélességét adja vissza. + </para> + <para> + Lásd még a <function>ImageCreate</function> és a + <function>ImageSY</function> függvényeket! + </para> + </refsect1> + </refentry> + + <refentry id="function.imagesy"> + <refnamediv> + <refname>ImageSY</refname> + <refpurpose>Kép magassága</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>imagesy</function></funcdef> + <paramdef>int <parameter>im</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + Az <function>ImageSY</function> függvény az + <parameter>im</parameter> álala azonosított kép magasságát adja vissza. + </para> + <para> + Lásd még a <function>ImageCreate</function> és a + <function>ImageSX</function> függvényeket! + </para> + </refsect1> + </refentry> + + <refentry id="function.imagettfbbox"> + <refnamediv> + <refname>ImageTTFBBox</refname> + <refpurpose> + TruType betûtípusú szöveg befoglaló téglalapját adja vissza. + </refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>array <function>imagettfbbox</function></funcdef> + <paramdef>int <parameter>size</parameter></paramdef> + <paramdef>int <parameter>angle</parameter></paramdef> + <paramdef>string <parameter>fontfile</parameter></paramdef> + <paramdef>string <parameter>text</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + A függvény kiszámítja és visszaadja a TrueType szöveg befoglaló + téglalap méretét (képpontban). + <variablelist> + <varlistentry> + <term> + <parameter>text</parameter> + </term> + <listitem> + <simpara>a megmérendõ szöveg</simpara> + </listitem> + </varlistentry> + <varlistentry> + <term> + <parameter>size</parameter> + </term> + <listitem> + <simpara>a betûk nagysága</simpara> + </listitem> + </varlistentry> + <varlistentry> + <term> + <parameter>fontfile</parameter> + </term> + <listitem> + <simpara> + A TrueType betûtípus fájl neve. (Lehet URL is) + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term> + <parameter>angle</parameter> + </term> + <listitem> + <simpara> + Angle in degrees in which <parameter>text</parameter> will be + measured. [???] + </simpara> + </listitem> + </varlistentry> + </variablelist> + Az <function>ImageTTFBBox</function> függvény egy 8-elemû tömbbel tér + vissza, amely a befoglaló négy pont koordinátáit tartalmazza: + <informaltable> + <tgroup cols="2"> + <tbody> + <row> + <entry>0</entry> + <entry>bal alsó sarok, X koordináta</entry> + </row> + <row> + <entry>1</entry> + <entry>bal alsó sarok, Y koordináta</entry> + </row> + <row> + <entry>2</entry> + <entry>jobb alsó sarok, X koordináta</entry> + </row> + <row> + <entry>3</entry> + <entry>jobb alsó sarok, Y koordináta</entry> + </row> + <row> + <entry>4</entry> + <entry>jobb felsõ sarok, X koordináta</entry> + </row> + <row> + <entry>5</entry> + <entry>jobb felsõ sarok, Y koordináta</entry> + </row> + <row> + <entry>6</entry> + <entry>bal felsõ sarok, X koordináta</entry> + </row> + <row> + <entry>7</entry> + <entry>bal felsõ sarok, Y koordináta</entry> + </row> + </tbody> + </tgroup> + </informaltable> + A pontok a <emphasis>szöveghez</emphasis> képest értendõk, tehát a "bal + felsõ" azt jelenti, hogy a szöveget normálisan nézve bal felsõ. + </para> + <para> + E függvény használatához a GD és a FreeType könyvtárak is kellenek. + </para> + <para> + Lásd még az <function>ImageTTFText</function> függvényt! + </para> + </refsect1> + </refentry> + + <refentry id="function.imagettftext"> + <refnamediv> + <refname>ImageTTFText</refname> + <refpurpose> + TrueType típusú szöveget ír ki egy képre + </refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>array <function>imagettftext</function></funcdef> + <paramdef>int <parameter>im</parameter></paramdef> + <paramdef>int <parameter>size</parameter></paramdef> + <paramdef>int <parameter>angle</parameter></paramdef> + <paramdef>int <parameter>x</parameter></paramdef> + <paramdef>int <parameter>y</parameter></paramdef> + <paramdef>int <parameter>col</parameter></paramdef> + <paramdef>string <parameter>fontfile</parameter></paramdef> + <paramdef>string <parameter>text</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + A <function>ImageTTFText</function> függvény az + <parameter>im</parameter> képre írja ki a + <parameter>text</parameter> szöveget az + <parameter>x</parameter>, <parameter>y</parameter> koordinátákra + <parameter>angle</parameter> szöggel elforgatva + <parameter>col</parameter> színnel a + <parameter>fontfile</parameter> betûtípust felhasználva. + </para> + <para> + Az + <parameter>x</parameter>, <parameter>y</parameter> á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 + <function>ImageString</function>, függvénytõl, ahol az + <parameter>x</parameter>, <parameter>y</parameter> paraméterek az elsõ + karakter jobb felsõ [talán bal felsõ] sarkát határozzák meg. + </para> + <para> + Az <parameter>angle</parameter> 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) + </para> + <para> + A <parameter>fontfile</parameter> paraméter egy TrueType betûtípus teljes + elérési útvonala. + </para> + <para> + A <parameter>text</parameter> paraméter a szöveg, mely tartalmazhat UTF-8 + karaktersorozatokat (&#123; formában) a 255 feletti kódú karakterek + eléréséhez. + </para> + <para> + A <parameter>col</parameter> paraméter egy szín-index. Ha értéke negatív, + az kikapcsolja az antialiasing-ot. + </para> + <para> + Az <function>ImageTTFText</function> 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. + </para> + <para> + 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 :(] + <example> + <title>ImageTTFText</title> + <programlisting role="php"> +<?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: &#937;"); +ImageGif ($im); +ImageDestroy ($im); +?> + </programlisting> + </example> + </para> + <para> + A függvény használatához a GD könyvtáron kívül a <ulink + url="&url.freetype;">FreeType</ulink> könyvtár is szükséges. + </para> + <para> + Lásd még a <function>ImageTTFBBox</function> függvényt! + </para> + </refsect1> + </refentry> + + </reference> + +