feat: added a font abstraction layer for ttf fonts

Author: jorgedanisc

Cargo.lock

@@ -23,6 +23,7 @@ path = "src/lib.rs"
 jpeg-decoder = "0.3.2"
 miniz_oxide = "0.8.9"
 png = "0.18.0"
+ttf-parser = { version = "0.20", features = ["variable-fonts"] }
 
 # Target-specific configuration to ensure correct behavior without consumer-side feature flags
 # For non-WASM targets, use lopdf with its default native features

Cargo.toml

@@ -9,4 +9,4 @@ fn main() {
 
     // This ensures that the build script is re-run when the target changes
     println!("cargo:rerun-if-env-changed=TARGET");
-}
+}

build.rs

@@ -3,8 +3,11 @@
 //! This example demonstrates the core functionality of the library
 //! including PDF creation, OCG layers, and image embedding.
 
-use hipdf::ocg::{OCGManager, Layer};
-use hipdf::lopdf::{Document, content::{Content, Operation}, dictionary};
+use hipdf::lopdf::{
+    content::{Content, Operation},
+    dictionary, Document,
+};
+use hipdf::ocg::{Layer, OCGManager};
 
 fn main() -> Result<(), Box<dyn std::error::Error>> {
     println!("🚀 Creating basic PDF with hipdf...");
@@ -34,12 +37,15 @@ fn main() -> Result<(), Box<dyn std::error::Error>> {
     // Add some text content
     operations.extend(vec![
         Operation::new("BT", vec![]),
-        Operation::new("Tf", vec![
-            hipdf::lopdf::Object::Name(b"F1".to_vec()),
-            12.into()
-        ]),
+        Operation::new(
+            "Tf",
+            vec![hipdf::lopdf::Object::Name(b"F1".to_vec()), 12.into()],
+        ),
         Operation::new("Td", vec![50.into(), 750.into()]),
-        Operation::new("Tj", vec![hipdf::lopdf::Object::string_literal("Hello from hipdf!")]),
+        Operation::new(
+            "Tj",
+            vec![hipdf::lopdf::Object::string_literal("Hello from hipdf!")],
+        ),
         Operation::new("ET", vec![]),
     ]);
 
@@ -81,7 +87,8 @@ fn main() -> Result<(), Box<dyn std::error::Error>> {
         "Pages" => hipdf::lopdf::Object::Reference(pages_id),
     });
 
-    doc.trailer.set("Root", hipdf::lopdf::Object::Reference(catalog_id));
+    doc.trailer
+        .set("Root", hipdf::lopdf::Object::Reference(catalog_id));
 
     // Save the document
     let output_path = "examples/basic_example.pdf";
@@ -96,4 +103,4 @@ fn main() -> Result<(), Box<dyn std::error::Error>> {
     println!("   • Document structure");
 
     Ok(())
-}
+}

examples/basic_usage.rs

