GD and Image Functions
PHP Manual

imagechar

Draw a character horizontally

Description

true imagechar(
    GdImage $image,
    GdFontint $font,
    int $x,
    int $y,
    string $char,
    int $color
)

imagechar draws the first character of char in the image identified by image with its upper-left at x,y (top left is 0, 0) with the color color.

Parameters

image

A GdImage object, returned by one of the image creation functions, such as imagecreatetruecolor.

font

Can be 1, 2, 3, 4, 5 for built-in fonts in latin2 encoding (where higher numbers corresponding to larger fonts) or GdFont instance, returned by imageloadfont.

x

x-coordinate of the start.

y

y-coordinate of the start.

char

The character to draw.

color

A color identifier created with imagecolorallocate.

Return Values

Always returns true.

Changelog

Version Description
8.1.0 The font parameter now accepts both an GdFont instance and an int; previously only int was accepted.
8.0.0 image expects a GdImage instance now; previously, a valid gd resource was expected.

Examples

Example #1 imagechar example

<?php

$im = imagecreate(100, 100);

$string = 'PHP';

$bg = imagecolorallocate($im, 255, 255, 255);
$black = imagecolorallocate($im, 0, 0, 0);

// prints a black "P" in the top left corner
imagechar($im, 1, 0, 0, $string, $black);

header('Content-type: image/png');
imagepng($im);

?>

The above example will output something similar to:

Output of example : imagechar()

See Also

  • imagecharup
  • imageloadfont