整数ページインデックスとは？
整数ページインデックスとは、 0始まりのインデックス のことで、PDF ファイル内のページを管理するために使用されます。最初のページには整数ページインデックス 0 が割り当てられます。
このインデックス方式は主に PDF の内部データ構造で使用されており、 フラグメント識別子 とは異なり、フラグメント識別子は 1 始まりのカウント方式を採用しています。
なぜ2つの番号付けシステムが並行して存在するのか
整数ページインデックスは実装上の詳細です。これはファイル内のページツリーがページを参照する方法であり、人向けの番号ではなく配列のオフセットであるため、0から始まります。 閲覧者が画面で目にするものは、まったく別のものです。それはドキュメントの ページラベル, から来ており、ローマ数字やアルファベット、章とページの組み合わせなどを使うことができ、1から始める必要も、順番通りである必要もありません。
違いが問題になる場面
この2つのシステムは1だけずれており、このずれはPDF処理を自動化する際によくある「オフバイワン」エラーの原因となります。 フラグメント識別子 のように、URL 内の page パラメータなどは人が数える方法に合わせて1から数えますが、内部インデックスは0から数えます。
ツールが分割・回転・削除するページを尋ねる場合、ほとんどは人間の数え方を前提としています。一方でライブラリがページ番号を返すときは、それがどちらの方式かを、信頼して使う前に必ず確認してください。