array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.ps-begin-page.php', 1 => 'ps_begin_page', ), 'up' => array ( 0 => 'ref.ps.php', 1 => 'Функции PS', ), 'prev' => array ( 0 => 'function.ps-arcn.php', 1 => 'ps_arcn', ), 'next' => array ( 0 => 'function.ps-begin-pattern.php', 1 => 'ps_begin_pattern', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/ps/functions/ps-begin-page.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(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
, если возникла ошибка.