Редагування тексту

PDF Oxide надає редагування тексту у стилі DOM через об’єкт PdfPage. Ви можете запитувати текстові елементи, змінювати їх вміст та зберігати зміни назад у PDF. Кожен текстовий елемент представлений як вузол PdfText з доступом до вмісту, метаданих шрифту, обмежувальної рамки та позиціонування.

Отримання сторінки

Python

from pdf_oxide import PdfDocument

doc = PdfDocument("input.pdf")
page = doc.page(0)  # Get page at index 0

Rust

Використовуйте API Pdf:

use pdf_oxide::api::Pdf;

let mut doc = Pdf::open("input.pdf")?;
let page = doc.page(0)?;

Або використовуйте DocumentEditor напряму:

use pdf_oxide::editor::DocumentEditor;

let mut editor = DocumentEditor::open("input.pdf")?;
let page = editor.get_page(0)?;

Пошук тексту

find_text_containing

Пошук текстових елементів, що містять конкретний рядок.

page = doc.page(0)
texts = page.find_text_containing("Hello")
for t in texts:
    print(f"Found: '{t.value}' at {t.bbox}")

let page = doc.page(0)?;
let texts = page.find_text_containing("Hello");
for t in &texts {
    println!("Found: '{}' at {:?}", t.text(), t.bbox());
}

find_text (лише Rust)

Пошук з користувацьким предикатом для більш гнучкого порівняння.

// Find all bold text larger than 14pt
let headings = page.find_text(|t| t.is_bold() && t.font_size() > 14.0);
for h in &headings {
    println!("Heading: {}", h.text());
}

// Find text by font name
let courier_text = page.find_text(|t| t.font_name().contains("Courier"));

Зміна тексту

set_text

Заміна вмісту текстового елемента за його ID.

page = doc.page(0)
for t in page.find_text_containing("DRAFT"):
    page.set_text(t.id, "FINAL")
doc.save_page(page)
doc.save("output.pdf")

let mut page = doc.page(0)?;
let drafts = page.find_text_containing("DRAFT");
for t in &drafts {
    page.set_text(t.id(), "FINAL")?;
}
doc.save_page(page)?;
doc.save("output.pdf")?;

modify_text (лише Rust)

Застосуйте замикання для зміни текстового елемента на місці з доступом до повного API PdfText.

let mut page = doc.page(0)?;
let texts = page.find_text_containing("price");
for t in &texts {
    page.modify_text(t.id(), |text| {
        let old = text.text().to_string();
        let new = old.replace("$9.99", "$12.99");
        text.set_text(new);
    })?;
}
doc.save_page(page)?;

Властивості PdfText

Кожен елемент PdfText надає доступ для читання своїх властивостей.

Python

page = doc.page(0)
for t in page.find_text_containing(""):
    print(f"Text: {t.value}")
    print(f"Font: {t.font_name} {t.font_size}pt")
    print(f"Bold: {t.is_bold}, Italic: {t.is_italic}")
    print(f"BBox: {t.bbox}")
    print(f"Contains 'hello': {t.contains('hello')}")
    print(f"Starts with 'A': {t.starts_with('A')}")
    print(f"Ends with '.': {t.ends_with('.')}")

Rust

let page = doc.page(0)?;
for t in &page.find_text_containing("") {
    println!("Text: {}", t.text());
    println!("Font: {} {:.1}pt", t.font_name(), t.font_size());
    println!("Bold: {}, Italic: {}", t.is_bold(), t.is_italic());
    println!("BBox: {:?}", t.bbox());
    println!("Color: {:?}", t.color());

    // String operations
    println!("Contains 'hello': {}", t.contains("hello"));
    println!("Starts with 'A': {}", t.starts_with("A"));
    println!("Ends with '.': {}", t.ends_with("."));
    println!("Empty: {}", t.is_empty());
    println!("Length: {}", t.len());
}

Повний API PdfText (Rust)

Методи вмісту

Метод	Повертає	Опис
text()	&str	Отримати текстовий вміст
value()	&str	Псевдонім для text()
set_text(new_text)	()	Замінити текстовий вміст
set_value(new_text)	()	Псевдонім для set_text()
append(text)	()	Додати текст у кінець
replace(old, new)	usize	Замінити входження, повертає кількість
clear()	()	Видалити весь текстовий вміст
is_empty()	bool	Перевірити, чи текст порожній
len()	usize	Отримати довжину тексту
contains(needle)	bool	Перевірити, чи текст містить підрядок
starts_with(prefix)	bool	Перевірити наявність префікса
ends_with(suffix)	bool	Перевірити наявність суфікса

Методи шрифту та стилю

