Download the PHP package tecnickcom/tc-lib-pdf-image without Composer
On this page you can find all versions of the php package tecnickcom/tc-lib-pdf-image. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download tecnickcom/tc-lib-pdf-image
More information about tecnickcom/tc-lib-pdf-image
Files in tecnickcom/tc-lib-pdf-image
Package tc-lib-pdf-image
Short Description PHP library containing PDF Image methods
License LGPL-3.0-or-later
Homepage https://tcpdf.org
Informations about the package tc-lib-pdf-image
tc-lib-pdf-image
Image import and embedding utilities for PDF streams.
💖 Part of the tc-lib-pdf / TCPDF ecosystem (100M+ installs). Sponsor its maintenance →
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.
| Namespace | \Com\Tecnick\Pdf\Image |
| Author | Nicola Asuni [email protected] |
| License | GNU LGPL v3 - see LICENSE |
| API docs | https://tcpdf.org/docs/srcdoc/tc-lib-pdf-image |
| Packagist | https://packagist.org/packages/tecnickcom/tc-lib-pdf-image |
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
Quick Start
You can configure the \Com\Tecnick\File\File helper with host/path allowlists:
For full file-loading options, see the tc-lib-file documentation:
https://tcpdf.org/docs/srcdoc/tc-lib-file
Persistent image cache
Processing an image (decode, resize, re-encode, alpha-mask extraction) is the
expensive part of importing. By default the result is cached in memory for the
lifetime of the Import instance, so reusing the same image within one
document is cheap.
To reuse processed images across documents and processes (e.g. brand assets
reused on thousands of PDFs), inject an optional external cache. The library
ships only the contract — \Com\Tecnick\Pdf\Image\ImageCacheInterface — and you
provide the backend (filesystem, APCu, Redis, a PSR-16 cache, ...):
Pass an implementation to the constructor (default null keeps the current
in-memory-only behaviour):
On a miss the processed data is written through to the cache; on a later run a hit short-circuits all processing. For local files the persistent key folds in the file modification time and size, so editing an image in place invalidates its stale entry automatically.
Security: the cache store is a trust boundary. Stored bytes (image data, palette, ICC profile) are embedded verbatim into generated PDFs, so use a store only your application can write to. If your implementation serializes entries, deserialize with object restoration disabled, e.g.
unserialize($s, ['allowed_classes' => false]).
A minimal example implementation:
Development
Packaging
For system packages, bootstrap with:
Contributing
Contributions are welcome. Please review SECURITY.md.
All versions of tc-lib-pdf-image with dependencies
ext-gd Version *
ext-zlib Version *
tecnickcom/tc-lib-file Version ^3.7
tecnickcom/tc-lib-color Version ^2.13
tecnickcom/tc-lib-pdf-encrypt Version ^2.9