array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.ps-begin-page.php', 1 => 'ps_begin_page', 2 => 'Inicia uma nova página', ), 'up' => array ( 0 => 'ref.ps.php', 1 => 'Funções de 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' => 'pt_BR', 'path' => 'reference/ps/functions/ps-begin-page.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

ps_begin_page

(PECL ps >= 1.1.0)

ps_begin_page — Inicia uma nova página

Descrição

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

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.

Parâmetros

psdoc

Identificador de recurso do arquivo postscript conforme retornado por ps_new().

width

A largura da página em pixels, por exemplo, 596 para o formato A4.

height

A altura da página em pixels, por exemplo, 842 para o formato A4.

Valor Retornado

Retorna true em caso de sucesso ou false em caso de falha.

Veja Também