8. `fix::` 名前空間 — 正規化

PDF を変更して新しいファイルを保存する19の操作。元のファイルは決して 書き換えられません。

---

8.1 使い方

fix:: は書き込みを行う唯一の名前空間なので、専用のコマンドで実行します：

pdfl fix input.pdf script.pdfl --output fixed.pdf

オプション	動作
--output <file>	出力 PDF（必須）
--dry-run	保存せず、操作の一覧だけ表示
--report json|csv|html|pdf	レポート形式
--report-file <file>	レポートをファイルに書き出す

pdfl run で fix:: を呼ぶと、正しいコマンドを案内するエラーになります。 検証のつもりで修正を適用してしまう事故を防ぐためです。

操作の動き

// このスクリプトに check は不要です：順に実行されるコマンドです。
fix::set_trim_box(8.5, 8.5, 586.5, 833.5)
fix::add_page_numbers()
fix::add_watermark("DRAFT")

各呼び出しはその場で検証され（存在しないページ、不正な回転角、無いファイル）、 そのあとで適用されます。レポートには実施内容が fixes として入ります：

"fixes": [
  "TrimBox set to [8.5, 8.5, 586.5, 833.5]",
  "page numbering added",
  "watermark \"DRAFT\" added"
]

同じスクリプトで検証と修正を混ぜても構いません：

// 修正の前に検証 — 前提が崩れていればレポートに出ます
check "Preconditions" {
  require doc.page_count > 0
  assert !struct::check_encryption(), "file is encrypted, cannot fix it"
}

fix::add_page_numbers()

---

8.2 ページボックス

操作	動作
fix::set_page_size(width, height)	全ページの MediaBox を設定
fix::set_crop_box(x0, y0, x1, y1)	全ページの CropBox を設定
fix::set_trim_box(x0, y0, x1, y1)	全ページの TrimBox を設定
fix::set_bleed_box(x0, y0, x1, y1)	全ページの BleedBox を設定

座標はポイント、左下から右上の順です。

// A4 をポイントで — 単位を使えば変換は自動です
fix::set_page_size(210mm, 297mm)

// 出版社から制作用ボックス無しで届いた場合：
// TrimBox = 仕上がり、BleedBox = 塗り足し 3mm を含む範囲
fix::set_trim_box(8.5, 8.5, 586.5, 833.5)
fix::set_bleed_box(0, 0, 595, 842)

---

8.3 ページ

操作	動作
fix::rotate_page([page,] degrees)	90/180/270 度回転（ページ省略で全ページ）
fix::delete_page(n)	ページを削除
fix::duplicate_page(n)	ページを複製（直後に挿入）
fix::reorder_pages([新しい, 順序])	並べ替え（各ページをちょうど一度ずつ）
fix::split_document(from, to, "out.pdf")	範囲を別ファイルに保存
fix::merge_documents("other.pdf")	別 PDF のページを末尾に追加

唯一のページを削除しようとすると、明確なメッセージで拒否されます。

fix::rotate_page(90)        // 全ページ
fix::rotate_page(3, 180)    // 3ページ目だけ
fix::delete_page(1)         // 下書きの表紙を削除
fix::reorder_pages([4, 1, 2, 3])

// 表紙と本文を別の業者へ送るために分割
fix::split_document(1, 2, "cover.pdf")
fix::split_document(3, 50, "body.pdf")

fix::merge_documents("attachments/warranty.pdf")

---

8.4 コンテンツ

操作	動作
fix::add_watermark("text")	全ページに斜めのグレーの透かし
fix::add_stamps("text")	各ページ右上に赤いスタンプ
fix::add_page_numbers()	フッターに n / total
fix::remove_annotations()	すべての注釈を削除
fix::remove_attachments()	すべての添付ファイルを削除
fix::flatten_layers()	オプショナルコンテンツ（OCG）を解除

fix::add_watermark("DRAFT — DO NOT PRINT")
fix::add_stamps("APPROVED 2026-08-02")
fix::add_page_numbers()

// 印刷所へ送る前に：校正コメントは出てはいけませんし、
// 添付はファイルを重くするだけです
fix::remove_annotations()
fix::remove_attachments()

// 「英語版」を非表示にしたレイヤーが誤って再表示される事故を防ぎます
fix::flatten_layers()

---

8.5 最適化

この節の操作はファイルが小さくなる場合にのみ書き込みます。書き直しの 結果が大きくなる場合は元のまま保持されます。

操作	動作
fix::remove_unused_resources()	trailer から到達できないオブジェクトを破棄
fix::downsample_images([dpi])	目標 DPI（既定 300）超の画像をリサンプル
fix::compress_images([quality])	画像を JPEG で再エンコード（1〜100、既定 85）

DPI はページ上の実際の印刷サイズから計算されます。

CMYK 画像はそのまま保持されます。 リサンプルには RGB への変換が必要で、 印刷用の分版が失われてしまうためです。印刷所のファイルでは RGB 画像から 削減効果が得られます。

// メール承認用の版に 300 DPI は不要です
fix::downsample_images(96)
fix::compress_images(70)
fix::remove_unused_resources()

利用できない操作

subset_fonts と linearize_document は fix:: の操作として存在せず、 未知の関数としてエラーになります。

• subset_fonts：実装して計測しました。プロ用の生成ツールは既に使用する グリフだけを埋め込むため、削減効果は最良でも 0.5%、他ではゼロでした。 フォント破損のリスクに見合いません。サブセットかどうかを確認するには prepress::subset_fonts() を使ってください。
• linearize_document：ヒントテーブル（PDF 仕様 §7.14）の生成が必要です。 これを行う Rust ライブラリは存在せず、部分的な実装ではリーダーが 「Fast Web View」と認識しません。

---

8.6 完全な例

出版社のファイルを印刷所向けに整える

prepare_for_print.pdfl

// 使い方: pdfl fix publisher.pdf prepare_for_print.pdfl --output print.pdf

check "Preconditions" {
  require doc.page_count > 0
  assert !struct::check_encryption(),
    "file is encrypted — ask the publisher for the open version"
}

// 出版社が設定しなかった制作用ボックス
fix::set_trim_box(8.5, 8.5, 586.5, 833.5)
fix::set_bleed_box(0, 0, 595, 842)

// 整理：校正コメントと添付は印刷に回しません
fix::remove_annotations()
fix::remove_attachments()
fix::flatten_layers()
fix::remove_unused_resources()

メール承認用の軽量版

email_version.pdfl

// 使い方: pdfl fix final.pdf email_version.pdfl --output approval.pdf

fix::downsample_images(96)
fix::compress_images(70)
fix::add_watermark("PROOF — NOT THE FINAL VERSION")
fix::add_page_numbers()

pdfl 自身で結果を確認します：

pdfl fix final.pdf email_version.pdfl --output approval.pdf
pdfl inspect approval.pdf          # 生成されたファイルのサイズ・DPI・警告

---

← codes:: · 目次 · 次：data:: →