README

Geometric drawing and transformation primitives for PDF content streams.

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

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.

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.2 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 - info@tecnick.com