2024 年 PHP Conference Japan

ps_set_info

(PECL ps >= 1.1.0)

ps_set_info設定文件的資訊欄位

說明

ps_set_info(資源 $p, 字串 $key, 字串 $val): 布林值

設定文件的某些資訊欄位。這些欄位將會以註釋的形式顯示在 PostScript 檔案的標頭中。如果文件被轉換成 PDF,這些欄位也將會被用作文件資訊。

BoundingBox 通常會被設定為第一頁所給定的值。這只有在 ps_findfont() 尚未被呼叫之前才會有效。在這種情況下,除非您使用此函式明確設定,否則 BoundingBox 將會保持未設定狀態。

當 PostScript 檔案的標頭已經寫入後,此函式將不再有任何作用。它必須在第一頁或第一次呼叫 ps_findfont() 之前呼叫。

參數

psdoc

ps_new() 返回的 PostScript 檔案的資源識別碼。

key

要設定的資訊欄位名稱。可以設定的值為 Keywords(關鍵字)、Subject(主題)、Title(標題)、Creator(創建者)、Author(作者)、BoundingBox(邊界框)和 Orientation(方向)。請注意,其中一些對 PostScript 檢視器具有特殊含義。

value

資訊欄位的值。Orientation 欄位可以設定為 Portrait(縱向)或 Landscape(橫向)。BoundingBox 是一個由四個數字組成的字串。前兩個數字是頁面左下角的座標。後兩個數字是頁面右上角的座標。

注意事項:

在 pslib 0.2.6 版之前,BoundingBox 和 Orientation 將會被 ps_begin_page() 覆蓋,除非 ps_findfont() 已經被呼叫。

返回值

成功時返回 true,失敗時返回 false

另請參閱

新增註釋

使用者貢獻的註釋

此頁面沒有使用者貢獻的註釋。
To Top