telfax/docs/MULTILANG_COVER.md

Multi-Language Cover Page Generator

Supported Languages

• English - FACSIMILE
• Chinese - 傳真
• Japanese - FAX (表紙)
• Korean - 팩스
• German - FAX
• French - FAX
• Spanish - FAX
• Custom - User-defined language

Supported Image Formats

• PNG - Portable Network Graphics
• JPEG - Joint Photographic Experts Group
• TIFF - Tagged Image File Format
• BMP - Bitmap
• GIF - Graphics Interchange Format
• WebP - WebP Image Format

Features

Language Support

• Automatic font fallback for each language
• Language-specific labels and formatting
• Support for right-to-left languages (future)

Image Support

• Logo placement (header, corner, center)
• Background images with opacity control
• Watermark support
• Footer images

Layout Options

• Standard - Classic fax cover page
• Modern - Clean, minimalist design
• Classic - Traditional business style
• Minimal - Simple, text-focused
• Corporate - Professional with branding
• Custom - User-defined layout

Format Options

• A4 - 210mm x 297mm
• Letter - 8.5" x 11"
• Legal - 8.5" x 14"
• Custom - User-defined dimensions

Usage Examples

Example 1: Chinese Cover Page with Logo

use telfax::document::{CoverPageConfig, Language, ImageSource};

let config = CoverPageConfig::new(Language::Chinese)
    .with_logo("logo.png")
    .with_content(CoverContent {
        title: Some("公司傳真".to_string()),
        from: Some(FromInfo {
            name: "張三".to_string(),
            company: Some("測試公司".to_string()),
            department: Some("業務部".to_string()),
            phone: Some("02-12345678".to_string()),
            fax: Some("02-87654321".to_string()),
            email: Some("zhang@company.com".to_string()),
        }),
        to: Some(ToInfo {
            name: "李四".to_string(),
            company: Some("收件公司".to_string()),
            department: Some("採購部".to_string()),
            fax: "02-11112222".to_string(),
        }),
        subject: Some("業務合作提案".to_string()),
        message: Some("請參閱附件內容".to_string()),
        pages: Some(5),
        urgency: Some(Urgency::Urgent),
        ..Default::default()
    });

let cover_page = generate_cover_page_advanced(&config)?;

Example 2: Japanese Cover Page with Background

let config = CoverPageConfig::new(Language::Japanese)
    .with_background("background.jpg")
    .with_content(CoverContent {
        title: Some("FAX送付書".to_string()),
        from: Some(FromInfo {
            name: "田中太郎".to_string(),
            company: Some("テスト株式会社".to_string()),
            fax: Some("03-1234-5678".to_string()),
            ..Default::default()
        }),
        to: Some(ToInfo {
            name: "山田花子".to_string(),
            fax: "03-9876-5432".to_string(),
            ..Default::default()
        }),
        subject: Some("契約書の件".to_string()),
        urgency: Some(Urgency::VeryUrgent),
        ..Default::default()
    });

Example 3: English Cover Page with Watermark

let config = CoverPageConfig::new(Language::English)
    .with_logo("company_logo.png")
    .with_watermark(ImageSource::new("watermark.png")
        .with_position(50.0, 50.0)
        .with_opacity(0.1))
    .with_content(CoverContent {
        title: Some("FAX COVER SHEET".to_string()),
        from: Some(FromInfo {
            name: "John Smith".to_string(),
            company: Some("ACME Corporation".to_string()),
            email: Some("john.smith@acme.com".to_string()),
            ..Default::default()
        }),
        to: Some(ToInfo {
            name: "Jane Doe".to_string(),
            company: Some("XYZ Inc.".to_string()),
            fax: "+1-555-123-4567".to_string(),
            ..Default::default()
        }),
        subject: Some("Project Proposal".to_string()),
        message: Some("Please review the attached proposal.".to_string()),
        pages: Some(10),
        reference_number: Some("REF-2024-001".to_string()),
        urgency: Some(Urgency::ForYourInformation),
        ..Default::default()
    });

Example 4: Multi-Language Cover with All Features

use telfax::document::{
    CoverPageConfig, Language, CoverFormat, CoverLayout,
    ImageSource, ImageSize, Position
};

