MediaBox、CropBox、BleedBox:我在看哪個頁面框?
PDF 每頁存有 MediaBox、CropBox、TrimBox 等多個矩形。PDF123 裁切把 MediaBox 與 CropBox 寫成同一矩形,讓檢視器與媒體尺寸對齊。

PDF 頁面不是單一矩形。格式裡存了好幾個頁面框,正因為如此,印表機、檢視器與編輯器可以對「頁面多大」各有一套說法。裁切結果看起來不對,或印廠問你要出血時,你爭論的往往就是當下哪個框在起作用。
這些框分別是什麼
- MediaBox:完整的頁面畫布,也是定義媒體尺寸的最大矩形。每一頁都應該有一個。
- CropBox:檢視器當成可見頁面來繪製的區域。省略時預設等於 MediaBox。
- BleedBox:商業印刷中,越過裁切邊的出血區域。
- TrimBox:裁切之後預期的成品尺寸。
- ArtBox:有意義內容的範圍,辦公 PDF 較少見。
檢視器幾乎總是畫 CropBox,印前軟體在意的卻是 BleedBox 與 TrimBox。兩者弄混,就會出現那句經典回報:「我明明裁過了,印表機看到的還是舊邊距。」螢幕上的視窗確實動了,但 MediaBox 或 TrimBox 仍宣告著舊畫布。
座標在 PDF 使用者空間裡,一點等於 1/72 英寸,原點是被描述那個框的左下角,不是螢幕視窗的左上角。凡是接受「X、Y、寬、高」的工具,描述的都是這個空間裡的矩形。
裁切改的是可見邊界
在 PDF123 上,裁切 接受以點為單位的 X、Y、寬、高,並把這個矩形同時寫進每一頁的 MediaBox 與 CropBox。因此,重視 CropBox 的檢視器與讀取 MediaBox 的工具,在作業之後看到的是同一個頁面尺寸。新框之外的內容會從檢視中消失,但底層內容串流不一定被刪除。先處理幾何,把用不到的繪圖運算子銷毀是另一件工作。
其他應用程式有時只改 CropBox,把 MediaBox 留在原處。這種檔案換到別處打開,很容易被當成「裁切失敗」,實際上只是兩個框不一致。斷定檔案損壞之前,先看清每個工具顯示的是哪個框。
裁切不會重寫 BleedBox、TrimBox 或 ArtBox。如果印刷流程仍在讀那幾個字典,它們會繼續描述裁切前的頁面,直到印前工具把它們更新。辦公情境裡「為了寄 email 裁掉一點邊距」這類需求,通常只在意 MediaBox 與 CropBox 是否對齊,而那正是這條裁切路徑所設定的。
縮放是另一根槓桿
縮放頁面 改變的是頁面尺寸(A4、Letter,或一個縮放係數),而不是在目前畫布內裁出一個視窗。它同樣把 MediaBox 與 CropBox 設成目標尺寸,並用縮放變換把頁面內容包起來,讓圖面裝進新畫布。想保留某個區域、隱藏其餘內容時用裁切;想讓整頁對應到目標紙張尺寸時用縮放。
把一張 letter 頁裁成 200×200 pt 的視窗,和把同一張 letter 頁縮放到 A4,並不能互換。前者讓矩形之外的一切從檢視中消失,後者把整頁重新映射到新的媒體尺寸。
診斷一份「尺寸不對」的檔案
印廠說你在別的應用程式裡「裁過」之後,頁面仍是 letter 尺寸時,請分別匯出或檢查 MediaBox 與 CropBox。只改 CropBox 的檔案在檢視器裡看起來可能正確,MediaBox 卻仍向拼版軟體報告舊畫布。PDF123 裁切把同一個矩形寫進兩者,避免這種分叉。
如果頁面在合併或匯入之後看起來被切掉,檢查上游工具是否把 CropBox 設得比 MediaBox 小,卻沒有同時更新兩者。取得資訊 報告的是頁數與加密狀態,不是框座標;需要具體數字時,請用 PDF 檢視工具或裁切介面上的點欄位。
實務結論
在相信螢幕上的毫米數之前,先問一句:我在看哪個框?兩個工具對頁面尺寸說法不一致時,先比較 MediaBox 與 CropBox,再懷疑損壞。要在瀏覽器裡互動裁切:裁切 PDF,不需要帳號。做自動化時,同一批幾何欄位在 POST /api/v1/general/crop 上;見 開發者。