erlaube papersize setting

[skerbis]

Flexibles Paper-Format für PDFs

Diese Änderung ermöglicht es, das Papierformat und die Orientierung für PDFs flexibler zu setzen, während die bisherigen Standardwerte (A4, portrait) erhalten bleiben.

Änderungen

• Neue Property $paperSize für das Papierformat
• Neue Methode setPaperSize() zum Setzen von Format und Orientierung
• Bisherige Standardwerte (A4, portrait) bleiben erhalten
• Unterstützung für Standard-Formate und benutzerdefinierte Größen

Beispiele

// Bisherige Verwendung bleibt unverändert - nutzt A4 im Hochformat
$pdf = new PdfOut();
$pdf
    ->setHtml($html)
    ->run();

// Neues Format setzen - z.B. US Letter im Querformat
$pdf = new PdfOut();
$pdf
    ->setPaperSize('letter', 'landscape')
    ->setHtml($html)
    ->run();

// Benutzerdefinierte Größe (z.B. für Visitenkarten)
$pdf = new PdfOut();
$pdf
    ->setPaperSize([0, 0, 252, 144]) // 3.5x2 Zoll in Punkten (72 Punkte pro Zoll)
    ->setHtml($html)
    ->run();

// Komplexeres Beispiel mit mehreren Optionen
$pdf = new PdfOut();
$pdf
    ->setName('visitenkarte')
    ->setPaperSize([0, 0, 252, 144])
    ->setDpi(300) // Hohe Auflösung für Druck
    ->setFont('Helvetica')
    ->setHtml($html)
    ->setSaveToPath('/path/to/save/')
    ->run();

Unterstützte Papierformate

Die Methode unterstützt alle von Dompdf unterstützten Formate:

• Standard-Formate: 'letter', 'legal', 'A4', 'A3', etc.
• Benutzerdefinierte Größen als Array: [left, top, right, bottom] in Punkten
• Orientierung: 'portrait' oder 'landscape'

Warum ist diese Änderung wichtig?

1. Flexibilität: Ermöglicht die Erstellung von PDFs in verschiedenen Formaten ohne die Standardfunktionalität zu ändern
2. Rückwärtskompatibilität: Bestehender Code funktioniert weiterhin wie gewohnt
3. Bessere API: Klare, dedizierte Methode zum Setzen des Formats
4. Spezielle Formate: Unterstützt Sonderformate wie Visitenkarten, Etiketten etc.

Breaking Changes

Keine. Alle bestehenden Implementierungen funktionieren weiterhin wie bisher.

[elricco]

Sehr gut