Last updated: Fri, 13 Nov 2009

imagepstext

(PHP 4, PHP 5)

imagepstext — PostScript Type1 フォントを用いて画像の上に文字列を描く

説明

array imagepstext ( resource $image , string $text , resource $font_index , int $size , int $foreground , int $background , int $x , int $y [, int $space = 0 [, int $tightness = 0 [, float $angle = 0.0 [, int $antialias_steps = 4 ]]]] )

PostScript Type1 フォントを使用して、画像の上にテキストを描画します。

動作に関して不明な場合は、フォント及びその測り方に関する PostScipt ドキュメントを参照ください。

パラメータ

image: imagecreatetruecolor() のような画像作成関数が返す画像リソース。
text: 書き出すテキスト。
font_index: imagepsloadfont() が返すフォントリソース。
size: size はピクセルで表します。
foreground: テキストの色。
background: アンチエイリアス時にフェードアウトする色。 background 色のピクセルは描画されないので、背景画像が無地である必要はありません。
x: 最初の文字の左下隅の x 座標。
y: 最初の文字の左下隅の y 座標。
space: フォントが占める空間のデフォルト値を変更することが可能です。この値が元の値に付加されます。また、負の値とすることも可能です。文字間隔の単位で表され、1 単位が文字矩形の 1/1000 となります。
tightness: tightness により文字間の空白の量を制御できます。この量は元の文字幅に追加され、負の値とすることも可能です。文字間隔の単位で表され、1 単位が文字矩形の 1/1000 となります。
angle: angle は、度で表します。
antialias_steps: antialias_steps によりアンチエイリアスを行うテキストの色数を制御することが可能です。指定できるのは 4 および 16 です。 20 より小さな大きさのテキストには、見易くするために大きい方を推奨します。より大きなフォントでは、計算負荷がより少ない 4 を使用してください。

返り値

この関数は、以下の要素からなる配列を返します。

0	左下の x 座標
1	左下の y 座標
2	右上の x 座標
3	右上の y 座標

例

例1 imagepstext() の使用


<?php
// 画像ハンドルを作成します
$im = imagecreatetruecolor(200, 200);

// 色を割り当てます
$black = imagecolorallocate($im, 0, 0, 0);
$white = imagecolorallocate($im, 255, 255, 255);

// PostScript フォントを読み込みます
$font = imagepsloadfont('font.pfm');

// フォントを画像に書き込みます
imagepstext($im, 'Sample text is simple', $font, 12, $black, $white, 50, 50);

// 出力し、メモリを開放します
header('Content-type: image/png');

imagepng($im);
imagedestroy($im);
?>

注意

注意: この関数は、PHP が --with-t1lib を指定してコンパイルされている場合のみ使用可能です。

参考

imagepsbbox() - PostScript Type1 フォントを用いてテキスト矩形のバウンディングボックスを指定する

imagerectangle

imagepsslantfont

Last updated: Fri, 13 Nov 2009

add a note User Contributed Notes
imagepstext

whitemarker dot blogspot dot com
19-Sep-2007 06:28


The documentation above is bad.  It says $font:

"Can be 1, 2, 3, 4, 5 for built-in fonts in latin2 encoding (where higher numbers corresponding to larger fonts) or any of your own font identifiers registered with imageloadfont()."



But it can't.  When I put in 1,2,3,4,5 I get

"Warning: imagepstext() expects parameter 3 to be resource, integer given"



I get the same thing when using imageloadfont() because imageloadfont() also returns an integer.  The documentation should instead say: 

"resource returned from imagepsloadfont()."

chrislewis60 at hotmail dot com
23-Jul-2007 02:45


imagepstext() appears to be quite memory intensive and we had a problem where about 50% of the time the script would error. You need to make sure PHP has enough memory assigned to it - we had to increase PHP's allocation from 8MB to 16MB for a simple "hello world" example to work smoothly. 



If the png header was commented out it would sometimes error with a message like: 



Warning: imagepstext() [function.imagepstext]: T1Lib Error 11 or 14



and if the png header was there it would sometimes say: 



The image [...] cannot be displayed, because it contains errors.

honza dot bartos at gmail dot com
24-Oct-2006 11:38


The coordinates given by x, y represent actually a starting point of the text baseline. They represent the lower left corner of the first character only in case that any part of the character doesn't lie below baseline (it works for "Hello" but for "Howdy" it does not - because of letter y). There may be some small differences according to the font and size chosen.

heckp at uni-trier.de
10-Jul-2003 12:11


It is important so make shure that the "text" really is a string.



imagepstext ($im, $text, $font, $textsize, $black, $white, 10, 10);



won't work if $text is undefined, so PHP will quit with an error.



so always write it like this:



imagepstext ($im, "$text", $font, $textsize, $black, $white, 10, 10);

m.confalonieri(at)mclink.it
04-Jun-2003 01:00


I found a way to let imagepstext understand 32-bit colors (RGBA) by replacing in gd.c:PHP_FUNCTION(imagepstext)



int _fg, _bg, x, y, size, space = 0, aa_steps = 4, width = 0;



with



unsigned int _fg, _bg, x, y, size, space = 0, aa_steps = 4, width = 0;

Jeroen dot Straahof at newego dot nl
07-Feb-2003 02:12


I made a function that makes it easy to align text to the right

of an image. Below you can find the code because for me it

works great. You can also use it to center text as well, if you 

like to have that simply remove the -10 and split the result

of $imgwidth and $texwidth



function AlignRight($string, $font, $imgwidth, $fontsize) {

list($lx,$ly,$rx,$ry) = imagepsbbox($string,$font,$fontsize,0,0,0);

$textwidth = $rx - $lx;

$imw = ($imgwidth-10-$textwidth);

return $imw;

}

johan (at) 1way2print.net
06-Nov-2002 10:17


If you use fonts with special chars, remeber to read in the encoded file *.enc with imagepsencodefont ... etc. for Danish, Swedish, German.....

a at url dot de
18-Feb-2002 02:16


a note on kernnig:

t1lib tries to load a corresponding afm file in the directory of the font file.

it does this by replacing the extension (.PFB .pfb) with ".afm". note that this has to be a lowercase afm! usually windows-ps-fonts have file names in all-uppercase, so try renaming the *.AFM file to *.afm.



i also noticed that sometimes this gives an error -2. it seems like t1lib chokes on windows-linebreaks in the afm file.



try 'recode dos..lat1 fontfile.afm' and check again.



if it all works, combinations like "Ta" or "Te" should show the second letter slightly moved to the capital T (on normal fonts like Times anyway).

npdavis at hotmail dot com
24-May-2001 04:09


If you have a programming error in your code, using ImagePsText, sometimes t1lib crashes with an unrecoverable error. Because of this, httpd needs to be restarted. 





This problem only occurs if there is a programming error, but can drive you crazy when debugging, if you don't know about it. By killing the parent process(httpd) you "reset" t1lib. When debugging, if you get an error then make a code change, restart httpd before testing it again. This will save hours of frustration. Make it a habit to just restart httpd after every error, and you will be much happier.





Also, to see debugging messages, (if you are rendering x's) comment the jpeg header, and the ImageJpeg statement. You will get beautiful error messages. When you get a blank page, your ImagePsText code is working correctly. Uncomment the Header() and ImageJpeg() and see what you have. You might be passing parameters that render a white image with no text, but the code is working!





Numeric t1lib error messages can be decoded using the t1lib_doc.pdf file that comes with t1lib. PHP simply relays these errors from t1lib to the page. Please don't ask the PHP people about these errors... t1lib has beautiful documentation.... use it: )





thx,


Neil

npdavis at hotmail dot com
24-May-2001 03:56


One other thing... variables. It is important to convert variables to the proper type before they hit this function. In this respect, ImageTtfText is easier to work with. IE, if you pass a font size from one page to the next, via GPC, it becomes a string type. Sooo... use IntVal() to convert it to an integer type that ImagePsText can digest. In addition you must convert HTML special characters or use chr() to represent special characters. ImagePsFont will not decode   to represent a space, use Chr(32) or a space:





<?php


$fontsize=IntVal($fontsize);


$font=ImagePsLoadFont("fonts/IntR.pfb");


ImagePsText($im, $textstring, $font, $fontsize, $textcolor, $background, 0, $fontsize,'','','',16); //note antialias is set


ImagePsFreeFont($font);


?>





thx,


Neil

npdavis at hotmail dot com
22-May-2001 12:54


with a font included in t1lib:





<?PHP


Header ("Content-type: image/jpeg");


$im = ImageCreate (350, 45);


$black = ImageColorAllocate ($im, 0, 0, 0);


$white = ImageColorAllocate ($im, 255, 255, 255);


$font=ImagePsLoadFont("bchbi.pfb");


ImagePsText($im, "Testing... It worked!",


$font, 32, $white, $black, 32, 32);


ImagePsFreeFont($font); 


ImageJpeg($im, "", 100);//for best quality... your mileage may vary


ImageDestroy ($im);


?>





Better than using freetype, but with freetype2, the difference is marginal. To flip backround and foreground colors, alternate the order of ImageColorAllocate statements.


 


If you get outlines (the antialiasing produces these) reverse the $black and $white color identifiers in the ImagePsText function.





Happy PostScripting!





thx,


Neil

add a note

imagerectangle

imagepsslantfont

Last updated: Fri, 13 Nov 2009