.xpr 檔案

這些檔案的預設儲存位置是 /usr/lib/lp/locale/C/mp/。.xpr 檔案相對應至每一個 PostScript prolog 版面配置檔案，除了 mp.common.ps. 以外。您可以藉由定義 MP_PROLOGUE 環境變數，來定義替代的 prolog 目錄。

這些檔案以關鍵字/值對的方式作業。以 # 起始的行將視為註釋。除非明確敘述否則以空白隔開不同的記號。每個 .xpr 檔案的三個主要區段，乃是藉由下列關鍵字對當做界限：

• STARTCOMMON/ENDCOMMON

• STARTPAGE/ENDPAGE

• STARTCOLUMN/ENDCOLUMN

• STARTFORCEDPAGE/ENDFORCEDPAGE

• STARTFORCEDCOLUMN/ENDFORCEDCOLUMN

某些關鍵字/值對可以用在這三個區域中。下列章節將針對每個區域作說明。

STARTCOMMON/ENDCOMMON 關鍵字

所有出現在 STARTCOMMON 關鍵字之後並在 ENDCOMMON 關鍵字之前的關鍵字/值對，定義了列印頁面的一般屬性。關鍵字的數個不同有效值是由斜線 (/) 區分開來。

ORIENTATION 0/1

0 表示以縱向列印，1 表示以橫向列印。

PAGELENGTH unsigned-integer

表示每一個邏輯頁面行數的值。

LINELENGTH unsigned-integer

表示每行單一欄位字元數的值。

NUMCOLS unsigned-integer

每一實體頁面的邏輯頁面數。

HDNGFONTSIZE unsigned-integer

以十分之一點計算的標題字型點大小。

BODYFONTSIZE unsigned-integer

以十分之一點計算的內文字型點大小 。

PROLOGDPI unsigned-integer

目前的 .xpr 檔案建立時所使用的每英吋點數標度。

YTEXTBOUNDARY unsigned-integer

此 y 座標可建立頁面或邏輯頁面 (欄位) 中的文字列印邊界。此邊界是用來當做額外的檢查，以便檢視文字列印是否發生在預期的區域內。當您從相對應的字型中取得字元高度資訊時可能會出現錯誤，因此在進行「複合文字版面配置」和 EUC 列印時將會需要此邊界。

STARTTEXT unsigned-integerunsigned-integer

當真實文字從實體頁面中的第一頁邏輯頁面開始列印時，x/y 點為十分之一點。

PAGESTRING 0/1

1 表示需要將頁面字串附加在標題中的頁面編號之前。

0 表示只顯示頁面編號。

EXTRAHDNGFONT font string 1, font string 2, ... font string n

字型字串是 X 邏輯字型描述。將關鍵字 EXTRAHDNGFONT 從逗號分隔字型名稱清單分隔開來的記號是引號 " 字元，不是空格或定位字元。在列印標題時，這些字型的優先順序將高於內建的字型。通常，EXTRABODYFONT 是用來指定配置在 /usr/openwin/server/etc/XpConfig/C/print/models/<model name>/fonts 目錄中的印表機內建字型。

該 fonts.dir 檔案包含印表機內建字型的 XLFD。

在 .xpr 檔案中，通常會指定字型，如下列範例所示：

 "-monotype-Gill Sans-Regular-r-normal- -*-%d-*-*-p-0-iso8859-2" 

若出現 %d，則將由mp 取代為 .xpr 檔案中目前的標題字型點大小。x 解析度和 y 解析度是由 * 指定的。如果可以的話，將平均寬度欄位設定為 0，以指示選擇可縮放字型。您也可以提供更多指定的字型名稱。

EXTRABODYFONT font string 1, font string 2, ... font string n

除了這些字型是用來列印頁面內文之外，其餘與 EXTRAHDNGFONT 相同。

XDISPLACEMENT signed/unsigned int

針對頁面內容在 x 軸方向的移位，提供 x 軸座標位移以套用至頁面。此位移可以是 +ve 或 -ve 值。

YDISPLACEMENT signed/unsigned int

除了 y 軸中發生移位之外，其餘與 x 置換相同。

當您處理一些頁邊寬度並不符合標準的印表機，而需要移動頁面中的列印內容時，這兩個關鍵字將非常有用。

STARTPAGE/ENDPAGE 關鍵字

