archived-doc-es/reference/image/functions/imageftbbox.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: e41aab5ecacf449e51179886c17f1d41735b0234 Maintainer: seros Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id='function.imageftbbox' xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>imageftbbox</refname>
  <refpurpose>Devolver la caja circundante de un texto usando fuentes mediante FreeType 2</refpurpose>
 </refnamediv>
 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type>array</type><methodname>imageftbbox</methodname>
   <methodparam><type>float</type><parameter>size</parameter></methodparam>
   <methodparam><type>float</type><parameter>angle</parameter></methodparam>
   <methodparam><type>string</type><parameter>fontfile</parameter></methodparam>
   <methodparam><type>string</type><parameter>text</parameter></methodparam>
   <methodparam choice="opt"><type>array</type><parameter>extrainfo</parameter></methodparam>
  </methodsynopsis>
  <para>
   Esta función calcula y devuelve la caja circundante en píxeles de un
   texto FreeType.
  </para>
 </refsect1>
 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>size</parameter></term>
     <listitem>
      <para>&gd.font.size;</para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>angle</parameter></term>
     <listitem>
      <para>
       Ángulo en grados en el que <parameter>text</parameter> será
       medido.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>fontfile</parameter></term>
     <listitem>
      <para>
       El nombre de un archivo de fuente TrueType (puede ser una URL). Dependiendo de
       la versión de la biblioteca GD que esté usando PHP, se intentará
       buscar archivos que no comiencen con '/' añadiendo
       '.ttf' al nombre de archivo y buscando en una ruta de biblioteca definida de fuentes.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>text</parameter></term>
     <listitem>
      <para>
       La cadena que va a ser medida.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>extrainfo</parameter></term>
     <listitem>
      <para>
       <table>
        <title>Posibles índeces de matriz para <parameter>extrainfo</parameter></title>
        <tgroup cols="2">
         <thead>
          <row>
           <entry>Clave</entry>
           <entry>Tipo</entry>
           <entry>Significado</entry>
          </row>
         </thead>
         <tbody>
          <row>
           <entry><literal>linespacing</literal></entry>
           <entry><type>float</type></entry>
           <entry>Define el espacio entre líneas</entry>
          </row>
         </tbody>
        </tgroup>
       </table>
      </para>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>
 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   <function>imageftbbox</function> devuelve una matriz con 8
   elementos que representan cuatro puntos que hacen la caja circundante del
   texto:
   <informaltable>
    <tgroup cols="2">
     <tbody>
      <row>
       <entry>0</entry>
       <entry>esquina inferior izquierda, posición X</entry>
      </row>
      <row>
       <entry>1</entry>
       <entry>esquina inferior izquierda, posición Y</entry>
      </row>
      <row>
       <entry>2</entry>
       <entry>esquina inferior derecha, posición X</entry>
      </row>
      <row>
       <entry>3</entry>
       <entry>esquina inferior derecha, posición Y</entry>
      </row>
      <row>
       <entry>4</entry>
       <entry>esquina superior derecha, posición X</entry>
      </row>
      <row>
       <entry>5</entry>
       <entry>esquina superior derecha, posición Y</entry>
      </row>
      <row>
       <entry>6</entry>
       <entry>esquina superior izquierda, posición X</entry>
      </row>
      <row>
       <entry>7</entry>
       <entry>esquina superior izquierda posición Y</entry>
      </row>
     </tbody>
    </tgroup>
   </informaltable>
  </para>
  <para>
   Los puntos son relativos a <emphasis>text</emphasis> sin importar el ángulo
   <parameter>angle</parameter>, por lo que "superior izquierda" significa la esquina superior
   izquierda, viendo el texto horizontalmente.
  </para>
 </refsect1>
 <refsect1 role="examples">
  &reftitle.examples;
  <para>
   <example>
    <title>Ejemplo de <function>imageftbbox</function></title>
    <programlisting role="php">
<![CDATA[
<?php
// Crear una imagen de 300x150
$im = imagecreatetruecolor(300, 150);
$negro = imagecolorallocate($im, 0, 0, 0);
$blanco = imagecolorallocate($im, 255, 255, 255);

// Establecer el fondo a blanco
imagefilledrectangle($im, 0, 0, 299, 299, $blanco);

// Ruta de nuestro archivo de fuente
$fuente = './arial.ttf';

// Priemero creamos nuestra caja circundante
$bbox = imageftbbox(10, 0, $fuente, 'The PHP Documentation Group');

// Estas son nuestras coordenadas para X e Y
$x = $bbox[0] + (imagesx($im) / 2) - ($bbox[4] / 2) - 5;
$y = $bbox[1] + (imagesy($im) / 2) - ($bbox[5] / 2) - 5;

imagefttext($im, 10, 0, $x, $y, $negro, $fuente, 'The PHP Documentation Group');

// Imprimir al navegador
header('Content-Type: image/png');

imagepng($im);
imagedestroy($im);
?>
]]>
    </programlisting>
   </example>
  </para>
 </refsect1>
 <refsect1 role="notes">
  &reftitle.notes;
  &note.gd.2;
  &note.freetype;
 </refsect1>
</refentry>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->