ps_begin_page

(PECL)

ps_begin_page -- 新しいページを開始する

説明

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

新しいページを開始します。widthheight というパラメータを見ると いかにもページ単位でサイズを変えられるように思えますが、PostScript ではこれは不可能です。最初に ps_begin_page() を呼んだ際に指定されたサイズが、ドキュメント全体に適用されます。 2 回目以降に呼ばれた場合はこのパラメータは意味を持たず、単に新しい ページが作られるだけです。しかし、もしあなたが PostScript ドキュメントを PDF に変換しようと考えているのなら話は別です。この関数はドキュメントの 各ページごとに pdfmark を設定するので、PDF に変換した後はページごとに サイズを変えることができます。

個々のページの情報はカプセル化して保存されています。どういうことかというと、 あるページで設定した情報のほとんどは次のページに引き継がれないということです。

最初の ps_begin_page() 呼び出しまでに一度も ps_findfont() が呼び出されていなかった場合は、 PostScript ドキュメントのヘッダが出力され、バウンディングボックスが 最初のページのサイズに設定されます。もしすでに ps_findfont() が呼ばれていた場合は既にヘッダが出力されてしまっており、ドキュメントに 適切なバウンディングボックスが設定されていないことになります。 このようなことを避けるために、ps_findfont()ps_begin_page() を実行する前にはいつも ps_set_info() を実行し、 BoundingBoxOrientation の値を設定しておくべきです。

返り値

成功した場合に TRUE を、失敗した場合に FALSE を返します。

参考

ps_end_page()
ps_findfont()
ps_set_info()