ps_begin_page

說明

開始一個新頁面。雖然參數 width 和 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_findfont() 或 ps_begin_page() 呼叫之前，呼叫 ps_set_info() 來設定資訊欄位 BoundingBox 以及可能的 Orientation。

注意事項:

在 pslib 0.2.6 版之前，如果先前已使用 ps_set_info() 設定 BoundingBox 和 Orientation，且之前未呼叫 ps_findfont()，則此函式將始終覆蓋 BoundingBox 和 Orientation。