PHPKonf Istanbul PHP Conference 2019 - Call for Papers


(PHP 4, PHP 5)

imagepsbboxDevolver la caja circundante de un rectángulo de texto usando fuentes PostScript Type1


Esta función fue ELILMINADA en PHP 7.0.0.


array imagepsbbox ( string $text , resource $font , int $size )
array imagepsbbox ( string $text , resource $font , int $size , int $space , int $tightness , float $angle )

Devuelve la caja circundante de un rectángulo de texto usando fuentes PostScript Type1

La caja circundante es calculada usando infomación disponible de la métrica del carácter, y desafortunadamente tiende a diferir ligeramente de los resultados conseguidos por la actual rasterización del texto. Si el ángulo es 0 grados, puede suponer que el texto necesita 1 píxel más para cada dirección.



El texto que va a ser escrito.


Un recurso de fuente, devuelto por imagepsloadfont().


size el tamaño, expresado en píxeles.


Permite cambiar el valor predeterminado de un espacio en una fuente. Esta cantidad se añade al valor normal y puede ser negativa también. Expresado en unidades de espacio de carcteres, donde 1 unidad es la 1/1000 parte de una 'M' (em-square).


tightness permite controlar la cantidad de espacio en blanco entre caracteres. Esta cantidad se añade al ancho de un carácter normal y puede ser negativo. Expresado en unidades de espacio de carcteres, donde 1 unidad es la 1/1000th parte de una 'M' (em-square).


angle, ángulo en grados.

Valores devueltos

Devuelve una matriz que contiene los siguientes elementos:

0 Coordenada x izquierda
1 Coordenada y superior
2 Coordenada x deracha
3 Coordenada y inferior


Ejemplo #1 Uso de imagepsbbox()

// Crear un gestor de imagen
$im imagecreatetruecolor(200200);

// Asignar colores
$negro imagecolorallocate($im000);
$blanco imagecolorallocate($im255255255);

// Cargar la fuente PostScript
$fuente imagepsloadfont('font.pfm');

// Hacer una caja circundante para la fuente
$bbox imagepsbbox('El texto de ejemplo es simple'$fuente12);

// Definir nuestras coordenadas X e Y
$x = ($bbox[2] / 2) - 10;
$y = ($bbox[3] / 2) - 10;

// Escribir la fuente en la imagen
imagepstext($im'El texto de ejemplo es simple'$fuente12$negro$blanco$x$y);

// Imprimir y liberar memoria
header('Content-type: image/png');


Historial de cambios

Versión Descripción
7.0.0 Se elimió el soporte para T1Lib de PHP, y así la eliminación de esta función.


Nota: Esta función sólo está disponible si PHP fue compilado usando --with-t1lib[=DIR] .

Ver también

  • imagepstext() - Dibujar un texto sobre una imagen usando fuentes PostScript Type1

add a note add a note

User Contributed Notes 4 notes

10 years ago
I have a given image width and need to render a long string on that image. By using the following function I'm, able to get an array of strings which each will fit into the images width. It might need a lot of CPU time, but it's cool:

// Function to return an Array of Strings
// Arguments: String to be wrapped, maximum width in pixels of each line, font and fontsize
function imgwordwrap($s, $maxWidth, $font, $size) {
  // Make an empty ArrayList
  $a = array();
  $w = 0;    // Accumulate width of chars
  $i = 0;      // Count through chars
  $rememberSpace = 0; // Remember where the last space was
  // As long as we are not at the end of the String
  while ($i < strlen($s)) {
    // Current char
    $c = substr($s, $i, 1);
    $bb = imagepsbbox($c, $font, $size); // calculate width
    $w += abs($bb[3])-abs($bb[1]); // accumulate width
    if ($c == ' ') $rememberSpace = $i; // Are we a blank space?
    if ($w > $maxWidth) {  // Have we reached the end of a line?
      $sub = substr($s,0,$rememberSpace); // Make a substring
            // Chop off space at beginning
            if (substr($sub,0,1)==' ') $sub = substr($sub,1);
      // Add substring to the array
      $a[] = $sub;
      // Reset everything
      $s = substr($s,$rememberSpace);
      $i = 0;
      $w = 0;
    else {
      $i++;  // Keep going!

  // Take care of the last remaining line
  if (substr($s,0,1)==' ') $s = substr($s,1);
  $a[] = $s;

  return $a;
honza dot bartos at gmail dot com
12 years ago
When using imagepsbbox, keep in mind, that meaning of y-coordinates is slightly different here. Y-coordinates returned by this function are related to the baseline of the text starting at point [0,0]. Positive values represent points ABOVE the baseline, negative values represent points BELOW the baseline. That is why the lower left y-coordinate is always smaller here than the upper right y-coordinate (these two coordinates are actualy values of metrics.descent and metrics.ascent - see T1Lib docs).

So when you want to place some text using coordinates of the top left corner (for example [100,100]), use this:


= 100;
$y = 100;
$text = "Dodge this";
$lx,$ly,$rx,$ry) = imagepsbbox($text,$font,$fontsize);
imagepstext ($someimage, $text, $font, $fontsize, $somecolor, $somecolor, $x, $y + $ry);


Hope it helps someone, I got stuck with this for a while.
daniel at dantec dot NO_SPAM dot nl
16 years ago
When using imagepsbbox, you are probably trying to do something like creating a button with text, so that the button is large enough for the text...
Below is a very simple example of making a black button just big enough to display white text on it.


//if text is no variable set sample text
if (!$text)
$text = "This is a sample text";
// set the font size

// load the font to use

//get the left lower corner and the right upper
list($lx,$ly,$rx,$ry) = imagepsbbox($text,$font,$fontsize,0,0,0);

// calculate the size of the text
$textwidth = $rx - $lx;
$textheight = $ry - $ly;

// make an image 40 pixels wider and 20 pixels higher than the text
$imh = $textheight + 20;
$imw = $textwidth + 40;
$im = imageCreate( $imw, $imh );

//define colors, first color is used as background color!
$black  = ImageColorAllocate ($im, 0, 0, 0);
$white = ImageColorAllocate ($im, 255, 255, 255);

//create the text (with the same parameters as imagepsbbox!)
ImagePSText ($im, "$text", $font, $fontsize, $white, $white, 20, 20,'','','',4);

//send the header
header("Content-type: image/jpeg");

// create the image
ImageJPEG ($im,"",100);

//destroy the image & font to free memory
Imagepsfreefont ( $font );
ImageDestroy ( $im );

10 years ago
in my code below, there is an error!

$w += abs($bb[3])-abs($bb[1]); // accumulate width

$w += abs($bb[2])-abs($bb[0]); // accumulate width

also after
$bb = imagepsbbox($c, $font, $size); // calculate width

you can add this line because spaces make odd values...
if ($c == ' ' ) $bb = imagepsbbox('i', $font, $size);
To Top