[函数]ps_set_info()函数—用法及示例

(PECL ps >= 1.1.0)

ps_set_info — 设置文档的信息字段

说明

ps_set_info(resource $p, string $key, string $val): bool

设置文档的某些信息字段。这些字段将作为注释显示在PostScript文件的头文件中。如果文档被转换为pdf，这些字段也将用于文档信息。

BoundingBox通常设置为给定给第一页的值。这仅在ps_findfont()之前未被调用时才有效。在这种情况下，除非使用此函数显式地设置BoundingBox，否则BoundingBox将保持未设置状态。

当postscript文件的头已经被写入时，这个函数将不再起作用。它必须在第一个页面或第一次调用ps_findfont()之前调用。

参数 ¶
psdoc
postscript文件的资源标识符，由ps_new()返回。

key
要设置的信息字段的名称。可设置的值包括keyword、Subject、Title、Creator、Author、BoundingBox和Orientation。请注意，其中一些对PostScript查看器有意义。

value
信息字段的值。字段方向可以设置为纵向或横向。BoundingBox是一个由四个数字组成的字符串。前两个数字是页面左下角的坐标。最后两个数字是右上角的坐标。

注意:

在pslib的0.2.6版本之前，BoundingBox和Orientation将被ps_begin_page()覆盖，除非ps_findfont()之前被调用过。

返回值 ¶
成功时返回 true， 或者在失败时返回 false。