与えられたボックスの中にテキストを出力します。ボックスの左下の座標が (left, bottom)となります。 必要に応じて改行が挿入されます。連続する空白文字は、ひとつとして扱われ、 タブ文字は空白文字として扱われます。
パラメータ "hyphenation" が "true" に、またパラメータ "hyphendict" に有効なハイフネーションファイルが設定されている場合、テキストは ハイフネーションされます。行間隔の設定は、値 "leading" により行います。 TeX と同様に、段落と段落の間には空行が挿入されます。 値 "parindent" が 0.0 より大きく設定されている場合、最初の n 行は 字下げされます。n の値はパラメータ "numindentlines" で設定します。 最初の m 段落を字下げしないようにするには、値 "parindentskip" に正の数値を設定します。
ps_show_boxed() の出力は、パラメータや値 (それぞれ ps_set_parameter() や ps_set_value() で設定されたもの)で設定できます。 テキスト出力に影響するパラメータや値のうち、以下のものが評価されます。
連続する 2 つの行の間隔です。
キャリッジリターンを、空白ではなく改行として扱いたい場合は "true" に設定します。デフォルトは "false" です。
単一行のデータ中のキャリッジリターンを、空白ではなく段落区切りとして 扱いたい場合は "true" に設定します。デフォルトは "true" です。
ハイフネーションを有効にする場合は "true" に設定します。 その際、パラメータ "hyphendict" に辞書を設定しておく必要があります。 デフォルトは "false" です。
ハイフネーションパターンの辞書ファイル名です(以下を参照)。
ハイフンの前後に最低限必要な文字数です。つまり、少なくともこの値の 2 倍以上の文字数の単語でないとハイフネーションされないということです。 デフォルトは 3 です。値をゼロに設定すると、デフォルトの値が使われます。
段落の最初の m 行に対する字下げの量をピクセル単位で設定します。 m は、値 "numindentlines" で設定します。
段落間の空白の追加量をピクセル単位で設定します。デフォルトは 0 で、 通常の行間設定をそのまま利用します。
段落の最初の部分で字下げ対象となる行数です。デフォルトは 1 です。
字下げ処理を行わない段落数を設定します。デフォルトは 0 です。 この設定が便利に使えるのは、章の始めの段落・2 つのボックスにまたがる テキストなどです。このような場合には値を 1 に設定します。
行番号のつけ方を設定します。"box" を設定するとボックス全体に 番号をつけ、"paragraph" を設定するとその中の段落単位で番号をつけます。
行番号を表示するための、左側のスペースの幅です。行番号は、 このスペースに右詰めで表示されます。デフォルトは 20 です。
行番号欄と行本文欄の間の空白です。デフォルトは 5 です。
パラメータ hyphenation が true に設定され、かつ 有効なハイフネーション辞書が設定されている場合に、テキストが ハイフネーションされます。pslib は独自のハイフネーション辞書を持っておらず、 openoffice または scribus, koffice の辞書のうちひとつを利用します。 これらのソフトウェアがインストールされている環境では、さまざまな言語の辞書が 以下のディレクトリで見つけられます。
/usr/share/apps/koffice/hyphdicts/ |
/usr/lib/scribus/dicts/ |
/usr/lib/openoffice/share/dict/ooo/ |