@@ -1,89 +1,91 @@
-use hipdf::lopdf::{Document, dictionary, Object, Stream, content::Content};
-use hipdf::embed_pdf::{PdfEmbedder, EmbedOptions, MultiPageLayout, PageRange, GridFillOrder};
+use hipdf::embed_pdf::{EmbedOptions, GridFillOrder, MultiPageLayout, PageRange, PdfEmbedder};
+use hipdf::lopdf::{content::Content, dictionary, Document, Object, Stream};
 use std::collections::HashMap;
 
 fn embed_pdf_example() -> Result<(), Box<dyn std::error::Error>> {
     // Create a new PDF document
     let mut doc = Document::with_version("1.5");
-    
+
     // Initialize the PDF embedder
     let mut embedder = PdfEmbedder::new();
-    
+
     // Load the source PDF you want to embed
     let source_pdf = embedder.load_pdf("source_document.pdf")?;
-    
+
     // Example 1: Simple single page embedding
     let single_page_options = EmbedOptions::new()
-        .at_position(50.0, 700.0)          // x, y position
-        .with_max_size(200.0, 200.0)       // max width, height
+        .at_position(50.0, 700.0) // x, y position
+        .with_max_size(200.0, 200.0) // max width, height
         .with_page_range(PageRange::Single(0)); // embed first page only
-    
+
     // Example 2: Grid layout with multiple pages
     let grid_options = EmbedOptions::new()
         .at_position(50.0, 400.0)
-        .with_max_size(100.0, 120.0)       // size per page
+        .with_max_size(100.0, 120.0) // size per page
         .with_layout(MultiPageLayout::Grid {
             columns: 3,
             gap_x: 10.0,
             gap_y: 15.0,
             fill_order: GridFillOrder::RowFirst,
         })
         .with_page_range(PageRange::Range(0, 5)); // first 6 pages
-    
+
     // Example 3: Horizontal layout with scaling
     let horizontal_options = EmbedOptions::new()
         .at_position(50.0, 200.0)
-        .with_scale(0.2)                   // 20% of original size
+        .with_scale(0.2) // 20% of original size
         .with_layout(MultiPageLayout::Horizontal { gap: 20.0 })
         .with_page_range(PageRange::Pages(vec![0, 2, 4])); // specific pages
-    
+
     // Example 4: Custom rotation and positioning
     let rotated_options = EmbedOptions::new()
         .at_position(300.0, 500.0)
         .with_scale(0.15)
-        .with_rotation(45.0)               // 45 degree rotation
+        .with_rotation(45.0) // 45 degree rotation
         .with_layout(MultiPageLayout::FirstPageOnly);
-    
+
     // Set up document structure
     let pages_id = doc.add_object(dictionary! {
         "Type" => "Pages",
         "Count" => 1,
     });
-    
+
     let mut page_ops = Vec::new();
     let mut all_xobjects = HashMap::new();
-    
+
     // Embed the PDFs and collect operations
     let result = embedder.embed_pdf(&mut doc, &source_pdf, &single_page_options)?;
     page_ops.extend(result.operations);
     all_xobjects.extend(result.xobject_resources);
-    
+
     let result = embedder.embed_pdf(&mut doc, &source_pdf, &grid_options)?;
     page_ops.extend(result.operations);
     all_xobjects.extend(result.xobject_resources);
-    
+
     let result = embedder.embed_pdf(&mut doc, &source_pdf, &horizontal_options)?;
     page_ops.extend(result.operations);
     all_xobjects.extend(result.xobject_resources);
-    
+
     let result = embedder.embed_pdf(&mut doc, &source_pdf, &rotated_options)?;
     page_ops.extend(result.operations);
     all_xobjects.extend(result.xobject_resources);
-    
+
     // Create page content and resources
-    let content = Content { operations: page_ops };
+    let content = Content {
+        operations: page_ops,
+    };
     let content_stream = Stream::new(dictionary! {}, content.encode()?);
     let content_id = doc.add_object(content_stream);
-    
+
     let mut xobject_dict = lopdf::Dictionary::new();
     for (name, obj_ref) in all_xobjects {
         xobject_dict.set(name, obj_ref);
     }
-    
+
     let page_resources = dictionary! {
         "XObject" => xobject_dict,
     };
-    
+
     // Create the page
     let page_id = doc.add_object(dictionary! {
         "Type" => "Page",
@@ -92,25 +94,26 @@ fn embed_pdf_example() -> Result<(), Box<dyn std::error::Error>> {
         "Contents" => content_id,
         "Resources" => page_resources,
     });
-    
+
     // Finalize document structure
-    let pages_dict = doc.get_object_mut(pages_id)
+    let pages_dict = doc
+        .get_object_mut(pages_id)
         .and_then(Object::as_dict_mut)
         .unwrap();
     pages_dict.set("Kids", vec![Object::Reference(page_id)]);
-    
+
     let catalog_id = doc.add_object(dictionary! {
         "Type" => "Catalog",
         "Pages" => Object::Reference(pages_id),
     });
     doc.trailer.set("Root", Object::Reference(catalog_id));
-    
+
     // Save the resulting PDF
     doc.save("output_with_embedded_pdfs.pdf")?;
-    
+
     Ok(())
 }
 
 fn main() -> Result<(), Box<dyn std::error::Error>> {
     embed_pdf_example()
-}
+}