Метод	Повертає	Опис
font_name()	&str	Назва шрифту PostScript
font_size()	f32	Розмір шрифту у пунктах
is_bold()	bool	Перевірити, чи жирний
is_italic()	bool	Перевірити, чи курсив
color()	Color	Колір тексту
set_style(style)	()	Задати стиль тексту

Методи позиції та трансформації

Метод	Повертає	Опис
id()	ElementId	Унікальний ідентифікатор елемента
bbox()	Rect	Обмежувальна рамка
origin()	Option<Point>	Точка початку тексту
set_origin(point)	()	Задати початок тексту
rotation_degrees()	Option<f32>	Поворот у градусах
rotation_radians()	Option<f32>	Поворот у радіанах
set_rotation(degrees)	()	Задати кут повороту
is_rotated()	bool	Перевірити, чи текст повернуто
matrix()	Option<[f32; 6]>	Матриця трансформації
set_matrix(matrix)	()	Задати матрицю трансформації

Розширені приклади

Пошук і заміна на всіх сторінках

from pdf_oxide import PdfDocument

doc = PdfDocument("contract.pdf")

for i in range(doc.page_count()):
    page = doc.page(i)
    texts = page.find_text_containing("Acme Corp")
    for t in texts:
        page.set_text(t.id, "NewCo Inc.")
    doc.save_page(page)

doc.save("contract-updated.pdf")

use pdf_oxide::api::Pdf;

let mut doc = Pdf::open("contract.pdf")?;
let count = doc.page_count()?;

for i in 0..count {
    let mut page = doc.page(i)?;
    let texts = page.find_text_containing("Acme Corp");
    for t in &texts {
        page.set_text(t.id(), "NewCo Inc.")?;
    }
    doc.save_page(page)?;
}
doc.save("contract-updated.pdf")?;

Використання PageEditor (Rust)

PageEditor надає текучий API для пакетних операцій редагування.

use pdf_oxide::editor::DocumentEditor;

let mut editor = DocumentEditor::open("input.pdf")?;

editor.edit_page(0, |page| {
    let texts = page.find_text_containing("old");
    for t in &texts {
        page.set_text(t.id(), "new")?;
    }
    Ok(())
})?;

editor.save("output.pdf")?;

Або використовуйте PageEditor напряму для операцій над колекціями:

let mut editor = DocumentEditor::open("input.pdf")?;

let page = editor.page_editor(0)?
    .find_text_containing("price")?
    .for_each(|text| {
        let old = text.text().to_string();
        text.set_text(old.replace("$9.99", "$12.99"));
    })?
    .done()?;

editor.save_page_from_editor(page)?;
editor.save("output.pdf")?;

Додавання нового тексту на сторінку

page = doc.page(0)
text_id = page.add_text("CONFIDENTIAL", 100, 750, 24.0)
doc.save_page(page)
doc.save("stamped.pdf")

use pdf_oxide::elements::{FontSpec, TextContent, TextStyle};

let mut page = doc.page(0)?;
let content = TextContent {
    text: "CONFIDENTIAL".to_string(),
    bbox: pdf_oxide::geometry::Rect::new(100.0, 750.0, 200.0, 24.0),
    font: FontSpec {
        name: "Helvetica-Bold".to_string(),
        size: 24.0,
    },
    style: TextStyle::default(),
    reading_order: None,
    origin: None,
    rotation_degrees: None,
    matrix: None,
};
let id = page.add_text(content);
doc.save_page(page)?;

Видалення текстових елементів

page = doc.page(0)
for t in page.find_text_containing("DELETE ME"):
    page.remove_element(t.id)
doc.save_page(page)
doc.save("cleaned.pdf")

let mut page = doc.page(0)?;
let to_remove = page.find_text_containing("DELETE ME");
for t in &to_remove {
    page.remove_element(t.id());
}
doc.save_page(page)?;
doc.save("cleaned.pdf")?;

Збереження змінених сторінок

Після зміни тексту на сторінці потрібно викликати save_page(), щоб зберегти зміни. Без цього виклику зміни буде відкинуто.

page = doc.page(0)
page.set_text(text_id, "updated")
doc.save_page(page)   # Persist page changes
doc.save("output.pdf")  # Write to disk

let mut page = doc.page(0)?;
page.set_text(text_id, "updated")?;
doc.save_page(page)?;   // Persist page changes
doc.save("output.pdf")?;  // Write to disk

Пов’язані сторінки

• Огляд редагування – відкриття, метадані та процес збереження
• Операції зі сторінками – поворот, обрізання, об’єднання сторінок
• Редагування анотацій – додавання виділень, посилань і нотаток
• Маніпуляції із зображеннями – переміщення та зміна розміру зображень