imagepsbbox

(PHP 4, PHP 5)

imagepsbbox — Devolver la caja circundante de un rectángulo de texto usando fuentes PostScript Type1

Descripción

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.

Parámetros

text: El texto que va a ser escrito.
font_index: Un recurso de fuente, devuelto por imagepsloadfont().
size: size el tamaño, expresado en píxeles.
space: 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: 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: 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

Ejemplos

Example #1 Uso de imagepsbbox()


<?php
// Crear un gestor de imagen
$im = imagecreatetruecolor(200, 200);

// Asignar colores
$negro = imagecolorallocate($im, 0, 0, 0);
$blanco = imagecolorallocate($im, 255, 255, 255);

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

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

// 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', $fuente, 12, $negro, $blanco, $x, $y);

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

imagepng($im);
imagedestroy($im);
?>

Notas

Note: 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

imagepsencodefont

imagepolygon

Last updated: Fri, 20 May 2011

add a note User Contributed Notes imagepsbbox

eikie 05-May-2008 04:32


in my code below, there is an error! 



replace

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



with

$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);

eikie 05-May-2008 03:34


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

  trim($s);

  if (substr($s,0,1)==' ') $s = substr($s,1);

  $a[] = $s;

 

  return $a;

}

honza dot bartos at gmail dot com 23-Oct-2006 09:25


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:



<?php 



$x = 100;

$y = 100;

$text = "Dodge this";

$fontsize=18;

$font=imagepsloadfont("somefont.pfb");

list($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 18-Apr-2002 04:23


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.



<?php 



//if text is no variable set sample text

if (!$text)

    $text = "This is a sample text";

    

// set the font size

$fontsize=14;



// load the font to use

$font=ImagePsLoadFont("/fonts/ariam___.pfb");



//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 );



?>

add a note