jedarden 5f35619595 feat(bf-okdnk): add CMAP output parsing and inspection

- Add iter() method to ToUnicodeMap for accessing CMAP structure
- Extend test_cmap_unmapped_glyph_skip to show CMAP contents
- Extend test_cmap_multiple_mappings_with_unmapped_check to show mappings
- Add debug output for inspection of source bytes and target chars
- Add verification note at notes/bf-okdnk.md

This enables inspection of CMAP output structure to verify unmapped glyphs
are properly handled before implementing actual filtering logic.

Closes bf-okdnk

2026-07-06 17:54:13 -04:00

1.9 KiB

Raw Blame History

bf-okdnk: CMAP Output Parsing

Summary

Extended the CMAP unmapped glyph test from bf-4y66q to access and parse the generated CMAP output structure.

Implementation

1. Added `iter()` method to `ToUnicodeMap`

File: crates/pdftract-core/src/font/cmap.rs

Added a public iterator method to ToUnicodeMap that allows tests (and other code) to iterate over all CMAP mappings for inspection:

pub fn iter(&self) -> impl Iterator<Item = (&Vec<u8>, &Vec<char>)> {
    self.mappings.iter()
}

This returns an iterator over (source_bytes, target_chars) pairs.

2. Extended tests to show CMAP contents

File: crates/pdftract-core/tests/cmap_unmapped_glyphs.rs

Extended two tests to demonstrate CMAP output structure access:

test_cmap_unmapped_glyph_skip: Shows basic single mapping with detailed debug output
test_cmap_multiple_mappings_with_unmapped_check: Shows multiple mappings with compact debug output

Both tests now include inspection sections that display:

Source bytes in hex format
Target characters as strings
Unicode code points
Total mapping count

Verification

Test Results

Both extended tests pass successfully:

=== CMAP Output Structure Inspection ===
  Source bytes: [00]
  Target chars: "A" (Unicode: [0041])
  Total mappings: 1
=== End CMAP Inspection ===

=== CMAP Multiple Mappings Inspection ===
  [[02]] → C
  [[01]] → B
  [[00]] → A
  Total mappings: 3
=== End Inspection ===

Acceptance Criteria

✅ Test can access CMAP output structure - iter() method provides access
✅ Test compiles without errors - All code compiles
✅ Test runs to completion - Tests pass without hanging or failing
✅ CMAP contents are visible for inspection - Debug output shows all mappings

Artifacts

Modified: crates/pdftract-core/src/font/cmap.rs (added iter() method)
Modified: crates/pdftract-core/tests/cmap_unmapped_glyphs.rs (extended two tests)

1.9 KiB Raw Blame History