ImageTTFBBox

(PHP 4, PHP 5)

ImageTTFBBox — TruType betűtípusú szöveg befoglaló téglalapját adja vissza.

array imagettfbbox ( float $size , float $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). Függően attól, melyik GD függvényknyvtár változatról van szó, megpróbálhat úgy fájlokat keresni a GD függvénykönyvtár által ismert font könyvtárban, hogy mögéjük illeszti a '.ttf' kiterjesztést, már ha az adott hivatkozás nem /-el kezdődik.
angle: Kiíratási szög fokban, amitől a text paraméterben megadott szöveg kiíratásakori befoglaló négyszög mérete szintén függ.

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!