pub struct SharedObjectHeader {
pub first_object_number: u32,
pub location: u64,
pub first_page_entries: u32,
pub section_entries: u32,
pub bits_group_object_count: u32,
pub least_length: u64,
pub bits_length_delta: u32,
}Expand description
Header for the Shared Object Hint Table (7 items per Annex F.3.2).
Items are numbered 1–7 in the spec; field names here follow the spec text.
§Back-patch fields
location(item 2): byte offset of the first object in the shared objects section. Set to0(placeholder); back-patched once the real offset is known.least_length(item 6): minimum byte length of an object in the shared objects section. Set to0(placeholder); back-patched once the real offset is known.
Fields§
§first_object_number: u32Item 1 — Object number of the first object in the shared objects section (i.e. the first new number assigned to a Part-3 object).
0 if there are no shared objects (degenerate case).
location: u64Item 2 — Byte offset of the first object in the shared objects section.
Placeholder: 0; back-patched once the real offset is known.
first_page_entries: u32Item 3 — Number of shared object entries for the first page
(= count of Part-3 objects whose referencing_pages includes page 0).
section_entries: u32Item 4 — Total number of shared object entries (= plan.shared_hints.len()).
bits_group_object_count: u32Item 5 — Bits used for each entry’s nobjects_minus_one value
(nbits_nobjects in qpdf).
least_length: u64Item 6 — Least byte length of an object in the shared objects section.
Placeholder: 0; back-patched once the real offset is known.
bits_length_delta: u32Item 7 — Bits needed to represent the difference between the greatest and least length of an object in the shared objects section (item 2 of the per-shared-object entry).
Since all lengths are 0 (placeholder) at this stage the delta is 0 and bits = 0. The encoder must re-derive bit widths at encode time using the final values after back-patching.