Struct Page 

pub struct Page<'a> { /* private fields */ }

A single page of a PDF document.

Implementations

impl<'a> Page<'a>

pub fn index(&self) -> usize

0-based page index.

pub fn width(&self) -> f64

Page width in points (1 point = 1/72 inch).

Examples found in repository

examples/render_page.rs (line 20)

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let args: Vec<String> = std::env::args().collect();
    if args.len() < 2 {
        eprintln!("Usage: render_page <pdf-file> [page] [dpi] [output.png]");
        std::process::exit(1);
    }

    let doc = Document::open(&args[1])?;
    let page_idx: usize = args.get(2).and_then(|s| s.parse().ok()).unwrap_or(0);
    let dpi: f64 = args.get(3).and_then(|s| s.parse().ok()).unwrap_or(150.0);
    let output = args.get(4).map(|s| s.as_str()).unwrap_or("output.png");

    let page = doc.page(page_idx)?;
    println!("Page {}: {:.0}x{:.0} pt, rotation {}", page_idx + 1, page.width(), page.height(), page.rotation());

    let png = page.render_png(dpi)?;
    std::fs::write(output, &png)?;
    println!("Rendered to {output} ({} bytes, {dpi} DPI)", png.len());

    Ok(())
}

pub fn height(&self) -> f64

Page height in points.

Examples found in repository

examples/render_page.rs (line 20)

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let args: Vec<String> = std::env::args().collect();
    if args.len() < 2 {
        eprintln!("Usage: render_page <pdf-file> [page] [dpi] [output.png]");
        std::process::exit(1);
    }

    let doc = Document::open(&args[1])?;
    let page_idx: usize = args.get(2).and_then(|s| s.parse().ok()).unwrap_or(0);
    let dpi: f64 = args.get(3).and_then(|s| s.parse().ok()).unwrap_or(150.0);
    let output = args.get(4).map(|s| s.as_str()).unwrap_or("output.png");

    let page = doc.page(page_idx)?;
    println!("Page {}: {:.0}x{:.0} pt, rotation {}", page_idx + 1, page.width(), page.height(), page.rotation());

    let png = page.render_png(dpi)?;
    std::fs::write(output, &png)?;
    println!("Rendered to {output} ({} bytes, {dpi} DPI)", png.len());

    Ok(())
}

pub fn rotation(&self) -> i64

Page rotation in degrees (0, 90, 180, 270).

Examples found in repository

examples/render_page.rs (line 20)

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let args: Vec<String> = std::env::args().collect();
    if args.len() < 2 {
        eprintln!("Usage: render_page <pdf-file> [page] [dpi] [output.png]");
        std::process::exit(1);
    }

    let doc = Document::open(&args[1])?;
    let page_idx: usize = args.get(2).and_then(|s| s.parse().ok()).unwrap_or(0);
    let dpi: f64 = args.get(3).and_then(|s| s.parse().ok()).unwrap_or(150.0);
    let output = args.get(4).map(|s| s.as_str()).unwrap_or("output.png");

    let page = doc.page(page_idx)?;
    println!("Page {}: {:.0}x{:.0} pt, rotation {}", page_idx + 1, page.width(), page.height(), page.rotation());

    let png = page.render_png(dpi)?;
    std::fs::write(output, &png)?;
    println!("Rendered to {output} ({} bytes, {dpi} DPI)", png.len());

    Ok(())
}

pub fn media_box(&self) -> Rect

MediaBox rectangle.

pub fn crop_box(&self) -> Rect

CropBox rectangle (falls back to MediaBox).

pub fn text(&self) -> Result<String>

Extract text from this page as a plain string.

Examples found in repository

examples/basic_read.rs (line 30)

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let args: Vec<String> = std::env::args().collect();
    if args.len() < 2 {
        eprintln!("Usage: basic_read <pdf-file>");
        std::process::exit(1);
    }

    let doc = Document::open(&args[1])?;

    println!("Version: {}", doc.version_string());
    println!("Pages: {}", doc.page_count());
    println!("Encrypted: {}", doc.is_encrypted());

    if let Some(title) = doc.title() {
        println!("Title: {title}");
    }
    if let Some(author) = doc.author() {
        println!("Author: {author}");
    }

    // Extract text from first page
    if let Ok(page) = doc.page(0) {
        println!("\n--- Page 1 text ---");
        match page.text() {
            Ok(text) => println!("{}", &text[..text.len().min(500)]),
            Err(e) => println!("(text extraction failed: {e})"),
        }
    }

    Ok(())
}

pub fn text_structured(&self) -> Result<PageText>

Extract structured text (with positions, fonts, etc.).

pub fn render_png(&self, dpi: f64) -> Result<Vec<u8>>

Render to PNG at the given DPI.

Examples found in repository

examples/render_page.rs (line 22)

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let args: Vec<String> = std::env::args().collect();
    if args.len() < 2 {
        eprintln!("Usage: render_page <pdf-file> [page] [dpi] [output.png]");
        std::process::exit(1);
    }

    let doc = Document::open(&args[1])?;
    let page_idx: usize = args.get(2).and_then(|s| s.parse().ok()).unwrap_or(0);
    let dpi: f64 = args.get(3).and_then(|s| s.parse().ok()).unwrap_or(150.0);
    let output = args.get(4).map(|s| s.as_str()).unwrap_or("output.png");

    let page = doc.page(page_idx)?;
    println!("Page {}: {:.0}x{:.0} pt, rotation {}", page_idx + 1, page.width(), page.height(), page.rotation());

    let png = page.render_png(dpi)?;
    std::fs::write(output, &png)?;
    println!("Rendered to {output} ({} bytes, {dpi} DPI)", png.len());

    Ok(())
}

pub fn render_jpeg(&self, dpi: f64, quality: u8) -> Result<Vec<u8>>

Render to JPEG at the given DPI and quality (0-100).

pub fn render_svg(&self) -> Result<String>

Render to SVG.

pub fn render_raw(&self, dpi: f64) -> Result<RenderedPixmap>

Render to raw RGBA pixel data.

pub fn render(&self, options: &RenderOptions) -> Result<Vec<u8>>

Render with custom options.

pub fn render_to_file(&self, path: impl AsRef<Path>, dpi: f64) -> Result<()>

Render to a file (PNG format).

pub fn search(&self, query: &str) -> Result<Vec<SearchResult>>

Search for text on this page.

pub fn search_case_insensitive(&self, query: &str) -> Result<Vec<SearchResult>>

Search for text on this page (case-insensitive).

pub fn info(&self) -> &PageInfo

Get the underlying PageInfo for low-level access.