---

Certificate Maker

A high-performance Rust-based utility for automated certificate generation. This tool enables the creation of personalized documents by overlaying data from CSV sources onto PNG/JPG templates with precise control over typography, color, and positioning.

Features

• PNG Metadata Analysis: Inspect image dimensions, color profiles, and technical properties.
• Dynamic Text Overlay: Interactive placement of text with support for custom fonts and RGBA color selection.
• High-Volume Batch Processing: Generate hundreds of individual certificates from CSV datasets using parallel processing.
• Automated Directory Management: Built-in file system organization to manage templates, assets, and outputs efficiently.
• Advanced Font Support: Compatible with TTF, OTF, WOFF, and WOFF2 formats via the assets directory.
• Integrated Debugging Suite: Specialized tools for validating CSV formatting, template integrity, and font accessibility.

System Architecture

The following diagram illustrates the relationship between the CLI menu system, the core processing modules, and the required file structure.

graph TB
    %% Main Entry
    CLI[main.rs<br/>Menu System]
    
    %% Menu Options
    subgraph Menu[Key Options]
        M1[Single Image Text]
        M2[Batch Certificates]
        M3[PNG Analysis]
        M4[Debug Tools]
    end
    
    %% Core Modules
    subgraph Modules[Core Modules]
        Edit[editpng.rs<br/>Text Rendering<br/>Font & Color Control]
        CSV[csvexcelparser.rs<br/>CSV Data Ingestion<br/>Parallel Processing]
        Analysis[analysis.rs<br/>Technical Analysis<br/>Coordinate Calculator]
    end
    
    %% Directories
    subgraph Dirs[File Structure]
        Template[Folder: Template/<br/>PNG/JPG templates]
        Excel[Folder: excelcsvs/<br/>CSV name lists]
        Assets[Folder: assets/<br/>Font files]
        Output[Folder: output/<br/>Generated files]
    end
    
    %% Dependencies
    Deps[Dependencies<br/>image, imageproc, csv<br/>rayon, rusttype]
    
    %% Connections
    CLI --> Menu
    Menu --> Modules
    Dirs --> Modules
    Deps --> Modules
    
    %% Styling
    style CLI stroke:#333,stroke-width:2px
    style Menu stroke:#666,stroke-dasharray: 5 5
    style Modules fill:#f9f9f9,stroke:#333,stroke-width:2px
    style Dirs fill:#fff,stroke:#333

Loading

System Requirements

• Rust Toolchain: Latest stable version of Rust and Cargo.
• Assets:
  • Image templates (PNG/JPG format).
  • Dataset (CSV files with a defined "Name" column).
  • Typography (TTF/OTF font files).

Installation

1. Clone the Repository:

   git clone https://github.com/Not-Buddy/CertificateMakerRust.git
   cd CertificateMaker

2. Initialize Directory Structure:

   mkdir -p excelcsvs Template assets certificates output

3. Populate Asset Directories:

   • Place image templates in /Template
   • Place CSV data in /excelcsvs
   • Place font files in /assets

4. Build and Execute:

   cargo run

Project Structure

CertificateMaker/
├── src/
│   ├── main.rs            # Entry point and menu interface
│   ├── analysis.rs        # Image metadata and coordinate calculations
│   ├── editpng.rs         # Rendering engine and text overlay logic
│   └── csvexcelparser.rs  # Data ingestion and batch processing logic
├── excelcsvs/             # Source data (CSV)
├── Template/              # Design templates (PNG/JPG)
├── assets/                # Typography (TTF/OTF)
├── certificates/          # Batch generation output
└── output/                # Single-file test output

Usage

Menu Navigation

Upon execution, the application provides a numbered interface for the following operations:

1. Single Image Overlay: Add text to a single template for testing or one-off documents.
2. Batch Generation: Process a full CSV list to generate multiple certificates.
3. Technical Analysis: Retrieve resolution and suggested coordinate data for a template.
4. Data Tools: Create sample CSVs or debug existing file formatting issues.

Dataset Configuration

The CSV parser expects a "Name" header (case-insensitive). Example Names.csv:

Name
Alice Johnson
Bob Smith
Charlie Brown

Configuration Options

• Positioning: Supports manual X/Y coordinate input or automatic horizontal centering.
• Color Syntax: Accepts Hexadecimal codes (e.g., #FF0000) or standard color names (e.g., white, blue).
• Rendering: Leverages imageproc and rusttype for high-quality text rasterization.

Dependencies

The project utilizes the following core crates:

• image: Image processing and encoding.
• imageproc: Text drawing and geometric transformations.
• rusttype: Font loading and glyph positioning.
• csv & serde: Data serialization and parsing.
• rayon: For parallelizing batch generation.

Troubleshooting

Issue	Resolution
Directory Not Found	Ensure the required folder structure exists in the project root.
CSV Parsing Failure	Verify the "Name" header exists and the file is comma-delimited.
Font Errors	Confirm the file extension is supported (TTF/OTF) and located in /assets.
Coordinate Clipping	Use the "Analyze PNG" tool to verify image dimensions relative to your X/Y inputs.

License

This project is licensed under the MIT License. See the LICENSE file for full details.