tecnickcom/tc-lib-pdf-graph

PHP library containing PDF graphic and geometric methods

2.4.18 2026-04-20 07:17 UTC

Requires

• php: >=8.1
• ext-zlib: *
• tecnickcom/tc-lib-color: ^2.3
• tecnickcom/tc-lib-pdf-encrypt: ^2.1

Requires (Dev)

• pdepend/pdepend: ^2.16
• phpcompatibility/php-compatibility: ^10.0.0@dev
• phpmd/phpmd: ^2.15
• phpunit/phpunit: ^13.1 || ^12.5 || ^11.5 || ^10.5
• squizlabs/php_codesniffer: ^4.0

LGPL-3.0-or-later

• Nicola Asuni

• geometry
• pdf
• transformation
• graphic
• tc-lib-pdf-graph

README

Geometric drawing and transformation primitives for PDF content streams.

If this library helps your rendering stack, please consider supporting development via PayPal.

Overview

tc-lib-pdf-graph implements low-level drawing operations used to build PDF graphic content.

It exposes the primitives needed to compose paths and painting operations while keeping the API close to PDF graphics operators. This makes it suitable as a foundation layer for charting, vector drawing, and custom layout engines.

Namespace	\Com\Tecnick\Pdf\Graph
Author	Nicola Asuni [e-mail]
License	GNU LGPL v3 - see LICENSE
API docs	https://tcpdf.org/docs/srcdoc/tc-lib-pdf-graph
Packagist	https://packagist.org/packages/tecnickcom/tc-lib-pdf-graph

Features

Drawing Primitives

• Paths, lines, curves, and clipping operations
• Style handling for stroke/fill combinations
• Gradient and shading support

Transformations

• Matrix-based geometric transforms
• Coordinate conversion helpers
• PDF/A-aware behavior controls

Requirements

• PHP 8.1 or later
• Extension: zlib
• Composer

Installation

composer require tecnickcom/tc-lib-pdf-graph

Quick Start

<?php

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

$draw = new \Com\Tecnick\Pdf\Graph\Draw(
    1.0,
    210,
    297,
    new \Com\Tecnick\Color\Pdf(),
    new \Com\Tecnick\Pdf\Encrypt\Encrypt(),
    false
);

echo $draw->getClippingRect(10, 10, 50, 20);

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/Graph/autoload.php';

Contributing

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

Contact

Nicola Asuni - [e-mail]