(PECL ps >= 1.1.0)
ps_begin_page — Inicia uma nova página
Inicia uma nova página. Embora os parâmetros width
e height impliquem um tamanho de página diferente para cada
página, isso não é possível em PostScript. A primeira chamada de
ps_begin_page() definirá o tamanho da página para todo o
documento. Chamadas consecutivas não terão efeito, exceto para criar uma nova
página. A situação é diferente se você pretende converter o documento PostScript
para PDF. Esta função insere marcas de PDF no documento,
que podem definir o tamanho de cada página individualmente. O documento PDF resultante terá
tamanhos de página diferentes.
Embora o PostScript não reconheça diferentes tamanhos de página, o pslib coloca uma caixa delimitadora para cada página do documento. Este tamanho é avaliado por alguns visualizadores PostScript e terá precedência sobre a BoundingBox no cabeçalho do documento. Isso pode levar a resultados inesperados quando se define uma BoundingBox cujo canto inferior esquerdo não é (0, 0), porque a caixa delimitadora da página sempre terá um canto inferior esquerdo (0, 0) e sobrescreve a configuração global.
Cada página é encapsulada em salvar/restaurar. Isso significa que a maioria das configurações feitas em uma página não serão mantidas na página seguinte.
Se, até a primeira chamada de ps_begin_page(), não houver
nenhuma chamada de ps_findfont(), o cabeçalho do documento PostScript
será exibido e a caixa delimitadora será definida para o tamanho
da primeira página. O canto inferior esquerdo da caixa delimitadora é definido como (0, 0).
Se ps_findfont() tiver sido chamado antes, o
cabeçalho já terá sido exibido e o documento não terá uma
caixa delimitadora válida. Para evitar isso, deve-se chamar
ps_set_info() para definir o campo de informações
BoundingBox e possivelmente Orientation
antes de quaisquer chamadas de ps_findfont() ou
ps_begin_page().
Nota:
Até a versão 0.2.6 do pslib, esta função sempre sobrescreverá o BoundingBox e a Orientation, caso tenha sido definida anteriormente com ps_set_info() e ps_findfont() não tenha sido chamada anteriormente.
psdocIdentificador de recurso do arquivo postscript conforme retornado por ps_new().
widthA largura da página em pixels, por exemplo, 596 para o formato A4.
heightA altura da página em pixels, por exemplo, 842 para o formato A4.