(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.
psdocIdentificador de recurso do arquivo postscript conforme retornado por ps_new().
textO texto a ser exibido na caixa fornecida.
leftCoordenada x do canto inferior esquerdo da caixa.
bottomCoordenada y do canto inferior esquerdo da caixa.
widthLargura da caixa.
heightAltura 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.
Distância entre linhas de base de duas linhas consecutivas.
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.