PDF Converter

A simple and efficient Rust library for converting images to PDF documents with support for multiple formats and commercial use.

✨ Features

🖼️ Multi-format Support: JPG, PNG, GIF, BMP, WebP
📄 Single & Batch Conversion: Convert individual files or entire folders
📐 Smart A4 Fitting: Automatic scaling with proper margins
⚙️ Configurable: Custom DPI, margins, page size, document title
🚀 Performance Optimized: Memory-efficient processing
💼 Commercial Friendly: MIT/Apache-2.0 dual license
🛠️ Production Ready: Comprehensive error handling and testing

🚀 Quick Start

Add to your Cargo.toml:

[dependencies]

pdf-converter = "0.1.0"

Basic Usage

use pdf_converter::PdfConverter;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let converter = PdfConverter::new();
    
    // Convert a single image
    converter.convert_image_to_pdf("image.jpg", "output.pdf")?;
    
    // Convert entire folder to single PDF
    converter.convert_folder_to_pdf("images/", "batch_output.pdf")?;
    
    Ok(())
}

Advanced Configuration

use pdf_converter::{PdfConverter, PdfConfig};

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let config = PdfConfig {
        dpi: 300.0,
        margin_mm: 20.0,
        title: Some("My Document".to_string()),
    };
    
    let converter = PdfConverter::with_config(config);
    converter.convert_folder_to_pdf("images/", "high_quality.pdf")?;
    
    Ok(())
}

📊 Performance

Single image: ~1 second
Batch (4 images): ~6 seconds
Memory: Optimized for large files
Quality: 100-300 DPI support

🧪 Testing

Run the comprehensive test suite:

cargo run --bin comprehensive_test

Or quick validation:

cargo run --bin quick_test

📁 Project Structure

src/
├── lib.rs          # Public API
├── converter.rs    # Core conversion logic
└── error.rs        # Error handling
examples/
├── basic_usage.rs  # Simple example
└── batch_convert.rs # Batch processing

💼 Commercial Use

This project is 100% commercial-friendly:

✅ Use in proprietary software
✅ Sell products containing this code
✅ No copyleft restrictions
✅ Modify and redistribute
✅ Patent protection (Apache-2.0)

Perfect for:

Commercial applications
SaaS products
Enterprise software
Consulting projects
Proprietary systems

📄 License

Dual licensed under your choice of:

MIT License - Simple and permissive
Apache License 2.0 - Includes patent protection

See LICENSE-MIT and LICENSE-APACHE for details.

👤 Author

topki
📧 Email: 259901434@qq.com

🤝 Contributing

Contributions are welcome! This project is designed for easy contribution with:

Clear module separation
Comprehensive error handling
Extensive test coverage
Good documentation

🔗 Links

Made with ❤️ by topki • Commercial use permitted • Production ready

pdf-converter 0.1.0