ps_begin_page

(PECL ps >= 1.1.0)

ps_begin_pageНачинает новую страницу

Описание

ps_begin_page(resource $psdoc, float $width, float $height): bool

Начинает новую страницу. Хотя параметры 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 в случае возникновения ошибки.

Смотрите также

  • ps_end_page() - Завершает страницу
  • ps_findfont() - Загружает шрифт
  • ps_set_info() - Устанавливает информационные поля документа

add a note add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top