README

A PHP class for managing paper formats and their conversions.

Installation

composer require ycdev/paper-size

Supported Paper Formats

ISO Formats

B Series (ISO)

C Series (ISO)

US Formats

French Formats (AFNOR)

Japanese Formats (JIS P 0138)

ID Formats (ISO/CEI 7810)

Usage

Available Paper Formats

The class includes the following standard formats:

• ISO formats (A0-A10, B0-B10, C0-C10)
• US formats (Letter, Executive, Government Letter, Quarto, etc.)
• French AFNOR formats (Cloche, Raisin, Jésus, Grand Aigle, etc.)
• Japanese JIS formats (JB0-JB12, Shiroku Ban, Kiku)
• ID formats ISO/CEI 7810 (ID-000, ID-1, ID-2, ID-3)

Usage Examples

Unit Conversion

use Ycdev\PaperSize;

// Get A4 dimensions in pixels (default 300 DPI)
$dimensions = PaperSize::px(PaperSize::A4);
// Result: [2480, 3508]

// Get A4 dimensions in centimeters
$dimensions = PaperSize::cm(PaperSize::A4);
// Result: [21.0, 29.7]

// Get A4 dimensions in inches
$dimensions = PaperSize::in(PaperSize::A4);
// Result: [8.27, 11.69]

Creating a GD Image

use Ycdev\PaperSize;

// Create a GD image with A4 dimensions
$image = PaperSize::gdImage(PaperSize::A4);

Calculating Aspect Ratio

use Ycdev\PaperSize;

// Get the aspect ratio of A4 format
$ratio = PaperSize::ratio(PaperSize::A4);
// Result: 1.4142

Landscape Mode

use Ycdev\PaperSize;

// Convert A4 format to landscape
$landscape = PaperSize::landscape(PaperSize::A4);
// Result: [297, 210]

List All Available Formats

use Ycdev\PaperSize;

// Get all available formats
$formats = PaperSize::allFormats();
// Returns an associative array:
// [
//     'A4' => ['width' => 210, 'height' => 297, 'name' => 'A4'],
//     'FR_RAISIN' => ['width' => 500, 'height' => 650, 'name' => 'Fr raisin'],
//     ...
// ]

// Example: populate a <select>
foreach (PaperSize::allFormats() as $key => $format) {
    echo "<option value=\"$key\">{$format['name']} ({$format['width']}x{$format['height']}mm)</option>";
}

Breaking change : allFormats() retourne désormais un tableau associatif avec les clés width, height et name au lieu d'un tableau indexé [width, height, name].

Detect Format from Pixel Dimensions

use Ycdev\PaperSize;

// Detect paper format from pixel dimensions
$format = PaperSize::format(2480, 3507);
// Result: 'A4'

// Works in landscape too
$format = PaperSize::format(3507, 2480);
// Result: 'A4'

// Returns false if no match
$format = PaperSize::format(1, 1);
// Result: false

Crop a GD Image

use Ycdev\PaperSize;

$image = PaperSize::gdImage(PaperSize::A4);
$cropped = PaperSize::crop($image, PaperSize::A5);

Supported Units

• px (pixels)
• mm (millimeters)
• cm (centimeters)
• m (meters)
• in (inches)

Resolution

The default resolution for pixel conversions is 300 DPI. You can modify it when calling the methods:

use Ycdev\PaperSize;

// Convert to pixels with 600 DPI resolution
$dimensions = PaperSize::px(PaperSize::A4, 600);

License

GPL V3