ps_show_boxed — 在框中输出文本
说明
ps_show_boxed(
resource $psdoc,
string $text,
float $left,
float $bottom,
float $width,
float $height,
string $hmode,
string $feature = ?
): int
在给定的框中输出文本。该框的左下角位于(左,底部)。将在需要的地方插入换行符。多个空格被视为一个。制表符被视为空格。
如果参数hyphenation设置为true,并且参数hyphendict包含一个有效的连字符文件文件名,则文本将被连字符连接。行间距取自前导值。段落可以用空行分隔,就像在TeX中一样。如果value parent被设置为value > 0.0,那么前n行将被缩进。行数n由参数numindentlines设置。为了防止前m段缩进,将值parindentskip设置为正数。
参数
psdoc
postscript文件的资源标识符,由ps_new()返回。
文本
要输出到给定框中的文本。
左
方框左下角的x坐标。
底
方框左下角的y坐标。
宽度
盒子的宽度。
高度
盒子的高度。
hmode
参数hmode可以是justify、fulljustify、right、left或center。justify和fulljustify的区别只影响框的最后一行。在完全对齐模式下,最后一行将左对齐和右对齐,除非这也是段落的最后一行。在对齐模式下,它总是左对齐。
使用的参数
ps_show_boxed()的输出可以配置几个参数和值,这些参数和值必须通过ps_set_parameter()或ps_set_value()进行设置。除了影响文本输出的参数和值外,还计算以下参数和值。
领导(值)
两条直线基线之间的距离。
linebreak(参数)
如果您希望回车符开始一个新行,而不是将其作为空格处理,则将其设置为true。默认为false。
parbreak(参数)
如果您希望在单行上使用回车符来开始新段落,而不是将其视为空格,则将其设置为true。默认为true。
断字(参数)
设置为true以打开连字符。这需要使用参数连字符设置字典。默认为false。
hyphendict(参数)
用于连字符模式的字典文件名(见下文)。
hyphenminchar(值)
在连字符之前或之后必须至少保留的字符数。这意味着只有至少两倍于该值的单词才会使用连字符。缺省值是3。将值设置为零将产生默认值。
parindent(值)
设置段落前m行缩进的间距(以像素为单位)。M可以通过numindentlines值设置。
parskip(值)
设置段落之间的额外间距,以像素为单位。默认为0,这将导致法线距离。
numindentlines(值)
从段落开头开始要缩进的行数。默认为1。
parindentskip(值)
方框中第一行不缩进的段落数。默认为0。这对于紧跟在节标题之后的段落或在第二个方框中继续的文本非常有用。在这两种情况下,都会把这个设为1。
linenumbermode(参数)
设置行如何编号。可能的值是box用于对整个框中的行进行编号,或者段落用于对每个段落中的行进行编号。
linenumberspace(值)
包含行号的编号行左边的列的空格。行号将被右对齐到这一列中。默认为20。
linenumbersep(值)
带有行号的列与行本身之间的空格。默认为5。