ps_show_boxed
(PECL ps >= 1.1.0)
ps_show_boxed — Écriture de texte dans une boîte
Description
$psdoc
, string $text
, float $left
, float $bottom
, float $width
, float $height
, string $hmode
[, string $feature
] )
ps_show_boxed() écrit du texte dans une boîte donnée.
Le coin inférieur gauche de la boîte est à (left
,
bottom
). Les coupures de ligne sera insérées où
nécessaires. Des espaces multiples sont traités comme une seule. Les
tabulations sont traitées comme des espaces.
Le texte sera relié si le paramètre hyphenation
est
fixé à TRUE
et le paramètre hyphendict
contient
un fichier valide pour un fichier de liaison. L'espace des lignes est pris
à partir de la valeur leading
. Les paragraphes
peuvent être séparés par une ligne vide comme dans TeX. Si la valeur
parindent
est fixée à une valeur > 0.0, alors
les premières n lignes seront indentées. Le nombre n de lignes est fixé
par le paramètre numindentlines
. Afin de prévenir
l'indentation des premiers m paragraphes, fixés la valeur
parindentskip
à un nombre positif.
Liste de paramètres
-
psdoc
-
Identifiant d'un fichier PostScript retourné par ps_new().
-
text
-
Le texte à être affiché dans la boîte donnée.
-
left
-
La position x du coin inférieur gauche de la boîte.
-
bottom
-
La position y du coin inférieur gauche de la boîte.
-
width
-
Largeur de la boîte.
-
height
-
Hauteur de la boîte.
-
hmode
-
Le paramètre
hmode
peut être "justify", "fulljustify", "right", "left" ou "center". La différence entre "justify" et "fulljustify" affecte simplement la dernière ligne de la boîte. Dans le mode "fulljustify", la dernière ligne sera justifiée de gauche à droite à moins que cela est aussi la dernière ligne du paragraphe. Dans le mode "justify", le texte sera toujours justifié à gauche. -
feature
-
Paramètres utilisés
L'écriture de ps_show_boxed() peut être configuré avec plusieurs paramètres et valeurs qui peuvent être fixés par soit ps_set_parameter() ou ps_set_value(). Près des paramètres et des valeurs qui affectent l'écriture du texte, les paramètres et les valeurs suivantes sont évalués.
- leading (valeur)
-
Distance entre les lignes de bases de deux lignes consécutives.
- linebreak (paramètre)
-
Fixé à
TRUE
si vous voulez un retour au chariot pour démarrer une nouvelle ligne plutôt que de traiter cela comme un espace. Par défaut, ce paramètre vautFALSE
. - parbreak (paramètre)
-
Fixé à
TRUE
si vous voulez un retour au chariot d'une seule ligne pour débuter un nouveau paragraphe plutôt que de traiter cela comme un espace. Par défaut, ce paramètre vautTRUE
. - hyphenation (paramètre)
-
Fixé à
TRUE
afin d'activer les liaisons. Cela requiert un dictionnaire fixé par le paramètrehyphendict
. Par défaut, ce paramètre vautFALSE
. - hyphendict (paramètre)
-
Fichier du dictionnaire utilisé pour un motif de liaison (voir plus bas).
- hyphenminchar (valeur)
-
Le nombre de caractères qui doit au moins être à gauche avant ou après le tiret. Cela implique que seuls les mots d'au moins deux fois cette valeur peuvent être liés. La valeur par défaut est trois. Fixer une valeur de zéro résultera de la valeur par défaut.
- parindent (valeur)
-
Fixe le nombre d'espace en pixel pour l'indentation les premières m lignes d'un paragraphe. m peut être configuré avec la valeur "numindentlines".
- parskip (valeur)
-
Fixe le nombre d'espace en extra en pixel entre les paragraphes. Par défaut, en mettant 0, le résultat sera d'une distance normale entre les lignes.
- numindentlines (valeur)
-
Nombre de lignes à partir du début du paragraphe qui sera indentée. Par défaut, cette valeur vaut 1.
- parindentskip (valeur)
-
Nombre de paragraphes dans la boîte à qui les premières lignes ne seront pas indentées. Par défaut, cette valeur vaut 0. Cela est utile pour les paragraphes immédiatement après une section d'en-tête ou de texte qui commence dans une seconde boîte. Dans les deux cas, un devrait être fixé à 1.
- linenumbermode (paramètre)
-
Fixe comment les lignes sont numérotées. Les valeurs possibles sont "box" pour numéroter les lignes dans la boîte au complet ou "paragraph" pour numéroter les lignes dans chaque paragraphe.
- linenumberspace (valeur)
-
L'espace pour la colonne laissé des lignes numérotées contenant le numéro de ligne. Le numéro des lignes sera justifié à droite dans cette colonne. Par défaut, cette valeur vaut 20.
- linenumbersep (valeur)
-
L'espace entre la colonne avec le nombre de lignes et la ligne elle-même. Par défaut, cette valeur vaut 5.
Liaison
Le texte est lié si le paramètre hyphenation est fixé à
TRUE
et un dictionnaire valide de liaison est fixé. pslib ne fournit pas
son propre dictionnaire de liaison, mais utilise un de openoffice, scribus
ou koffice. Vous pouvez trouver ces dictionnaires pour différents langages
dans un des dossiers suivants si le programme est installé :
- /usr/share/apps/koffice/hyphdicts/
- /usr/lib/scribus/dicts/
- /usr/lib/openoffice/share/dict/ooo/
Document créé le 30/01/2003, dernière modification le 26/10/2018
Source du document imprimé : https://www.gaudry.be/php-rf-function.ps-show-boxed.html
L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.
Références
Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.