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() ранее не вызывалась.