Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

imagefttext(3) [php man page]

IMAGEFTTEXT(3)								 1							    IMAGEFTTEXT(3)

imagefttext - Write text to the image using fonts using FreeType 2

SYNOPSIS
array imagefttext (resource $image, float $size, float $angle, int $x, int $y, int $color, string $fontfile, string $text, [array $extrainfo]) DESCRIPTION
PARAMETERS
o $ image -An image resource, returned by one of the image creation functions, such as imagecreatetruecolor(3). o $size - The font size to use in points. o $angle - The angle in degrees, with 0 degrees being left-to-right reading text. Higher values represent a counter-clockwise rotation. For example, a value of 90 would result in bottom-to-top reading text. o $x - The coordinates given by $x and $y will define the basepoint of the first character (roughly the lower-left corner of the char- acter). This is different from the imagestring(3), where $x and $y define the upper-left corner of the first character. For exam- ple, "top left" is 0, 0. o $y - The y-ordinate. This sets the position of the fonts baseline, not the very bottom of the character. o $color - The index of the desired color for the text, see imagecolorexact(3). o $fontfile - The path to the TrueType font you wish to use. Depending on which version of the GD library PHP is using, when $fontfile does not begin with a leading / then .ttf will be appended to the filename and the library will attempt to search for that filename along a library-defined font path. When using versions of the GD library lower than 2.0.18, a space character, rather than a semicolon, was used as the 'path separator' for different font files. Unintentional use of this feature will result in the warning message: Warning: Could not find/open font. For these affected versions, the only solution is moving the font to a path which does not contain spaces. In many cases where a font resides in the same directory as the script using it the following trick will alleviate any include problems. <?php // Set the enviroment variable for GD putenv('GDFONTPATH=' . realpath('.')); // Name the font to be used (note the lack of the .ttf extension) $font = 'SomeFont'; ?> o $text - Text to be inserted into image. o $extrainfo - Possible array indexes for $extrainfo +------------+-----------------------------+ | Key | | | | | | | Type | | | | | | Meaning | | | | +------------+-----------------------------+ | | | |linespacing | | | | | | | | | | float | | | | | | Defines drawing linespacing | | | | +------------+-----------------------------+ RETURN VALUES
This function returns an array defining the four points of the box, starting in the lower left and moving counter-clockwise: +--+--------------------------+ |0 | | | | | | | lower left x-coordinate | | | | |1 | | | | | | | lower left y-coordinate | | | | |2 | | | | | | | lower right x-coordinate | | | | |3 | | | | | | | lower right y-coordinate | | | | |4 | | | | | | | upper right x-coordinate | | | | |5 | | | | | | | upper right y-coordinate | | | | |6 | | | | | | | upper left x-coordinate | | | | |7 | | | | | | | upper left y-coordinate | | | | +--+--------------------------+ EXAMPLES
Example #1 imagefttext(3) example <?php // Create a 300x100 image $im = imagecreatetruecolor(300, 100); $red = imagecolorallocate($im, 0xFF, 0x00, 0x00); $black = imagecolorallocate($im, 0x00, 0x00, 0x00); // Make the background red imagefilledrectangle($im, 0, 0, 299, 99, $red); // Path to our ttf font file $font_file = './arial.ttf'; // Draw the text 'PHP Manual' using font size 13 imagefttext($im, 13, 0, 105, 55, $black, $font_file, 'PHP Manual'); // Output image to the browser header('Content-Type: image/png'); imagepng($im); imagedestroy($im); ?> NOTES
Note This function requires GD 2.0.1 or later (2.0.28 or later is recommended). Note This function is only available if PHP is compiled with freetype support ( --with-freetype-dir=DIR) PHP Documentation Group IMAGEFTTEXT(3)

Featured Tech Videos