PHP 8.4.1 Released!

imagefontheight

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

imagefontheightErmittelt die Höhe einer Schriftart

Beschreibung

imagefontheight(GdFont|int $font): int

Gibt die Höhe eines Zeichens (in Pixel) in der angegebenen Schriftart zurück.

Parameter-Liste

font

Kann bei eingebauten Schriftarten in Latin2-Kodierung 1, 2, 3, 4 oder 5 sein (wobei größere Zahlen größeren Schriftarten entsprechen) oder eine GdFont-Instanz, die von imageloadfont() zurückgegeben wurde.

Rückgabewerte

Gibt die Höhe der Schriftart in Pixel zurück.

Changelog

Version Beschreibung
8.1.0 Der Parameter font akzeptiert jetzt sowohl eine GdFont-Instanz als auch ein Integer; vorher wurde nur Integer akzeptiert.

Beispiele

Beispiel #1 Verwendung von imagefontheight() mit integrierten Schriftarten

<?php
echo 'Höhe der Schriftart: ' . imagefontheight(4);
?>

Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:

Höhe der Schriftart: 16

Beispiel #2 Verwendung von imagefontheight() mit imageloadfont()

<?php
// Lade eine .gdf-Schriftart
$font = imageloadfont('anonymous.gdf');

echo
'Höhe der Schriftart: ' . imagefontheight($font);
?>

Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:

Höhe der Schriftart: 43

Siehe auch

add a note

User Contributed Notes 1 note

up
1
dev at numist dot net
19 years ago
This library function is very useful for variable-sized images that only contain text, like this function that I use to output error messages that accumulate and cause a fatal error in my thumbnailer:

<?php
function errimg($error) {
// $error is an array of error messages, each taking up one line
// initialization
$font_size = 2;
$text_width = imagefontwidth($font_size);
$text_height = imagefontheight($font_size);
$width = 0;
// the height of the image will be the number of items in $error
$height = count($error);

// this gets the length of the longest string, in characters to determine
// the width of the output image
for($x = 0; $x < count($error); $x++) {
if(
strlen($error[$x]) > $width) {
$width = strlen($error[$x]);
}
}

// next we turn the height and width into pixel values
$width = $width * $text_width;
$height = $height * $text_height;

// create image with dimensions to fit text, plus two extra rows and
// two extra columns for border
$im = imagecreatetruecolor($width + ( 2 * $text_width ),
$height + ( 2 * $text_height ) );
if(
$im) {
// image creation success
$text_color = imagecolorallocate($im, 233, 14, 91);
// this loop outputs the error message to the image
for($x = 0; $x < count($error); $x++) {
// imagestring(image, font, x, y, msg, color);
imagestring($im, $font_size, $text_width,
$text_height + $x * $text_height, $error[$x],
$text_color);
}
// now, render your image using your favorite image* function
// (imagejpeg, for instance)
out($im, array(), $error);
} else {
// image creation failed, so just dump the array along with extra error
$error[] = "Is GD Installed?";
die(
var_dump($error));
}
}
?>

The function expects an array of error messages to be passed in, and then outputs an image containing the contents of the array. This is especially useful if your code is contained in an html page that will display rexes if the images do not render correctly.

This function displays the array in image form with index 0 at the top, and the highest index at the bottom.

You have to write out() yourself though, see imagejpeg, imagepng, etc for good ideas on how to write a decent output function.
To Top