此區段中的關鍵字值對是以 STARTPAGE 以及 ENDPAGE 關鍵字當做邊界。此區段包含欲套用至實體頁面的繪圖與標題資訊。一張實體頁面可包含許多的邏輯頁面，但包含在這些關鍵字中的所有繪圖常式只能套用至實體頁面一次。

有效的繪圖實體為 LINE 和 ARC。XDrawLine() 和 XDrawArc() 函式將以這些關鍵字的值執行。

此區段中的維度是以 PROLOGDPI 單元做對映。角是以度計算。

LINE x1 y1 x2 y2

x/y 無符號座標可定義一對用來連接到線上的點。

ARC x y width height angle1 angle2

x 軸與 y 軸皆為表示 arc 原點的無符號整數。寬度與高度為表示 arc 寬度與高度的無符號整數。

USERSTRINGPOS x y

無符號座標表示使用者資訊列印在標題的位置。

TIMESTRINGPOS x y

無符號座標表示列印次數在標題的位置。

PAGESTRINGPOS x y

無符號座標表示列印每個列印頁面的頁面字串位置。

SUBJECTSTRINGPOS x y

無符號座標表示頁面中列印主題的位置。

STARTFORCEDPAGE/ENDFORCEDPAGE 區段

當指定 -n 選項予 mp 時，所有 STARTPAGE/ENDPAGE 區段中指定的裝飾皆不列印。然而，即使指定了 -n 選項，也會列印所有包含在 STARTFORCEDPAGE/ENDFORCEDPAGE 區段中的內容。

STARTCOLUMN/ENDCOLUMN 區段

所有關鍵字皆與STARTPAGE/ENDPAGE 關鍵字中說明的相同，除了此區段中的項目是套用 NUMCOLS 次數至實體頁面上。如果 NUMCOLS 為 3，則實體頁面的可列印區域會分割成三部份和線、弧或每個頁面出現三次的標題裝飾。

STARTFORCEDCOLUMN/ENDFORCEDCOLUMN 區段

當 -n 選項給定為 mp 時，所有在 STARTCOLUMN/ENDCOLUMN 區段中所給定的裝飾都不會列印。然而，即使指定了 -n 選項，也會列印所有包含在 STARTFORCEDCOLUMN/ENDFORCEDCOLUMN 區段中的內容。

建立新的 .xpr 檔案

當建立新的 .xpr prolog 檔案時，您只能指定預設值以外的值。

如果這些值不是在 .xpr 檔案中為 STARTCOMMON/ENDCOMMON 區段所指定的，則下表將列出不同關鍵字的 mp 程式預設值。

表 7–2 STARTCOMMON/ENDCOMMON 關鍵字值

關鍵字	值
ORIENTATION	0
PAGELENGTH	60
LINELENGTH	80
YTEXTBOUNDARY	3005
NUMCOLS	01
HDNGFONTSIZE	120
PROLOGDPI	300
STARTTEXT	135 280
PAGESTRING	0

以 STARTPAGE/ENDPAGE 和 STARTCOLUMN/ENDCOLUMN 做為邊界的其他兩個區段不需要預設值。

若要建立不含裝飾的頁面，請以直向格式在每個實體頁面上使用四個邏輯頁面。指定下列的區段以及值：

• STARTCOMMON

• NUMCOLS 04

• LINELENGTH 20

• ENDCOMMON

當您建立不含裝飾的頁面時，不需要指定下列兩個區段：

• STARTPAGE/ENDPAGE

• STARTCOLUMN/ENDCOLUMN

如果您並未在列印頁面上放置裝飾，則不需要這些參數。所有座標的預設值都是 300 dpi，除非您沒有指定 PROLOGDPI 關鍵字。若是目標印表機的解析度不同，.xpr 檔案將藉由程式按比例縮放以符合該解析度。

在建立 .xpr 檔案之前，您必須知道紙張的大小。針對 U.S. 紙張，8.5x11 英吋，針對解析度 300 dpi 的印表機，2550X3300 為整體大小。大多數的印表機無法從紙張的最左上角開始列印。相反的，部分邊界空格是圍繞著實體頁面而指定的。即使您嘗試從 0,0 開始列印，實際的列印動作並不會從頁面的最左上角開始。當您建立新的 .xpr 檔案時，請考慮此限制。