<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/ref.ps.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'es',
  ),
  'this' => 
  array (
    0 => 'function.ps-findfont.php',
    1 => 'ps_findfont',
    2 => 'Carga una fuente',
  ),
  'up' => 
  array (
    0 => 'ref.ps.php',
    1 => 'Funciones de PS',
  ),
  'prev' => 
  array (
    0 => 'function.ps-fill-stroke.php',
    1 => 'ps_fill_stroke',
  ),
  'next' => 
  array (
    0 => 'function.ps-get-buffer.php',
    1 => 'ps_get_buffer',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'es',
    'path' => 'reference/ps/functions/ps-findfont.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="function.ps-findfont" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">ps_findfont</h1>
  <p class="verinfo">(PECL ps &gt;= 1.1.0)</p><p class="refpurpose"><span class="refname">ps_findfont</span> &mdash; <span class="dc-title">Carga una fuente</span></p>

 </div>

 <div class="refsect1 description" id="refsect1-function.ps-findfont-description">
  <h3 class="title">Descripción</h3>
  <div class="methodsynopsis dc-description">
   <span class="methodname"><strong>ps_findfont</strong></span>(<br>&nbsp;&nbsp;&nbsp;&nbsp;<span class="methodparam"><span class="type"><a href="language.types.resource.php" class="type resource">resource</a></span> <code class="parameter">$psdoc</code></span>,<br>&nbsp;&nbsp;&nbsp;&nbsp;<span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$fontname</code></span>,<br>&nbsp;&nbsp;&nbsp;&nbsp;<span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$encoding</code></span>,<br>&nbsp;&nbsp;&nbsp;&nbsp;<span class="methodparam"><span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span> <code class="parameter">$embed</code><span class="initializer"> = <strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong></span></span><br>): <span class="type"><a href="language.types.integer.php" class="type int">int</a></span></div>

  <p class="para rdfs-comment">
   <span class="function"><strong>ps_findfont()</strong></span> carga una fuente para su uso posterior.
   Antes de que el texto sea escrito con la fuente cargada, debe ser fijada con
   <span class="function"><a href="function.ps-setfont.php" class="function">ps_setfont()</a></span>. Esta función debe tener el archivo de
   métricas de la fuente &quot;adobe&quot; para calcular el espacio utilizado por los
   caracteres. Una fuente que se carga en una página solo estará disponible en
   esa página. Las fuentes que se utilizarán en todo el documento deben ser
   cargadas antes de la primera llamada a
   <span class="function"><a href="function.ps-begin-page.php" class="function">ps_begin_page()</a></span>. La llamada a
   <span class="function"><strong>ps_findfont()</strong></span> entre páginas hará que esta fuente esté
   disponible para todas las páginas siguientes.
  </p>
  <p class="para">
   El nombre del archivo afm debe ser
   <code class="parameter">fontname</code><code class="literal">.afm</code>. Si la fuente debe
   ser incorporada, el archivo
   <code class="parameter">fontname</code><code class="literal">.pfb</code> que contiene el dibujo
   de la fuente también debe estar presente.
  </p>
  <p class="para">
   La llamada a <span class="function"><strong>ps_findfont()</strong></span> antes de la primera página
   requiere mostrar el encabezado del postscript que incluye el BoundingBox para
   el documento completo. Normalmente, el BoundingBox se fija con la primera
   llamada a <span class="function"><a href="function.ps-begin-page.php" class="function">ps_begin_page()</a></span> que ahora viene después de
   <span class="function"><strong>ps_findfont()</strong></span>. En consecuencia, el BoundingBox no ha sido
   fijado y se lanzará un error cuando
   <span class="function"><strong>ps_findfont()</strong></span> sea llamada. Para prever esta situación,
   debe llamarse a la función
   <span class="function"><a href="function.ps-set-parameter.php" class="function">ps_set_parameter()</a></span> para fijar el BoundingBox antes de que
   <span class="function"><strong>ps_findfont()</strong></span> sea llamada.
  </p>
 </div>


 <div class="refsect1 parameters" id="refsect1-function.ps-findfont-parameters">
  <h3 class="title">Parámetros</h3>
  <p class="para">
   <dl>
    
     <dt><code class="parameter">psdoc</code></dt>
     <dd>
      <p class="para">
       Identificador de un archivo postscript devuelto por
       <span class="function"><a href="function.ps-new.php" class="function">ps_new()</a></span>.
      </p>
     </dd>
    
    
     <dt><code class="parameter">fontname</code></dt>
     <dd>
      <p class="para">
       El nombre de la fuente.
      </p>
     </dd>
    
    
     <dt><code class="parameter">encoding</code></dt>
     <dd>
      <p class="para">
       <span class="function"><strong>ps_findfont()</strong></span> intentará cargar el archivo pasado
       en el argumento <code class="parameter">encoding</code>. Los archivos de
       codificación tienen la misma sintaxis que los utilizados por
       <strong class="command">dvips(1)</strong>. Contienen un vector de codificación de
       fuente (que actualmente no se utiliza, pero que debe estar presente) y
       una lista de ligaduras adicionales para extender la lista de ligaduras
       derivadas del archivo AFM.
      </p>
      <p class="para">
       <code class="parameter">encoding</code> puede ser <strong><code><a href="reserved.constants.php#constant.null">null</a></code></strong> o una <span class="type"><a href="language.types.string.php" class="type string">string</a></span> vacía
       si se desea utilizar la codificación por omisión (TeXBase1).
      </p>
      <p class="para">
       Si la codificación se establece en <code class="literal">builtin</code> entonces
       no habrá codificación adicional y se utilizará la codificación
       específica de la fuente. Esto es muy útil para fuentes con símbolos.
      </p>
     </dd>
    
    
     <dt><code class="parameter">embed</code></dt>
     <dd>
      <p class="para">
       Si se establece en un valor &gt;0, la fuente será incorporada en el
       documento. Esto requiere la presencia del archivo de dibujo (.pfb).
      </p>
     </dd>
    
   </dl>
  </p>
 </div>


 <div class="refsect1 returnvalues" id="refsect1-function.ps-findfont-returnvalues">
  <h3 class="title">Valores devueltos</h3>
  <p class="para">
   Devuelve un identificador de la fuente o cero en caso de error. El
   identificador es un número positivo.
  </p>
 </div>


 <div class="refsect1 seealso" id="refsect1-function.ps-findfont-seealso">
  <h3 class="title">Ver también</h3>
  <p class="para">
   <ul class="simplelist">
    <li><span class="function"><a href="function.ps-begin-page.php" class="function" rel="rdfs-seeAlso">ps_begin_page()</a> - Empezar una nueva p&aacute;gina</span></li>
    <li><span class="function"><a href="function.ps-setfont.php" class="function" rel="rdfs-seeAlso">ps_setfont()</a> - Establecer la fuente a usar para la siguiente impresi&oacute;n</span></li>
   </ul>
  </p>
 </div>

</div><?php manual_footer($setup); ?>