PHP 8.1.0 Alpha 1 available for testing

imagecharup

(PHP 4, PHP 5, PHP 7, PHP 8)

imagecharupDraw a character vertically

Description

imagecharup ( GdImage $image , int $font , int $x , int $y , string $char , int $color ) : bool

Draws the character char vertically at the specified coordinate on the given image.

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 any of your own font identifiers registered with 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

Returns true on success or false on failure.

Changelog

Version Description
8.0.0 image expects a GdImage instance now; previously, a resource was expected.

Examples

Example #1 imagecharup() example

<?php

$im 
imagecreate(100100);

$string 'Note that the first letter is a N';

$bg imagecolorallocate($im255255255);
$black imagecolorallocate($im000);

// prints a black "Z" on a white background
imagecharup($im31010$string$black);

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

?>

The above example will output something similar to:

Output of example : imagecharup()

See Also

add a note add a note

User Contributed Notes 1 note

up
-6
php at corzoogle dot com
15 years ago
<?php
// incredibly, no one has added this.
// write a string of text vertically on an image..
// ;o)

$string = '(c) corz.org';
$font_size = 2;
$img = imagecreate(20,90);
$bg = imagecolorallocate($img,225,225,225);
$black = imagecolorallocate($img,0,0,0);

$len = strlen($string);
for (
$i=1; $i<=$len; $i++) {
   
imagecharup($img, $font_size, 5, imagesy($img)-($i*imagefontwidth($font_size)), $string, $black);
   
$string = substr($string,1);
}
header('Content-type: image/png');
imagepng($img);
imagedestroy($img); // dudes! don't forget this!
?>
To Top