Skip to content

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.rs
index 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 checks
diff --git a/crates/pdfium/src/lib.rs b/crates/pdfium/src/lib.rs
index 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.rs
index 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.rs
index 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 {