1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
use pdfium_render::prelude::PdfPageIndex;
use crate::{
PdfDocument,
error::{PdfError, TextError},
};
impl<'p> PdfDocument<'p> {
/// Extract the native text layer from a page.
///
/// Returns `Ok(None)` if the page exists but has no text layer (e.g. scanned image).
/// Returns `Err` if the page index is out of range or pdfium fails.
pub fn extract_text_layer(&self, page_index: u32) -> Result<Option<String>, PdfError> {
let page = self
.pages()
.get(page_index as PdfPageIndex)
.map_err(|source| TextError::ExtractionFailed {
page: page_index,
source,
})?;
let text_object = page.text().map_err(|source| TextError::ExtractionFailed {
page: page_index,
source,
})?;
let text = text_object.all();
if text.trim().is_empty() {
Ok(None)
} else {
Ok(Some(text))
}
}
/// Returns a lazy iterator of `(page_index, Option<text>)` for every page.
///
/// `Ok((i, Some(text)))` — page has a native text layer.
/// `Ok((i, None))` — page exists but has no text layer (scanned); needs OCR.
/// `Err(_)` — pdfium failed to access or extract from the page.
pub fn extract_all_text_layers(
&self,
) -> impl Iterator<Item = Result<(u32, Option<String>), PdfError>> {
(0..self.page_count()).map(|i| self.extract_text_layer(i).map(|text| (i, text)))
}
}