(PECL ps >= 1.1.0)
ps_show_boxed — Gera texto em uma caixa
$psdoc
,$text
,$left
,$bottom
,$width
,$height
,$hmode
,$feature
= ?
Gera um texto em uma determinada caixa. O canto inferior esquerdo da caixa está em
(left
, bottom
). Quebras de linha
serão inseridas onde necessário. Vários espaços são tratados como um.
Tabulações são tratadas como espaços.
O texto será hifenizado se o parâmetro
hyphenation
estiver definido como true
e o parâmetro hyphendict
contiver um nome de arquivo válido
para um arquivo de hifenização.
O espaçamento entre linhas é obtido do valor leading
.
Os parágrafos podem ser
separados por uma linha vazia, como no TeX. Se o valor
parindent
estiver
definido como > 0.0, as primeiras n linhas serão recuadas. O número n
de linhas é definido pelo parâmetro numindentlines
.
Para evitar
o recuo dos primeiros m parágrafos, defina o valor
parindentskip
como um
número positivo.
psdoc
Identificador de recurso do arquivo postscript conforme retornado por ps_new().
text
O texto a ser exibido na caixa fornecida.
left
Coordenada x do canto inferior esquerdo da caixa.
bottom
Coordenada y do canto inferior esquerdo da caixa.
width
Largura da caixa.
height
Altura da caixa.
hmode
O parâmetro hmode
pode ser justify
,
fulljustify
, right
, left
ou center
.
A diferença entre justify
e fulljustify
afeta apenas a última linha da caixa. No modo
fulljustify
, a última linha será justificada à esquerda e à direita, a menos que
esta também seja a última linha do parágrafo. No modo justify
, ela sempre
será justificada à esquerda.
feature
A saída de ps_show_boxed() pode ser configurada com vários parâmetros e valores que devem ser definidos com ps_set_parameter() ou ps_set_value(). Além dos parâmetros e valores que afetam a saída de texto, os seguintes parâmetros e valores são avaliados.
Distance between baselines of two consecutive lines.
Se definido como true
, um retorno de carro inicia uma nova linha em vez
de ser tratado como um espaço. O padrão é false
.
Se definido como true
, um retorno de carro em uma única linha inicia um
novo parágrafo em vez de ser tratado como um espaço. O padrão é true
.
Se definido como true
, ativa a hifenização. Isso requer que
um dicionário seja definido com o parâmetro hyphendict
. O padrão é
false
.
Nome do arquivo do dicionário usado para o padrão de hifenização (veja abaixo).
O número de caracteres que devem sobrar pelo menos antes ou depois do hífen. Isso implica que apenas palavras com pelo menos o dobro desse valor serão hifenizadas. O valor padrão é três. Definir um valor igual a zero resultará no valor padrão.
Define a quantidade de espaço em pixels para recuar as primeiras m linhas de um
parágrafo. m pode ser definido com o valor numindentlines
.
Define a quantidade de espaço extra em pixels entre parágrafos. O padrão é
0
, o que resultará em uma distância de linha normal.
Número de linhas a partir do início do parágrafo que serão recuadas.
O padrão é 1
.
Número de parágrafos na caixa cujas primeiras linhas não serão recuadas.
O padrão é 0
. Isso é útil para parágrafos logo após um título de seção
ou texto continuado em uma segunda caixa. Em ambos os casos, seria
definido como 1
.
Define como as linhas devem ser numeradas. Os valores possíveis são box
para
numerar linhas em toda a caixa ou paragraph
para numerar linhas dentro
de cada parágrafo.
O espaço para a coluna à esquerda da linha numerada que contém o número da linha.
O número da linha será justificado à direita nesta coluna.
O padrão é 20
.
O espaço entre a coluna com os números das linhas e a própria linha.
O padrão é 5
.
O texto será hifenizado se o parâmetro hyphenation
estiver definido
como verdadeiro e um dicionário de hifenização válido estiver definido. O pslib não fornece seu próprio
dicionário de hifenização, mas utiliza um do OpenOffice, Scribus ou Koffice.
Os dicionários para diferentes idiomas podem ser encontrados em um dos
seguintes diretórios, se o software estiver instalado:
Número de caracteres que não puderam ser escritos.