ps_begin_page
Почист и полокален преглед на PHP референцата, со задржана структура од PHP.net и подобра читливост за примери, секции и белешки.
ps_begin_page
Референца за `function.ps-begin-page.php` со подобрена типографија и навигација.
ps_begin_page
(PECL ps >= 1.1.0)
ps_begin_page — Започни нова страница
= NULL
Започнува нова страница. Иако параметрите width
and height сугерираат различна големина на страницата за секоја страница, ова не е можно во PostScript. Првиот повик на
ps_begin_page() ќе ја постави големината на страницата за целиот документ. Последователните повици нема да имаат ефект, освен создавање нова страница. Ситуацијата е поинаква ако имате намера да го конвертирате PostScript документот во PDF. Оваа функција става pdfmarks во документот што може да ја постави големината за секоја страница поединечно. Резултирачкиот PDF документ ќе има различни големини на страници.
Иако PostScript не познава различни големини на страници, pslib става кутија за граници за секоја страница во документот. Оваа големина се проценува од некои PostScript прегледувачи и ќе има предност пред BoundingBox во Заглавието на документот. Ова може да доведе до неочекувани резултати кога ќе поставите BoundingBox чиј долен лев агол не е (0, 0), бидејќи кутијата за граници на страницата секогаш ќе има долен лев агол (0, 0) и ќе ја пребрише глобалната поставка.
Секоја страница е инкапсулирана во save/restore. Ова значи дека повеќето поставки направени на една страница нема да се задржат на следната страница.
Ако има до првиот повик на ps_begin_page() нема повик на ps_findfont(), тогаш ќе се испише заглавието на PostScript документот и кутијата за граници ќе се постави на големината на првата страница. Долниот лев агол на кутијата за граници е поставен на (0, 0). Ако ps_findfont() е повикан претходно, тогаш заглавието веќе е испишано, а документот нема да има валидна кутија за граници. За да се спречи ова, треба да се повика
ps_set_info() за да се постави полето за информации
BoundingBox и евентуално Orientation
пред било кој ps_findfont() or
ps_begin_page() calls.
Забелешка:
До верзија 0.2.6 на pslib, оваа функција секогаш ќе го пребрише BoundingBox и Orientation, ако претходно е поставено со ps_set_info() and ps_findfont() не е повикан претходно.
Параметри
psdoc-
и користење на шемата како боја за пополнување. ps_new().
width-
Ширината на страницата во пиксели, на пр. 596 за А4 формат.
height-
Висината на страницата во пиксели, на пр. 842 за А4 формат.
Вратени вредности
Патеката до PHP скриптата што треба да се провери. true на успех или false при неуспех.
Види Исто така
- ps_end_page() - Брише сите ресурси на документ PostScript
- ps_findfont() - Пополнува и црта тековна патека
- ps_set_info() - Поставува стил на границата на анотациите