README

Image import and embedding utilities for PDF streams.

If this project is useful to you, please consider supporting development via GitHub Sponsors.

Overview

tc-lib-pdf-image handles image import, conversion, and output structures used by PDF generators.

The library isolates image pipeline concerns such as format handling, normalization, and object generation for PDF embedding. Keeping this logic separate helps reduce complexity in document-level code and makes image behavior easier to validate and maintain.

Features

Import Support

• Native handling for PNG and JPEG
• Additional format handling through GD processing paths
• Transparency and palette-related metadata handling

PDF Integration

• Image caching keys for repeated assets
• Alternate image support for print/display contexts
• Output helpers for embedding image objects

Requirements

• PHP 8.2 or later
• Extensions: gd, zlib
• Composer

Installation

composer require tecnickcom/tc-lib-pdf-image

Quick Start

<?php

require_once __DIR__ . '/vendor/autoload.php';

$img = new \Com\Tecnick\Pdf\Image\Import();
$imageId = $img->add('/path/to/image.png');

var_dump($imageId);

Development

make deps
make help
make qa

Packaging

make rpm
make deb

For system packages, bootstrap with:

require_once '/usr/share/php/Com/Tecnick/Pdf/Image/autoload.php';

Contributing

Contributions are welcome. Please review CONTRIBUTING.md, CODE_OF_CONDUCT.md, and SECURITY.md.

Contact

Nicola Asuni - info@tecnick.com