(PECL ps >= 1.1.0)
ps_begin_page — 开始新页面
开始一个新页面。虽然参数width
和height
暗示每个页面都有不同的页面大小,但这在 PostScript 中是不可能的。ps_begin_page() 的第一次调用将设置整个文档的页面大小。连续调用不会有任何效果,除了创建新页面。如果您打算将 PostScript 文档转换为 PDF,情况则有所不同。此函数将 pdfmarks 放入文档中,可以分别为每个页面设置大小。生成的 PDF 文档将具有不同的页面大小。
尽管 PostScript 不知道不同的页面大小,但 pslib 会将每个页面的边界框放入文档中。某些 PostScript 查看器会评估此大小,并且优先于文档标题中的 BoundingBox。当您设置左下角不是 (0, 0) 的 BoundingBox 时,这可能会导致意外的结果,因为页面的边界框左下角始终为 (0, 0) 并覆盖全局设置。
每个页面都封装在 save/restore 中。这意味着,在一个页面上进行的大多数设置不会保留在下一页上。
如果在第一次调用 ps_begin_page() 之前没有调用 ps_findfont(),则将输出 PostScript 文档的标题并将边界框设置为第一页的大小。边界框的左下角设置为 (0, 0)。如果在之前调用了 ps_findfont(),则标题已输出,并且文档将没有有效的边界框。为了防止这种情况,应该在任何 ps_findfont() 或 ps_begin_page() 调用之前调用 ps_set_info() 来设置 info 字段 BoundingBox
和可能 的 Orientation
。
注意:
在 pslib 的 0.2.6 版本之前,如果之前已使用 ps_set_info() 设置了 BoundingBox 和 Orientation,并且之前没有调用 ps_findfont(),则此函数将始终覆盖 BoundingBox 和 Orientation。
psdoc
PostScript 文件的资源标识符,由 ps_new() 返回。
width
页面的宽度(像素),例如 A4 格式为 596。
height
页面的高度(像素),例如 A4 格式为 842。