Why some PDFs read immediately and others don't

Two PDFs can look identical on screen but store their charts very differently. What matters to the Reader is how the grid and symbols are stored, not just whether the file ends in .pdf.

  • Vector / original PDF — the grid lines and symbols are preserved as separate PDF objects: text characters and drawn shapes that Flossom can extract and place on the chart. These files usually offer the best Reader compatibility and are often exported directly from WinStitch, MacStitch, PCStitch or other charting software. An original export is the best starting point, but the software name alone does not guarantee compatibility: the export settings and chart layout still matter.
  • Raster / flattened PDF — the chart is effectively a picture made of pixels. The grid and symbols are still visible, but they must be recognised visually rather than extracted as separate text and shapes. Flossom's current production Reader cannot yet reconstruct these charts reliably. Raster/flattened and scanned-chart recognition is in development.
  • Scanned / photographed paper chart — this is also a picture-based chart, with additional challenges. A tilted page can skew the grid; uneven lighting, shadows and image noise can obscure symbols; perspective can make squares appear different sizes. Future Reader development includes recognising these charts and accounting for those distortions. This is not currently available for ordinary imports, and there is no release date announced.

For now, choose the designer's original PDF or an app-formatted / Pattern Keeper-compatible version when one is supplied. Saving a scan or screenshot as a PDF does not turn its pixels into separate grid lines and symbols. Being able to select chart text can be a clue, but it is not a compatibility test: a scanned file may have a searchable text layer without an extractable chart grid. A picture on the cover also does not mean the chart pages are picture-only.