(PECL ps >= 1.1.0)
ps_begin_page — Начинает новую страницу
Начинает новую страницу. Хотя параметры width
и height
подразумевают различный размер страницы для каждой страницы,
это невозможно в PostScript. Первый вызов ps_begin_page() устанавливает размер страницы
для всего документа. Последующие вызовы не будут иметь никакого эффекта, кроме создания новой страницы.
Ситуация иная, если вы собираетесь преобразовать документ PostScript в PDF. Функция помещает в документ метки PDF,
которые могут индивидуально устанавливать размер каждой страницы.
Полученный PDF-документ будет иметь разные размеры страниц.
Хотя PostScript не знает разных размеров страниц, pslib помещает в документ ограничительную рамку для каждой страницы. Этот размер оценивается некоторыми программами просмотра PostScript и имеет приоритет над BoundingBox в заголовке документа. Это может привести к неожиданным результатам, если вы установите BoundingBox, нижний левый угол которого не равен (0, 0), потому что у ограничивающей рамки страницы всегда будет нижний левый угол (0, 0) и перезапишет глобальную настройку.
Каждая страница инкапсулируется в режим сохранения/восстановления. Это означает, что большинство настроек, сделанных на одной странице, не будут сохранены на следующей странице.
Если до первого вызова ps_begin_page() не было вызова ps_findfont(),
то будет выведен заголовок документа PostScript, а размер ограничивающей рамки будет установлен на первая страница.
Нижний левый угол ограничивающей рамки установлен в (0, 0).
Если ps_findfont() была вызвана раньше, значит, заголовок уже был выведен
и документ не будет иметь корректной ограничительной рамки.
Чтобы предотвратить это, следует вызвать ps_set_info(), чтобы установить
информационное поле BoundingBox
и, возможно, Orientation
перед любым вызовом ps_findfont() или
ps_begin_page().
Замечание:
До версии 0.2.6 pslib функция всегда будет перезаписывать BoundingBox и Orientation, если они была установлены ранее с помощью ps_set_info() и ps_findfont() ранее не вызывалась.
psdoc
Идентификатор ресурса файла postscript, возвращённый функцией ps_new().
width
Ширина страницы в пикселях, например, 596 для формата А4.
height
Высота страницы в пикселях, например, 842 для формата А4.
Возвращает true
в случае успешного выполнения или false
в случае возникновения ошибки.