let config = CoverPageConfig::new(Language::German)
    .with_logo(ImageSource::new("logo.png")
        .with_position(5.0, 5.0)  // Top-left corner
        .with_size(200, 80)
        .with_opacity(0.9))
    .with_background(ImageSource::new("background.jpg")
        .with_opacity(0.15))
    .with_watermark(ImageSource::new("watermark.png")
        .with_position(50.0, 50.0)  // Center
        .with_opacity(0.08))
    .with_content(CoverContent {
        title: Some("FAX-DECKBLATT".to_string()),
        from: Some(FromInfo {
            name: "Hans Müller".to_string(),
            company: Some("Muster GmbH".to_string()),
            department: Some("Vertrieb".to_string()),
            phone: Some("+49 30 123456".to_string()),
            fax: Some("+49 30 123457".to_string()),
            email: Some("hans.mueller@muster.de".to_string()),
        }),
        to: Some(ToInfo {
            name: "Frau Schmidt".to_string(),
            company: Some("Beispiel AG".to_string()),
            fax: "+49 89 987654".to_string(),
            ..Default::default()
        }),
        subject: Some("Angebot Nr. 2024-123".to_string()),
        message: Some("Sehr geehrte Frau Schmidt,\n\nanbei erhalten Sie unser Angebot.".to_string()),
        pages: Some(3),
        reference_number: Some("AN-2024-123".to_string()),
        date: Some("2024-01-15".to_string()),
        urgency: Some(Urgency::PleaseReply),
        ..Default::default()
    });

API Endpoints

Generate Cover Page (Legacy)

POST /api/v1/fax/cover
Content-Type: application/json

{
  "to": "John Smith",
  "from": "Jane Doe",
  "subject": "Meeting Notes",
  "notes": "Please review before the meeting.",
  "total_pages": 5
}

Generate Multi-Language Cover Page

POST /api/v1/fax/cover/advanced
Content-Type: application/json

{
  "language": "chinese",
  "format": "a4",
  "layout": "standard",
  "fonts": {
    "title": 72,
    "heading": 44,
    "body": 44,
    "small": 36
  },
  "images": {
    "logo": {
      "path": "/path/to/logo.png",
      "position": {"x": 5, "y": 5},
      "size": {"width": 200, "height": 80},
      "opacity": 0.9
    },
    "background": {
      "path": "/path/to/background.jpg",
      "opacity": 0.15
    }
  },
  "content": {
    "title": "公司傳真",
    "from": {
      "name": "張三",
      "company": "測試公司",
      "department": "業務部",
      "phone": "02-12345678",
      "fax": "02-87654321"
    },
    "to": {
      "name": "李四",
      "company": "收件公司",
      "fax": "02-11112222"
    },
    "subject": "業務合作提案",
    "message": "請參閱附件內容",
    "pages": 5,
    "urgency": "urgent"
  }
}

Font Requirements

English/Western Languages

• Helvetica
• Arial

Chinese

• PingFang TC (Traditional Chinese)
• STHeiti Medium
• Arial Unicode (fallback)

Japanese

• Hiragino Sans
• Yu Gothic
• Meiryo
• Arial Unicode (fallback)

Korean

• Apple SD Gothic Neo
• Malgun Gothic
• Arial Unicode (fallback)

File Structure

telfax/
├── scripts/
│   └── cover_multilang.py    # Multi-language cover page generator
├── src/
│   └── document/
│       ├── cover.rs          # Rust wrapper functions
│       └── cover_config.rs   # Configuration types
└── docs/
    └── MULTILANG_COVER.md    # This documentation

Testing

# Test Chinese cover page
curl -X POST http://localhost:3000/api/v1/fax/cover/advanced \
  -H "Content-Type: application/json" \
  -d @examples/chinese_cover.json

# Test Japanese cover page
curl -X POST http://localhost:3000/api/v1/fax/cover/advanced \
  -H "Content-Type: application/json" \
  -d @examples/japanese_cover.json

# Test with images
curl -X POST http://localhost:3000/api/v1/fax/cover/advanced \
  -H "Content-Type: application/json" \
  -d @examples/cover_with_logo.json

Performance

• Cover Generation Time: ~200-500ms (depends on image complexity)
• Supported Resolutions: 204x196 dpi (standard fax), 300 dpi, 600 dpi
• File Formats: Output as TIFF (fax-ready)
• Font Rendering: High-quality anti-aliased text

Future Enhancements

• Right-to-left language support (Arabic, Hebrew)
• Custom font file upload
• Template system
• QR code generation
• Digital signature support
• PDF output option