TCPDF

# TCPDF (DEPRECATED → use [tc-lib-pdf](https://github.com/tecnickcom/tc-lib-pdf))

> [!WARNING]
> **TCPDF is in maintenance-only mode.** Active development has moved to
> **[tc-lib-pdf](https://github.com/tecnickcom/tc-lib-pdf)**, its modern, modular successor —
> new projects should start there.
>
> TCPDF is still installed 100M+ times across 500+ PHP packages. If your product depends on
> it, **[sponsor continued maintenance →](https://github.com/sponsors/tecnickcom)** to keep
> this shared infrastructure secure and patched.

[![Sponsor on GitHub](https://img.shields.io/badge/sponsor-github-EA4AAA.svg?logo=githubsponsors&logoColor=white)](https://github.com/sponsors/tecnickcom)

[![Latest Stable Version](https://poser.pugx.org/tecnickcom/tcpdf/version)](https://packagist.org/packages/tecnickcom/tcpdf)
[![License](https://poser.pugx.org/tecnickcom/tcpdf/license)](https://packagist.org/packages/tecnickcom/tcpdf)
[![Downloads](https://poser.pugx.org/tecnickcom/tcpdf/downloads)](https://packagist.org/packages/tecnickcom/tcpdf)

---

## Overview

TCPDF is a pure-PHP library for generating PDF documents and barcodes directly in application code.

It has been widely used across many PHP stacks and still provides a complete feature set for text rendering, page composition, graphics, signatures, forms, and standards-oriented output.

| | |
|---|---|
| **Package** | `tecnickcom/tcpdf` |
| **Author** | Nicola Asuni <info@tecnick.com> |
| **License** | [GNU LGPL v3](https://www.gnu.org/copyleft/lesser.html) (see [LICENSE.TXT](LICENSE.TXT)) |
| **Website** | <http://www.tcpdf.org> |
| **Source** | <https://github.com/tecnickcom/TCPDF> |

---

## Architecture: Compatibility Facade over tc-lib-pdf

Starting with version 7, the `TCPDF` class no longer contains its own PDF engine.
It is a **compatibility facade**: every public TCPDF method is a thin wrapper that
delegates the actual PDF generation to the modern `tecnickcom/tc-lib-pdf` engine
(`\Com\Tecnick\Pdf\Tcpdf`), while a small internal state layer reproduces the legacy
stateful cursor and page model (current X/Y, margins, fonts, colors, automatic page
breaks, headers/footers).

What this means in practice:

- **The public API is (mostly) unchanged.** All 291 public method signatures (names, parameters,
  defaults) are identical to legacy TCPDF; existing integrations keep calling `new TCPDF(...)`,
  `AddPage()`, `SetFont()`, `Cell()`, `writeHTML()`, `Output()` exactly as before. One method is
  new: `getPDFFilename()` returns the file name `Output()` used, which the engine sanitizes.
- **Rendering is done by the modern engine.** Text layout, HTML/CSS, fonts, graphics,
  barcodes, encryption, signatures and output generation come from the `tc-lib-*` libraries.
- **Per-method delegation status is documented.** See [MAPPING.md](MAPPING.md) for the
  status of every public method (`delegated`, `adapter`, `shim`, `intentional-noop`,
  `blocked`) with notes; the table is machine-verified against the class.
- **O