mirror of
https://github.com/php/doc-es.git
synced 2026-04-24 07:38:19 +02:00
Pedro Antonio Gil Rodríguez
0e99da5238
git-svn-id: https://svn.php.net/repository/phpdoc/es/trunk@329608 c90b9560-bf6c-de11-be94-00142212c4b1
270 lines
8.8 KiB
XML
270 lines
8.8 KiB
XML
<?xml version="1.0" encoding="utf-8"?>
|
|
<!-- $Revision$ -->
|
|
<!-- EN-Revision: 7d5306f9c93a6afd1c7686edbfabfa17c1b69004 Maintainer: seros Status: ready -->
|
|
<!-- Reviewed: no -->
|
|
<refentry xml:id="function.imagettftext" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
|
|
<refnamediv>
|
|
<refname>imagettftext</refname>
|
|
<refpurpose>Escribir texto en la imagen usando fuentes TrueType</refpurpose>
|
|
</refnamediv>
|
|
<refsect1 role="description">
|
|
&reftitle.description;
|
|
<methodsynopsis>
|
|
<type>array</type><methodname>imagettftext</methodname>
|
|
<methodparam><type>resource</type><parameter>image</parameter></methodparam>
|
|
<methodparam><type>float</type><parameter>size</parameter></methodparam>
|
|
<methodparam><type>float</type><parameter>angle</parameter></methodparam>
|
|
<methodparam><type>int</type><parameter>x</parameter></methodparam>
|
|
<methodparam><type>int</type><parameter>y</parameter></methodparam>
|
|
<methodparam><type>int</type><parameter>color</parameter></methodparam>
|
|
<methodparam><type>string</type><parameter>fontfile</parameter></methodparam>
|
|
<methodparam><type>string</type><parameter>text</parameter></methodparam>
|
|
</methodsynopsis>
|
|
<para>
|
|
Escribe el texto <parameter>text</parameter> dado en una imagen usando fuentes
|
|
TrueType.
|
|
</para>
|
|
</refsect1>
|
|
<refsect1 role="parameters">
|
|
&reftitle.parameters;
|
|
<para>
|
|
<variablelist>
|
|
&gd.image.description;
|
|
<varlistentry>
|
|
<term><parameter>size</parameter></term>
|
|
<listitem>
|
|
<para>&gd.font.size;</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><parameter>angle</parameter></term>
|
|
<listitem>
|
|
<para>
|
|
El ángulo en grados, siendo 0 grados la lectura del texto de izquierda a derecha.
|
|
Valores mayores representan una rotación en sentido contrario al de las agujas del reloj.
|
|
Por ejemplo, un valor de 90 resultaria en la lectura de texto de abajo a arriba.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><parameter>x</parameter></term>
|
|
<listitem>
|
|
<para>
|
|
Las coordenadas dadas por <parameter>x</parameter> e
|
|
<parameter>y</parameter> definirán el punto de referencia del primer
|
|
carácter (aproximadamente la esquina inferior izquierda del carácter). Esto
|
|
es diferente de <function>imagestring</function>, donde
|
|
<parameter>x</parameter> e <parameter>y</parameter> definen la
|
|
esquina superior izquierda del primer carácter. Por ejemplo, "superior izquierda"
|
|
es 0, 0.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><parameter>y</parameter></term>
|
|
<listitem>
|
|
<para>
|
|
La coordenada y. Esto establece la posición de la línea base de las fuentes, no la del
|
|
pie del carácter.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><parameter>color</parameter></term>
|
|
<listitem>
|
|
<para>
|
|
El índice de color. Usar el negativo de un índice de color tiene el efecto de
|
|
desactivar el antialias. Vése <function>imagecolorallocate</function>.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><parameter>fontfile</parameter></term>
|
|
<listitem>
|
|
<para>
|
|
La ruta de la fuente TrueType que se desea usar.
|
|
</para>
|
|
<para>
|
|
Dependiendo de la versión de GD que esté usando PHP, <emphasis>cuando
|
|
<parameter>fontfile</parameter> no comienza con un
|
|
<literal>/</literal> inicial, <literal>.ttf</literal> será añadido</emphasis>
|
|
al nombre de archivo, y la biblioteca intentará buscar ese
|
|
nombre de archivo en una ruta de biblioteca definida de fuentes.
|
|
</para>
|
|
<para>
|
|
Cuando se usan versiones de la biblioteca GD anteriores a 2.0.18, un carácter
|
|
<literal>espacio</literal>, en vez de un punto y coma, es usado como el 'separador de ruta'
|
|
para diferentes archivos de fuente. El uso involuntario de esta característica resultará en
|
|
en el mensaje de advertencia: <literal>Warning: Could not find/open font</literal>.
|
|
La única solución para estas versiones afectadas es mover la fuente a una ruta que no
|
|
contenga espacios.
|
|
</para>
|
|
<para>
|
|
En muchos casos donde una fuente reside en el mismo derectorio que el script,
|
|
el siguiente truco paliará cualquier problema de inclusión.
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
<?php
|
|
// Establecer la variable de entorno para GD
|
|
putenv('GDFONTPATH=' . realpath('.'));
|
|
|
|
// Nombrar la fuente que va ser usada (observe la ausencia de la extensión .ttf)
|
|
$fuente = 'UnaFuente';
|
|
?>
|
|
]]>
|
|
</programlisting>
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><parameter>text</parameter></term>
|
|
<listitem>
|
|
<para>
|
|
La cadena de texto en codificación UTF-8.
|
|
</para>
|
|
<para>
|
|
Puede incluir referencias a caracteres numéricos decimales (de la forma:
|
|
&#8364;) para acceder a caracteres en la fuente que están más allá de la posición 127.
|
|
El formato hexadecimal (como &#xA9;) está soportado.
|
|
Las cadenas en codificación UTF-8 pueden pasarse directamente.
|
|
</para>
|
|
<para>
|
|
Las entidades con nombre, como &copy;, no están soportadas. Considere usar
|
|
<function>html_entity_decode</function>
|
|
para decodificar estas entidades con nombre a strings UTF-8.
|
|
</para>
|
|
<para>
|
|
Si un carácter se usa en la cadena y no está soportado por la
|
|
fuente, un rectángulo vacío reemplazará al carácter.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</para>
|
|
</refsect1>
|
|
<refsect1 role="returnvalues">
|
|
&reftitle.returnvalues;
|
|
<para>
|
|
Devuelve una matriz con 8 elementos que representan cuatro puntos que hacen la
|
|
caja circundante. El orden de los puntos es inferior izquierdo, inferior
|
|
derecho, superior derecho, superior izquierdo. Los puntos son relativos al texto
|
|
sin importar el ángulo, por lo que "superior izquierdo" significa en la esquina superior
|
|
izquierda cuando se ve el texto horizontalmente.
|
|
Devuelve &false; si se produjo un error.
|
|
</para>
|
|
</refsect1>
|
|
<refsect1 role="changelog">
|
|
&reftitle.changelog;
|
|
<para>
|
|
<informaltable>
|
|
<tgroup cols="2">
|
|
<thead>
|
|
<row>
|
|
<entry>&Version;</entry>
|
|
<entry>&Description;</entry>
|
|
</row>
|
|
</thead>
|
|
<tbody>
|
|
<row>
|
|
<entry>5.2.0</entry>
|
|
<entry>
|
|
Ahora es posible especificar una entidad hexadecimal en
|
|
<parameter>text</parameter>.
|
|
</entry>
|
|
</row>
|
|
</tbody>
|
|
</tgroup>
|
|
</informaltable>
|
|
</para>
|
|
</refsect1>
|
|
<refsect1 role="examples">
|
|
&reftitle.examples;
|
|
<para>
|
|
<example>
|
|
<title>Ejemplo de <function>imagettftext</function></title>
|
|
<para>
|
|
Este script de ejemplo producirá un PNG blanco de 400x30 píxeles, con
|
|
la palabra "Testing..." en negro (con sombra gris), con la fuente Arial.
|
|
</para>
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
<?php
|
|
// Establecer el tipo de contenido
|
|
header('Content-Type: image/png');
|
|
|
|
// Crear la imagen
|
|
$im = imagecreatetruecolor(400, 30);
|
|
|
|
// Crear algunos colores
|
|
$blanco = imagecolorallocate($im, 255, 255, 255);
|
|
$gris = imagecolorallocate($im, 128, 128, 128);
|
|
$negro = imagecolorallocate($im, 0, 0, 0);
|
|
imagefilledrectangle($im, 0, 0, 399, 29, $blanco);
|
|
|
|
// El texto a dibujar
|
|
$texto = 'Testing...';
|
|
// Reemplace la ruta por la de su propia fuente
|
|
$fuente = 'arial.ttf';
|
|
|
|
// Añadir algo de sombra al texto
|
|
imagettftext($im, 20, 0, 11, 21, $gris, $fuente, $texto);
|
|
|
|
// Añadir el texto
|
|
imagettftext($im, 20, 0, 10, 20, $negro, $fuente, $texto);
|
|
|
|
// Usar imagepng() resultará en un texto más claro comparado con imagejpeg()
|
|
imagepng($im);
|
|
imagedestroy($im);
|
|
?>
|
|
]]>
|
|
</programlisting>
|
|
&example.outputs.similar;
|
|
<mediaobject>
|
|
<alt>Salida del ejemplo : imagettftext()</alt>
|
|
<imageobject>
|
|
<imagedata fileref="en/reference/image/figures/imagettftext.png"/>
|
|
</imageobject>
|
|
</mediaobject>
|
|
</example>
|
|
</para>
|
|
</refsect1>
|
|
<refsect1 role="notes">
|
|
&reftitle.notes;
|
|
<note>
|
|
<para>
|
|
Esta función requiere tanto la biblioteca GD como la biblioteca <link
|
|
xlink:href="&url.freetype;">FreeType</link>.
|
|
</para>
|
|
</note>
|
|
</refsect1>
|
|
<refsect1 role="seealso">
|
|
&reftitle.seealso;
|
|
<para>
|
|
<simplelist>
|
|
<member><function>imagettfbbox</function></member>
|
|
</simplelist>
|
|
</para>
|
|
</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
|
|
-->
|