A fast, helpful, and open-source document parser
decrease FFI calls per char
Logan Markewich2e4ff215d218
diff --git a/crates/liteparse/src/extract.rs b/crates/liteparse/src/extract.rsindex dd3b395..d84760d 100644--- a/crates/liteparse/src/extract.rs+++ b/crates/liteparse/src/extract.rs@@ -172,13 +172,12 @@ fn extract_page_text_items(let skip_invisible = should_skip_invisible(text_page, char_count);let page_rotation = page.rotation();+ let vp_xform = page.viewport_transform(view_box);let mut items: Vec<TextItem> = Vec::new();let mut seg = SegmentBuilder::new();for i in 0..char_count {- let Some(ch) = text_page.char_at(i) else {- continue;- };+ let ch = text_page.char_at_unchecked(i);let unicode = ch.unicode();let is_generated = ch.is_generated();@@ -231,7 +230,7 @@ fn extract_page_text_items(let Some(loose_box) = ch.loose_char_box() else {continue;};- let vp_loose = page.bounds_to_viewport(view_box, &loose_box);+ let vp_loose = vp_xform.transform_bounds(&loose_box);// Skip zero-height characters (phantom dots from dot leader decorations)if vp_loose.bottom - vp_loose.top < 0.5 {@@ -248,7 +247,7 @@ fn extract_page_text_items(right: strict_box.right as f32,bottom: strict_box.bottom as f32,};- let vp_strict = page.bounds_to_viewport(view_box, &strict_rect);+ let vp_strict = vp_xform.transform_bounds(&strict_rect);if seg.has_content {// Use viewport-space coordinates for gap/overlap checksdiff --git a/crates/pdfium/src/lib.rs b/crates/pdfium/src/lib.rsindex 19f7881..6410856 100644--- a/crates/pdfium/src/lib.rs+++ b/crates/pdfium/src/lib.rs@@ -12,6 +12,6 @@ pub use document::Document;pub use error::PdfiumError;pub use font::{Font, FontType};pub use library::Library;-pub use page::{ImageBounds, Page};+pub use page::{ImageBounds, Page, ViewportTransform};pub use text_page::{TextChar, TextCharIter, TextPage};pub use types::*;diff --git a/crates/pdfium/src/page.rs b/crates/pdfium/src/page.rsindex e6f300e..95d80e6 100644--- a/crates/pdfium/src/page.rs+++ b/crates/pdfium/src/page.rs@@ -233,6 +233,62 @@ impl Page<'_> {}}+/// Pre-computed affine transform from PDF page space to viewport space.+/// Avoids repeated FFI calls to `FPDF_PageToDevice` by probing 3 points+/// once and deriving the 6 affine coefficients.+#[derive(Debug, Clone, Copy)]+pub struct ViewportTransform {+ a: f32,+ b: f32,+ c: f32,+ d: f32,+ e: f32,+ f: f32,+}++impl ViewportTransform {+ /// Transform a single point from page space to viewport space.+ #[inline]+ pub fn transform_point(&self, page_x: f32, page_y: f32) -> (f32, f32) {+ (+ self.a * page_x + self.b * page_y + self.e,+ self.c * page_x + self.d * page_y + self.f,+ )+ }++ /// Transform a bounding rect from page space to viewport space.+ #[inline]+ pub fn transform_bounds(&self, page_bounds: &RectF) -> RectF {+ let (ll_x, ll_y) = self.transform_point(page_bounds.left, page_bounds.bottom);+ let (ur_x, ur_y) = self.transform_point(page_bounds.right, page_bounds.top);+ RectF {+ left: ll_x.min(ur_x),+ top: ll_y.min(ur_y),+ right: ll_x.max(ur_x),+ bottom: ll_y.max(ur_y),+ }+ }+}++impl Page<'_> {+ /// Build a `ViewportTransform` by probing 3 points through PDFium.+ /// This makes 3 FFI calls total, after which all transforms are pure math.+ pub fn viewport_transform(&self, view_box: &RectF) -> ViewportTransform {+ let (e, f) = self.page_to_viewport(view_box, 0.0, 0.0);+ let (ax_e, cx_f) = self.page_to_viewport(view_box, 1.0, 0.0);+ let (by_e, dy_f) = self.page_to_viewport(view_box, 0.0, 1.0);++ ViewportTransform {+ a: ax_e - e,+ b: by_e - e,+ c: cx_f - f,+ d: dy_f - f,+ e,+ f,+ }+ }+}+impl Drop for Page<'_> {fn drop(&mut self) {unsafe { pdfium_sys::FPDF_ClosePage(self.handle) };diff --git a/crates/pdfium/src/text_page.rs b/crates/pdfium/src/text_page.rsindex 143a592..d065ddb 100644--- a/crates/pdfium/src/text_page.rs+++ b/crates/pdfium/src/text_page.rs@@ -32,6 +32,15 @@ impl TextPage<'_> {}}+ /// Like `char_at`, but skips the `char_count()` FFI bounds check.+ /// The caller must ensure `index` is in `0..char_count`.+ pub fn char_at_unchecked(&self, index: i32) -> TextChar<'_> {+ TextChar {+ text_page: self,+ index,+ }+ }+/// Count rectangular areas occupied by a text segment./// Must be called before `rect()`.pub fn count_rects(&self, start: i32, count: i32) -> i32 {