(PECL ps >= 1.1.0)
ps_show_boxed — Imprimir texto en una caja
$psdoc
, string $text
, float $left
, float $bottom
, float $width
, float $height
, string $hmode
[, string $feature
] )
Imprime un texto en la caja dada. La esquina inferior izquierda de la caja está en
(left, bottom). Los saltos de línea
se insertarán según sean necesarios. Los espacios múltiples se tratan como uno sólo.
Las tabulaciones son tratadas como espacios.
El texto será particionado silábicamente si el parámetro
hyphenation es establecido a TRUE
y el parámetro hyphendict contiene un nombre de fichero
válido para un fichero de patrones de partición silábica.
La interlínea se toma del valor leading.
Los párrafos pueden ser
separados por una línea vacía como en TeX. Si el valor
parindent es
establecido a un valor > 0.0, las primeras n líneas serán sangradas. El número
de líneas n se establece mediante el parámetro numindentlines.
Para prevenir
el sangrado de los primeros m párrafos se ha de establecer el valor
parindentskip a un
número positivo.
psdocEl identificador de recursos del fichero postscript, como el devuelto por la función ps_new().
textEl texto a imprimir en la caja dada.
leftLa coordenada x de la esquina inferior izquierda de la caja.
bottomLa coordenada y de la esquina inferior izquierda de la caja.
widthEl ancho de la caja.
heightEl alto de la caja.
hmode
El parámetro hmode puede ser "justify" (justificado),
"fulljustify" (justificado completamete), "right" (a la derecha), "left" (a la izquierda), o "center" (centrado).
La diferencia entre "justify" y "fulljustify" afecta a la última línea de la caja. En el
modo "fulljustify" la última línea será justificada a izquierda y derecha a menos que
sea también la última línea del párrafo. En el modo "justify" siempre será
justificada a la izquierda.
feature
La salida de la función ps_show_boxed() se puede configurar con varios parámetros y valores que deben ser establecidos con las funciones ps_set_parameter() o ps_set_value(). Junto a los parámetros y valores que afectan a la impresión del texto, son evaluados los siguientes parámetros y valores:
La distancia entre la línea base de dos líneas consecutivas.
Establecer a "true" si se necesita un retorno de carro al inicio de una nueva línea en lugar de tratarlo como un espacio. Por defecto es "false".
Establecer a "true" si se necesita un retorno de carro en una sola línea para iniciar un nuevo párrafo en lugar de tratarlo como un espacio. Por defecto es "true".
Establecer a "true" para activar la partición silábica. Se requiere establecer un diccionario con el parámetro "hyphendict". Por defecto es "false".
El nombre de fichero del diccionario usado para los patrones de partición silábica (véase más abajo).
El número de caracteres que debe haber al menos antes o después del guión. Esto implica que sólo las palabras de al menos dos veces este valor serán particionadas silábicamente. El valor predeterminado es tres. Establecer un valor de cero resultará en el valor predeterminado.
Establece la cantidad de espacio en píxeles para la sangría de las m primeras líneas de un párrafo. m puede establecerse con el valor "numindentlines".
Establece el valor de espacio extra entre párrafos. Por defecto es 0, lo que resultará en una distancia de líneas normal.
El número de líneas desde el inicio del párrafo que serán sangradas. Por defecto es 1.
El número de párrafos de la caja cuyas primeras líneas no serán sangradas. Por defecto es 0. Esto es útil para párrafos situados justo antes de una sección de cabecera o para texto continuado en una segunda caja. En ambdos casos se debería establecer a 1.
Establece la manera en que las líneas son numeradas. Los posibles valores son "box" para la numeración de líneas en la caja completa o "paragraph" para la numeración de líneas dentro de cada párrafo.
El espacio para la columna a la izquierda de la línea numerada que contiene el número de línea. El número de línea será justificado a la derecha dentro de esta columna. Por defecto es 20.
El espacio entre la columna con los números de línea y la línea misma. Por defecto es 5.
El texto se particiona silábicamente si el parámetro hyphenation es "true" y está establecido un diccionario de partición silábica válido. pslib no trae su propio diccionario de partición silábica, pero utiliza uno de openoffice, scribus o koffice. Se pueden encontrar estos diccionarios para diferentes lenguajes en uno de los siguientes directios si el software está instalado:
El número de caracteres que no podrán ser escritos.