PDF 構文 クロスリファレンスストリーム

クロス・リファレンス ストリームはストリームオブジェクト(Stream Object)に含まれていてその内容はクロス・リファレンス テーブルと同様です。
このストリーム オブジェクトのディクショナリにはトレイラー(Trailer)情報が含まれています。

以下にクロス・リファレンス ストリームの例を示します。
ここでは、HelloWorld.pdfを例にしています。このPDFの内容はこちらです。

... objects ...

9 0 obj            % Cross-reference stream
  << /Type /XRef   % Cross-reference stream dictionary
    /Size ...
    /Root ...
  >>
stream
...                % Stream data containing cross-reference information
endstream
endobj

... more objects ...

startxref
byte_offset_of_cross-reference_stream % Points to object 9
%%EOF

PDF Imager-LP（無償版）でクロスリファレンス ストリームオブジェクトを表示するソースコード

// 初期化
MlpInitialize("0-03W2-HE1180K4R141");

// オープン
if (0 <= MlpOpenDoc("HelloWorld.pdf", "", "")) {

    // クロスリファレンス
    int num, gen;
    if (MlpIsXrefStream(&num, &gen) > 0) {
        MlpShowIndirectObj(num, 1);
        printf("startxref\n%d\n%%%%EOF\n", MlpGetXrefOffset());
    }
    else
        printf("Cross-Reference is Table\n");

    // クローズ
    MlpCloseDoc();
}

// 終了
MlpUninitialize();

using (var mlp = new PdfImager()){
    // ライセンスキー
    mlp.Initialize("0-03W2-HE1180K4R141");

    // オープン
    if (0 <= mlp.OpenDoc("HelloWorld.pdf"))
    {
        // クロスリファレンス
        int num, gen;
        if (mlp.IsXrefStream(out num, out gen))
        {
            mlp.ShowIndirectObj((uint)num);
            Console.WriteLine($"startxref\n{mlp.XrefOffset}\n%%EOF");
        }
        else Console.WriteLine("Cross-Reference is table");

        // クローズ
        mlp.CloseDoc();
    }
}

クロス・リファレンス ストリーム(Cress-Reference Stream)ディクショナリには以下に示す項目が通常のストリーム オブジェクト(Stream Object)のディクショナリおよびトレイラー(Trailer)ディクショナリの項目に追加して記載されます。

オブジェクトのタイプは「2.5オブジェクト」を参照してください。

上記の表で示された項目はすべてダイレクト オブジェクトでなければなりません（「インダイレクト オブジェクトの参照指定はできない」という意味です）。array(IndexやW)で指定する場合でもその要素はダイレクトオブジェクトでなければなりません。
クロスリファレンス ストリームは暗号化してはいけません。

以下はHelloWorld.pdfのクロス・リファレンス ストリーム ディクショナリです。

9 0 obj
<<
  /Type /XRef
  /Length 40
  /W [ 1 2 1 ]
  /Info 6 0 R
  /Root 7 0 R
  /Size 10
  /ID [<1775615b6d180ff72f4473d56aaa72bf><c446479d244d5815a119bac7e56e7757>]
>>
stream
  ... binary ...
endstream
endobj

このPDFでは、W要素の指定によって、streamのバイナリデータを１バイト、２バイト、１バイト（合計４バイト）を１つのフィールドとして解釈しなければなりません。

クロス・リファレンス ストリーム データは３つの要素で構成されたフィールドの集合です。各フィールドに含まれる要素のバイトサイズはクロスリファレンス ディクショナリのW配列で指定されます。
クロスリファレンス ストリームは１つ以上のフィールドで構成されます。

各フィールドの最初の要素でそのタイプを示します（以下の表参照）。タイプは３種類が規定されています。タイプによってそれに続く２要素の意味が異なります。

各タイプにおける３要素の意味を以下に記します。