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

• Documentation
• Repository
• Issues

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