tc-lib-pdf (TCPDF) on TCPDF

Colour Notations

Sun, 20 Sep 2026 00:00:00 +0000

getColorObj() turns a string into a colour model object. It accepts hexadecimal codes, CSS colour names, seven colour functions and the Acrobat JavaScript array forms. The notation selects the model: rgb() returns an Rgb, lab() returns a Lab.

An unrecognised string raises \Com\Tecnick\Color\Exception. tryGetColorObj() runs the same parser and returns null instead of raising.

Hexadecimal

Three, four, six or eight digits, with or without the leading #. Three and four digit forms expand by doubling each digit, and the fourth pair is alpha.

Rendering Options

Sun, 20 Sep 2026 00:00:00 +0000

getBarcodeObj() takes the same six arguments for all 73 symbologies. This page covers them once; the per-type pages give the payload rules and leave the geometry here.

$bobj = $barcode->getBarcodeObj(
 type: 'C128',
 code: 'TCPDF',
 width: -2,
 height: -30,
 color: 'black',
 padding: [0, 0, 0, 0],
);

Width and Height

The sign decides the unit.

A positive value is a total measurement in user units, and the symbol is scaled to fit it. This is the form to use when the space on the label is fixed:

Colour Models

Sun, 20 Sep 2026 00:00:00 +0000

A parsed colour is an object of one of five classes. All five extend \Com\Tecnick\Color\Model and implement \Com\Tecnick\Color\Model\Template, so any of them exposes the same set of methods.

Below, each model holds #336699.

Model	Enum case	`getCssColor()`	`getPdfColor()`	`getJsPdfColor()`
GRAY	`ColorModelType::Gray`	`g(95)`	`0.371920 g`	`["G",0.371920]`
RGB	`ColorModelType::Rgb`	`rgb(51,102,153)`	`0.200000 0.400000 0.600000 rg`	`["RGB",0.200000,0.400000,0.600000]`
HSL	`ColorModelType::Hsl`	`hsl(210,50%,40%)`	`0.200000 0.400000 0.600000 rg`	`["RGB",0.200000,0.400000,0.600000]`
CMYK	`ColorModelType::Cmyk`	`cmyk(66.6667%,33.3333%,0%,40%)`	`0.666667 0.333333 0.000000 0.400000 k`	`["CMYK",0.666667,0.333333,0.000000,0.400000]`
LAB	`ColorModelType::Lab`	`lab(42.0081% -0.1517 -32.846)`	`0.200000 0.400000 0.600000 rg`	`["RGB",0.200000,0.400000,0.600000]`

PDF defines device colour spaces for grayscale, RGB and CMYK. HSL and Lab convert to DeviceRGB on output, so three rows of that table repeat.

Output Formats

Sun, 20 Sep 2026 00:00:00 +0000

Encoding and rendering are separate steps. getBarcodeObj() returns an object holding the encoded grid, and the methods below turn that grid into whatever the target needs. Every one of them works for all 73 symbologies.

One object is built here and reused by every example on the page:

<?php

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

$barcode = new \Com\Tecnick\Barcode\Barcode();
$bobj = $barcode->getBarcodeObj(
 type: 'QRCODE,H',
 code: 'https://tcpdf.org',
 width: -4,
 height: -4,
 color: 'black',
 padding: [-2, -2, -2, -2],
)->setBackgroundColor('white');

Conversions

Sun, 20 Sep 2026 00:00:00 +0000

Every model implements all five to*Array() methods, so any colour reaches any model in one call. The array that comes back is the component array the target constructor takes.

<?php

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

use Com\Tecnick\Color\Model;

$rgb = (new \Com\Tecnick\Color\Web())->getColorObj('#336699');

echo Model::create('GRAY', $rgb->toGrayArray())->getCssColor(), "\n";
echo Model::create('HSL', $rgb->toHslArray())->getCssColor(), "\n";
echo Model::create('CMYK', $rgb->toCmykArray())->getCssColor(), "\n";
echo Model::create('LAB', $rgb->toLabArray())->getCssColor(), "\n";

g(95)
hsl(210,50%,40%)
cmyk(66.6667%,33.3333%,0%,40%)
lab(42.0081% -0.1517 -32.846)

The Matrix

#336699 expressed in each model, converted to each of the others:

Linear Barcodes

Sun, 20 Sep 2026 00:00:00 +0000

One-dimensional symbologies, from the retail EAN and UPC family through CODE 39 and CODE 128 to the GS1 DataBar set. Each page gives the accepted input, a worked example and the symbol it produces.

49 Formats

Format	Type token	Description
CODE 39	`C39`	CODE 39 - ANSI MH10.8M-1983 - USD-3 - 3 of 9.
CODE 39 with check character	`C39+`	CODE 39 + CHECKSUM
CODE 39 Extended	`C39E`	CODE 39 EXTENDED
CODE 39 Extended with check character	`C39E+`	CODE 39 EXTENDED + CHECKSUM
CODE 32 (Italian Pharmacode)	`C32`	CODE 32 (Italian Pharmacode - IMH - Radix 32)
CODE 49	`C49`	CODE 49 (ANSI/AIM BC6)
PZN (Pharmazentralnummer)	`PZN`	PZN (Pharmazentralnummer - IFA coding system)
LOGMARS	`LOGMARS`	LOGMARS (CODE 39 profile of MIL-STD-1189B)
CODE 93	`C93`	CODE 93 - USS-93
CODE 128	`C128`	CODE 128
CODE 128 A	`C128A`	CODE 128 A
CODE 128 B	`C128B`	CODE 128 B
CODE 128 C	`C128C`	CODE 128 C
CODE 16K	`C16K`	CODE 16K (stacked CODE 128)
Standard 2 of 5	`S25`	Standard 2 of 5
Standard 2 of 5 with check digit	`S25+`	Standard 2 of 5 + CHECKSUM
2 of 5 IATA	`S25IATA`	2 of 5 IATA (Computer Identics 2 of 5)
2 of 5 Matrix	`S25MATRIX`	2 of 5 Matrix
2 of 5 Datalogic	`S25DATALOGIC`	2 of 5 Datalogic (China Post Code)
Interleaved 2 of 5	`I25`	Interleaved 2 of 5
Interleaved 2 of 5 with check digit	`I25+`	Interleaved 2 of 5 + CHECKSUM
ITF-14	`ITF14`	ITF-14 (GTIN-14 - GS1 General Specifications)
MSI	`MSI`	MSI (Variation of Plessey code)
MSI with check digit	`MSI+`	MSI + CHECKSUM (modulo 11)
Plessey	`PLESSEY`	Plessey Code
Telepen	`TELEPEN`	Telepen (full ASCII)
Codabar	`CODABAR`	CODABAR
CODE 11	`CODE11`	CODE 11
Pharmacode	`PHARMA`	PHARMACODE
Pharmacode Two-Track	`PHARMA2T`	PHARMACODE TWO-TRACKS
Linear Raw Mode	`LRAW`	1D RAW MODE (comma-separated rows of 01 strings)
EAN-13	`EAN13`	EAN 13
EAN-8	`EAN8`	EAN 8
EAN 2-digit add-on	`EAN2`	EAN 2-Digits UPC-Based Extension
EAN 5-digit add-on	`EAN5`	EAN 5-Digits UPC-Based Extension
UPC-A	`UPCA`	UPC-A
UPC-E	`UPCE`	UPC-E
GS1-128	`GS1128`	GS1-128 (CODE 128 with GS1 Application Identifiers)
SSCC-18	`SSCC18`	SSCC-18 (GS1-128 with the Application Identifier 00)
GS1-14	`GS114`	GS1-14 - EAN-14 - SCC-14 (GS1-128 with the Application Identifier 01)
GS1 DataBar Omnidirectional	`DATABAR`	GS1 DataBar Omnidirectional (ISO/IEC 24724)
GS1 DataBar Truncated	`DATABARTRUNC`	GS1 DataBar Truncated (ISO/IEC 24724)
GS1 DataBar Stacked	`DATABARSTACK`	GS1 DataBar Stacked (ISO/IEC 24724)
GS1 DataBar Stacked Omnidirectional	`DATABARSTACKOMNI`	GS1 DataBar Stacked Omnidirectional (ISO/IEC 24724)
GS1 DataBar Limited	`DATABARLIMITED`	GS1 DataBar Limited (ISO/IEC 24724)
GS1 DataBar Expanded	`DATABAREXP`	GS1 DataBar Expanded (ISO/IEC 24724)
GS1 DataBar Expanded Stacked	`DATABAREXPSTACK`	GS1 DataBar Expanded Stacked (ISO/IEC 24724)
HIBC in CODE 39	`HIBC39`	HIBC in CODE 39 (ANSI/HIBC 2.6 and ANSI/HIBC 1.3)
HIBC in CODE 128	`HIBC128`	HIBC in CODE 128 (ANSI/HIBC 2.6 and ANSI/HIBC 1.3)

2D Barcodes

Sun, 20 Sep 2026 00:00:00 +0000

Two-dimensional symbologies, which carry more data in less space than a linear symbol and recover from damage through error correction. Each page gives the accepted input, the parameters that change the symbol, and a worked example of each variant.

13 Formats

Format	Type token	Description
QR Code	`QRCODE`	QR-CODE
Micro QR Code	`MICROQR`	Micro QR Code (ISO/IEC 18004)
Datamatrix	`DATAMATRIX`	DATAMATRIX (ISO/IEC 16022)
Data Matrix Rectangular Extension	`DMRE`	Data Matrix Rectangular Extension (ISO/IEC 21471)
Aztec Code	`AZTEC`	AZTEC Code (ISO/IEC 24778:2008)
Aztec Rune	`AZTECRUNE`	AZTEC Rune (ISO/IEC 24778:2008 Annex A)
PDF417	`PDF417`	PDF417 (ISO/IEC 15438:2006)
Compact PDF417	`PDF417C`	Compact PDF417 - truncated (ISO/IEC 15438:2006)
Han Xin Code	`HANXIN`	Han Xin Code (GB/T 21049, ISO/IEC 20830)
HIBC in QR Code	`HIBCQR`	HIBC in QR-CODE (ANSI/HIBC 2.6 and ANSI/HIBC 1.3)
HIBC in Datamatrix	`HIBCDM`	HIBC in DATAMATRIX (ANSI/HIBC 2.6 and ANSI/HIBC 1.3)
HIBC in Aztec Code	`HIBCAZ`	HIBC in AZTEC Code (ANSI/HIBC 2.6 and ANSI/HIBC 1.3)
Square Raw Mode	`SRAW`	2D RAW MODE (comma-separated rows of 01 strings)

Web Colours

Sun, 20 Sep 2026 00:00:00 +0000

Web::WEBHEX maps 150 names to hex codes: the CSS Color Module Level 4 list, plus the two Acrobat JavaScript spellings dkgray and ltgray. Any of them can be used wherever a colour string is accepted, and the lookup is case-insensitive.

Lookups

<?php

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

$web = new \Com\Tecnick\Color\Web();

echo $web->getHexFromName('cornflowerblue'), "\n";
echo $web->getNameFromHex('#6495ed'), "\n";
echo $web->extractHexCode('#369'), "\n";
echo $web->getRgbObjFromName('cornflowerblue')->getCssColor(), "\n";

6495edff
cornflowerblue
336699ff
rgb(100,149,237)

extractHexCode() normalizes a hash: it lowercases, drops the #, and expands the three and four digit forms. getNameFromHex() is the reverse of getHexFromName() and raises for a code that is not in the table. For the closest entry rather than an exact match, see Nearest Colour.

Nearest Colour

Sun, 20 Sep 2026 00:00:00 +0000

Naming an arbitrary colour means finding the nearest entry in the web colour table. The library implements two distance measures, and they select a different name for close to half of the RGB cube.

The Two Answers

<?php

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

$web = new \Com\Tecnick\Color\Web();

echo $web->getClosestWebColorFromString('#9577a6'), "\n";
echo $web->getClosestWebColorByDeltaEFromString('#9577a6'), "\n";

lightslategray
plum

Euclidean distance in sRGB places #9577a6 next to lightslategray; CIE76 distance in CIE Lab places it next to plum.

Postal Barcodes

Sun, 20 Sep 2026 00:00:00 +0000

Height-modulated and four-state symbologies used by national postal operators. The numbers they carry are issued by the operator, so a symbol is only valid in its scheme once that number has been obtained.

11 Formats

Format	Type token	Description
POSTNET	`POSTNET`	POSTNET
PLANET	`PLANET`	PLANET
RM4SCC	`RMS4CC`	RMS4CC (Royal Mail 4-state Customer Bar Code)
KIX	`KIX`	KIX (Klant index - Customer index)
Japan Post	`JPPOST`	Japan Post Customer Barcode
Royal Mail Mailmark	`MAILMARK`	Royal Mail Mailmark 4-state barcode (types C and L)
Deutsche Post Identcode	`IDENTCODE`	Deutsche Post Identcode
Deutsche Post Leitcode	`LEITCODE`	Deutsche Post Leitcode
Australia Post 4-State	`AUSPOST`	Australia Post 4-State Customer Barcode
Intelligent Mail Barcode	`IMB`	IMB - Intelligent Mail Barcode - Onecode - USPS-B-3200
Intelligent Mail Barcode, pre-processed	`IMBPRE`	IMB - Intelligent Mail Barcode pre-processed

Spot Colours

Sun, 20 Sep 2026 00:00:00 +0000

A spot colour is a named ink rather than a mixture of the process four. In a PDF it is a Separation colour space: a name, an alternate colour space for rendering without the ink, and a tint transform between the two.

\Com\Tecnick\Color\Spot is the registry. \Com\Tecnick\Color\Pdf extends it, so one object provides the parser, the registry and the writers.

Registering One

<?php

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

$pdf = new \Com\Tecnick\Color\Pdf();

$key = $pdf->addSpotColorFromArray('PANTONE 032 C', [
 'cyan' => 0.0,
 'magenta' => 0.91,
 'yellow' => 0.86,
 'key' => 0.0,
]);

echo $key, "\n";
echo $pdf->getSpotColorObj('PANTONE 032 C')->getCssColor(), "\n";
echo $pdf->encodeSpotColorName('PANTONE 032 C'), "\n";

pantone032c
cmyk(0%,91%,86%,0%)
PANTONE#20032#20C

addSpotColor() takes a Cmyk object where addSpotColorFromArray() takes the components. Both return the registry key, which is what lookups match on: the name lowercased with every character outside [a-z0-9] dropped, so PANTONE 032 C keys as pantone032c. The name is stored as given and escaped when written to the PDF, where it becomes /PANTONE#20032#20C.

PDF Output

Sun, 20 Sep 2026 00:00:00 +0000

\Com\Tecnick\Color\Pdf turns a colour string into the operators a PDF content stream takes. It extends the spot registry, which extends the web parser, so the same object resolves a name, registers a separation and writes the operator.

Fill And Stroke

<?php

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

$pdf = new \Com\Tecnick\Color\Pdf();

echo $pdf->getPdfFillColor('#336699');
echo $pdf->getPdfStrokeColor('#336699');
echo $pdf->getPdfFillColor('cmyk(67%,33%,0%,40%)');
echo $pdf->getPdfFillColor('g(128)');

0.200000 0.400000 0.600000 rg
0.200000 0.400000 0.600000 RG
0.670000 0.330000 0.000000 0.400000 k
0.501961 g

The operator comes from the model, so the colour space follows the notation:

Errors

Sun, 20 Sep 2026 00:00:00 +0000

Two exception classes, split by the origin of the fault.

Class	Extends	Signals
`\Com\Tecnick\Color\Exception`	`\Exception`	input the library cannot parse
`\Com\Tecnick\Color\UnknownComponentException`	`\LogicException`	a component name no model defines

Both implement \Com\Tecnick\Color\ExceptionInterface, so one catch covers them:

<?php

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

$web = new \Com\Tecnick\Color\Web();

foreach (['#12', ['red' => 1.0, 'purple' => 0.5]] as $input) {
 try {
 $col = is_array($input)
 ? new \Com\Tecnick\Color\Model\Rgb($input)
 : $web->getColorObj($input);
 echo $col->getCssColor(), "\n";
 } catch (\Com\Tecnick\Color\ExceptionInterface $exc) {
 echo get_class($exc), ': ', $exc->getMessage(), "\n";
 }
}

Com\Tecnick\Color\Exception: unable to extract the color hash: #12
Com\Tecnick\Color\UnknownComponentException: unknown color components: purple

A colour string arriving from a stylesheet or a template can be wrong at runtime; a component name is written in the calling code, so a wrong one is a bug. The lenient accessors follow that split: tryGetColorObj() and getColorObject() catch Exception and let UnknownComponentException through.

2 of 5 Datalogic

Sun, 20 Sep 2026 00:00:00 +0000

Datalogic 2 of 5, also catalogued as China Post Code, differs from Standard 2 of 5 in its start and stop patterns and in nothing else.

Type Token

Item	Value
Type token	`S25DATALOGIC`
Enum case	`BarcodeType::S25DATALOGIC`
Family	Linear
Class	`\Com\Tecnick\Barcode\Type\Linear\DatalogicTwoOfFive`

Input

Item	Value
Character set	digits
Length	1 to 30000 characters
Check	none
Extra parameters	none

Examples

Ten digits

<?php

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

$barcode = new \Com\Tecnick\Barcode\Barcode();
$bobj = $barcode->getBarcodeObj(
 type: 'S25DATALOGIC',
 code: '0123456789',
 width: -3,
 height: -30,
 color: 'black',
 padding: [0, 0, 0, 0],
)->setBackgroundColor('white');

echo $bobj->getInlineSvgCode();

2 of 5 IATA

Sun, 20 Sep 2026 00:00:00 +0000

Also catalogued as Computer Identics 2 of 5. The data encoding is that of Standard 2 of 5; the start and stop patterns are different, which is what a scanner uses to tell the two apart.

Type Token

Item	Value
Type token	`S25IATA`
Enum case	`BarcodeType::S25IATA`
Family	Linear
Class	`\Com\Tecnick\Barcode\Type\Linear\IataTwoOfFive`

Input

Item	Value
Character set	digits
Length	1 to 30000 characters
Check	none
Extra parameters	none

Examples

Ten digits

<?php

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

$barcode = new \Com\Tecnick\Barcode\Barcode();
$bobj = $barcode->getBarcodeObj(
 type: 'S25IATA',
 code: '0123456789',
 width: -3,
 height: -30,
 color: 'black',
 padding: [0, 0, 0, 0],
)->setBackgroundColor('white');

echo $bobj->getInlineSvgCode();

2 of 5 Matrix

Sun, 20 Sep 2026 00:00:00 +0000

Matrix 2 of 5 carries data in the spaces as well as the bars, so the same digits fit into noticeably less width than Standard 2 of 5 needs.

Type Token

Item	Value
Type token	`S25MATRIX`
Enum case	`BarcodeType::S25MATRIX`
Family	Linear
Class	`\Com\Tecnick\Barcode\Type\Linear\MatrixTwoOfFive`

Input

Item	Value
Character set	digits
Length	1 to 30000 characters
Check	none
Extra parameters	none

Examples

Ten digits

<?php

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

$barcode = new \Com\Tecnick\Barcode\Barcode();
$bobj = $barcode->getBarcodeObj(
 type: 'S25MATRIX',
 code: '0123456789',
 width: -3,
 height: -30,
 color: 'black',
 padding: [0, 0, 0, 0],
)->setBackgroundColor('white');

echo $bobj->getInlineSvgCode();

Australia Post 4-State

Sun, 20 Sep 2026 00:00:00 +0000

A two-digit Format Control Code opens the payload and says what follows it: 11 for a sorting code alone, 59 and 62 for a sorting code with customer information, 00 for the reply paid form, which is only valid with a zero sorting code. Eight digits of sorting code come next, then the customer information the FCC allows.

Capacity is counted in bars. The N table spends 2 bars on a digit and the C table 3 on an alphanumeric character, so FCC 59 holds 8 digits or 5 characters, and FCC 62 holds 15 or 10.

Aztec Code

Sun, 20 Sep 2026 00:00:00 +0000

Aztec puts its finder in the middle, a bullseye of concentric squares, and grows outward in layers. There is no quiet zone requirement, which is why transport operators print it on tickets and boarding passes where every millimetre is spoken for.

Error correction is a percentage, not a level. The library defaults to 33 per cent of the symbol and accepts anything from 1 to 100; the standard sets the floor at 23 per cent plus three codewords.

Aztec Rune

Sun, 20 Sep 2026 00:00:00 +0000

A Rune is an Aztec symbol stripped to its smallest useful form: 11 by 11 modules carrying one byte, a number from 0 to 255 and nothing else. Annex A of the Aztec standard defines it for marking objects that need an identifier and no more.

Type Token

Item	Value
Type token	`AZTECRUNE`
Enum case	`BarcodeType::AZTECRUNE`
Family	2D
Standard	ISO/IEC 24778 Annex A
Class	`\Com\Tecnick\Barcode\Type\Square\AztecRune`

Input

Item	Value
Character set	digits, read as one integer
Length	a value from 0 to 255
Check	Reed-Solomon error correction, computed by the library
Extra parameters	none

Examples

A value in the middle of the range

<?php

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

$barcode = new \Com\Tecnick\Barcode\Barcode();
$bobj = $barcode->getBarcodeObj(
 type: 'AZTECRUNE',
 code: '125',
 width: -4,
 height: -4,
 color: 'black',
 padding: [0, 0, 0, 0],
)->setBackgroundColor('white');

echo $bobj->getInlineSvgCode();

CIE Lab

Sun, 20 Sep 2026 00:00:00 +0000

Lightness on one axis and two opponent chroma axes, scaled so that equal numeric steps are approximately equal perceptual steps. Lab coordinates describe a colour independently of the device rendering it.

Two parts of the library use that: perceptual distance on Nearest Colour, and the Lab alternate colour space of a spot colour in a PDF.

Model

Item	Value
Type string	`LAB`
Enum case	`ColorModelType::Lab`
Class	`\Com\Tecnick\Color\Model\Lab`
PDF colour space	DeviceRGB, by conversion
Notations	`lab()`

Components

Component	Key	Range	Out of range
L* (lightness)	`lstar`	0.0 to 100.0	clamped
a* (green to red)	`astar`	-128.0 to 127.0	clamped
b* (blue to yellow)	`bstar`	-128.0 to 127.0	clamped
Alpha	`alpha`	0.0 to 1.0, default 1.0	clamped

These are the only components in the library that are not fractions in [0..1], and the only ones that go negative.

CMYK

Sun, 20 Sep 2026 00:00:00 +0000

Cyan, magenta, yellow and a black key, one component per process plate. This is the colour space a press sheet is specified in and the alternate space most spot colours fall back to. The conversion from RGB is exact arithmetic and round-trips at 8-bit precision.

Model

Item	Value
Type string	`CMYK`
Enum case	`ColorModelType::Cmyk`
Class	`\Com\Tecnick\Color\Model\Cmyk`
PDF colour space	DeviceCMYK
Notations	`cmyk()`, `cmyka()`, `["CMYK",c,m,y,k]`

cmyk() and cmyka() are notations of this library, not CSS functions.

Codabar

Sun, 20 Sep 2026 00:00:00 +0000

Codabar dates from 1972 and encodes digits and six punctuation marks, one character per four bars and three spaces.

Four letters, A to D, serve as the start and stop characters. The library brackets the payload with A at both ends and rejects those four letters inside it, since a scanner reading one mid-symbol would take it for the end of the code.

Type Token

Item	Value
Type token	`CODABAR`
Enum case	`BarcodeType::CODABAR`
Family	Linear
Standard	USS-Codabar, ANSI/AIM BC3
Class	`\Com\Tecnick\Barcode\Type\Linear\Codabar`

Input

Item	Value
Character set	`0-9`, `-`, `$`, `:`, `/`, `.`, `+`
Length	1 to 30000 characters
Check	none
Extra parameters	none

Examples

Ten digits

<?php

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

$barcode = new \Com\Tecnick\Barcode\Barcode();
$bobj = $barcode->getBarcodeObj(
 type: 'CODABAR',
 code: '0123456789',
 width: -3,
 height: -30,
 color: 'black',
 padding: [0, 0, 0, 0],
)->setBackgroundColor('white');

echo $bobj->getInlineSvgCode();

CODE 11

Sun, 20 Sep 2026 00:00:00 +0000

Eleven characters: the ten digits and the dash. S is the start and the stop character. One check character is appended for payloads up to ten characters, two above that.

Type Token

Item	Value
Type token	`CODE11`
Enum case	`BarcodeType::CODE11`
Family	Linear
Standard	USD-8
Class	`\Com\Tecnick\Barcode\Type\Linear\CodeOneOne`

Input

Item	Value
Character set	`0-9` and `-`
Length	1 to 30000 characters
Check	one check character, or two when the payload is longer than 10 characters
Extra parameters	none

Examples

Ten digits, one check character

<?php

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

$barcode = new \Com\Tecnick\Barcode\Barcode();
$bobj = $barcode->getBarcodeObj(
 type: 'CODE11',
 code: '0123456789',
 width: -3,
 height: -30,
 color: 'black',
 padding: [0, 0, 0, 0],
)->setBackgroundColor('white');

echo $bobj->getInlineSvgCode();

CODE 128

Sun, 20 Sep 2026 00:00:00 +0000

CODE 128 covers the full ASCII set across three subsets: A for control characters and upper case, B for the printable range including lower case, C for pairs of digits at one character per two. This type picks the subsets and the switches between them from the payload, which for numeric data means roughly half the width of CODE 39.

Where the subset has to be fixed, use C128A, C128B or C128C instead.

CODE 128 A

Sun, 20 Sep 2026 00:00:00 +0000

CODE 128 restricted to subset A: digits, upper case letters, punctuation and the ASCII control characters. No lower case. Fixing the subset keeps every symbol the same width per character, which matters when a label layout is fixed in advance.

Type Token

Item	Value
Type token	`C128A`
Enum case	`BarcodeType::C128A`
Family	Linear
Standard	ISO/IEC 15417
Class	`\Com\Tecnick\Barcode\Type\Linear\CodeOneTwoEight\CodeOneTwoEightA`

Input

Item	Value
Character set	ASCII 0 to 95: space through `_`, plus the control characters
Length	1 to 30000 characters
Check	modulo 103, computed by the library
Extra parameters	none

Examples

Digits and upper case

<?php

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

$barcode = new \Com\Tecnick\Barcode\Barcode();
$bobj = $barcode->getBarcodeObj(
 type: 'C128A',
 code: 'TCPDF-2026',
 width: -3,
 height: -30,
 color: 'black',
 padding: [0, 0, 0, 0],
)->setBackgroundColor('white');

echo $bobj->getInlineSvgCode();

CODE 128 B

Sun, 20 Sep 2026 00:00:00 +0000

CODE 128 restricted to subset B, the printable ASCII range from space to tilde. This is the subset that carries lower case, and the one to fix when the payload is free text.

Type Token

Item	Value
Type token	`C128B`
Enum case	`BarcodeType::C128B`
Family	Linear
Standard	ISO/IEC 15417
Class	`\Com\Tecnick\Barcode\Type\Linear\CodeOneTwoEight\CodeOneTwoEightB`

Input

Item	Value
Character set	ASCII 32 to 126: space through `~`
Length	1 to 30000 characters
Check	modulo 103, computed by the library
Extra parameters	none

Examples

Lower case text

<?php

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

$barcode = new \Com\Tecnick\Barcode\Barcode();
$bobj = $barcode->getBarcodeObj(
 type: 'C128B',
 code: 'tc-lib-barcode',
 width: -3,
 height: -30,
 color: 'black',
 padding: [0, 0, 0, 0],
)->setBackgroundColor('white');

echo $bobj->getInlineSvgCode();

CODE 128 C

Sun, 20 Sep 2026 00:00:00 +0000

Subset C encodes two digits per symbol character, so a numeric payload comes out at half the width of the other subsets. The payload has to be digits, and it has to be an even number of them.

Type Token

Item	Value
Type token	`C128C`
Enum case	`BarcodeType::C128C`
Family	Linear
Standard	ISO/IEC 15417
Class	`\Com\Tecnick\Barcode\Type\Linear\CodeOneTwoEight\CodeOneTwoEightC`

Input

Item	Value
Character set	digits
Length	an even number of digits
Check	modulo 103, computed by the library
Extra parameters	none

Examples

Ten digits in five symbol characters

<?php

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

$barcode = new \Com\Tecnick\Barcode\Barcode();
$bobj = $barcode->getBarcodeObj(
 type: 'C128C',
 code: '0123456789',
 width: -3,
 height: -30,
 color: 'black',
 padding: [0, 0, 0, 0],
)->setBackgroundColor('white');

echo $bobj->getInlineSvgCode();

CODE 16K

Sun, 20 Sep 2026 00:00:00 +0000

CODE 16K stacks up to 16 rows of five CODE 128 characters, sharing one start pattern and one pair of check characters across the whole symbol. The row count follows from the payload length.

Type Token

Item	Value
Type token	`C16K`
Enum case	`BarcodeType::C16K`
Family	Linear
Standard	ANSI/AIM BC7, USS-16K
Class	`\Com\Tecnick\Barcode\Type\Linear\CodeOneSixK`

Input

Item	Value
Character set	the 128 ASCII characters
Length	2 to 16 rows of 5 characters
Check	two check characters, modulo 107, computed by the library
Extra parameters	none

Examples

Text across several rows

<?php

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

$barcode = new \Com\Tecnick\Barcode\Barcode();
$bobj = $barcode->getBarcodeObj(
 type: 'C16K',
 code: 'ab0123456789',
 width: -3,
 height: -3,
 color: 'black',
 padding: [0, 0, 0, 0],
)->setBackgroundColor('white');

echo $bobj->getInlineSvgCode();

CODE 32 (Italian Pharmacode)

Sun, 20 Sep 2026 00:00:00 +0000

Every medicine sold in Italy carries a nine-digit AIC number. CODE 32 converts that number to six characters in radix 32 and draws them as a CODE 39 symbol, so the printed symbol is shorter than the number it represents. AIFA assigns the AIC number; the library encodes whatever it is given.

Type Token

Item	Value
Type token	`C32`
Enum case	`BarcodeType::C32`
Family	Linear
Standard	Italian Pharmacode, IMH, radix 32
Class	`\Com\Tecnick\Barcode\Type\Linear\CodeThreeTwo`

Input

Item	Value
Character set	digits
Length	8 digits, or 9 with a valid check digit
Check	modulo 10, appended when the payload is 8 digits and verified when it is 9
Extra parameters	none

Examples

An AIC number

<?php

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

$barcode = new \Com\Tecnick\Barcode\Barcode();
$bobj = $barcode->getBarcodeObj(
 type: 'C32',
 code: '012345676',
 width: -3,
 height: -30,
 color: 'black',
 padding: [0, 0, 0, 0],
)->setBackgroundColor('white');

echo $bobj->getInlineSvgCode();

CODE 39

Sun, 20 Sep 2026 00:00:00 +0000

CODE 39 encodes digits, upper case letters and seven punctuation marks, one character per nine-element pattern of five bars and four spaces. Explicit start and stop characters delimit the symbol, so a scanner reads it without being told what to expect.

The format is wide. Ten characters occupy noticeably more space than the same ten in CODE 128, which is the usual reason for choosing something else.

Type Token

Item	Value
Type token	`C39`
Enum case	`BarcodeType::C39`
Family	Linear
Standard	ANSI MH10.8M-1983, USD-3, also known as 3 of 9
Class	`\Com\Tecnick\Barcode\Type\Linear\CodeThreeNine`

Input

Item	Value
Character set	`0-9`, `A-Z`, space, `-`, `.`, `$`, `/`, `+`, `%`. Lower case input is encoded as upper case.
Length	1 to 30000 characters
Check	none. Use `C39+` for the modulo 43 check character
Extra parameters	none

Examples

Digits

<?php

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

$barcode = new \Com\Tecnick\Barcode\Barcode();
$bobj = $barcode->getBarcodeObj(
 type: 'C39',
 code: '0123456789',
 width: -3,
 height: -30,
 color: 'black',
 padding: [0, 0, 0, 0],
)->setBackgroundColor('white');

echo $bobj->getInlineSvgCode();

CODE 39 Extended

Sun, 20 Sep 2026 00:00:00 +0000

Plain CODE 39 reaches 43 characters. The extended form covers all 128 ASCII values by encoding anything outside those 43 as a pair, with $, %, / and + acting as shift characters.

Lower case and control characters therefore cost two CODE 39 characters each, and a symbol carrying mixed-case text comes out close to twice the width of the same text in upper case.

Type Token

Item	Value
Type token	`C39E`
Enum case	`BarcodeType::C39E`
Family	Linear
Standard	ANSI MH10.8M-1983, USD-3
Class	`\Com\Tecnick\Barcode\Type\Linear\CodeThreeNineExt`

Input

Item	Value
Character set	the 128 ASCII characters
Length	1 to 30000 characters
Check	none. Use `C39E+` for the modulo 43 check character
Extra parameters	none

Examples

Digits

<?php

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

$barcode = new \Com\Tecnick\Barcode\Barcode();
$bobj = $barcode->getBarcodeObj(
 type: 'C39E',
 code: '0123456789',
 width: -3,
 height: -30,
 color: 'black',
 padding: [0, 0, 0, 0],
)->setBackgroundColor('white');

echo $bobj->getInlineSvgCode();

CODE 39 Extended with check character

Sun, 20 Sep 2026 00:00:00 +0000

Extended CODE 39 with the modulo 43 check character appended. The check is computed over the expanded character sequence, the one actually drawn, rather than over the input text.

Type Token

Item	Value
Type token	`C39E+`
Enum case	`BarcodeType::C39EPlus`
Family	Linear
Standard	ANSI MH10.8M-1983, USD-3
Class	`\Com\Tecnick\Barcode\Type\Linear\CodeThreeNineExtCheck`

Input

Item	Value
Character set	the 128 ASCII characters
Length	1 to 30000 characters
Check	modulo 43, appended by the library
Extra parameters	none

Examples

Mixed case with the check character

<?php

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

$barcode = new \Com\Tecnick\Barcode\Barcode();
$bobj = $barcode->getBarcodeObj(
 type: 'C39E+',
 code: 'tc-lib-barcode',
 width: -3,
 height: -30,
 color: 'black',
 padding: [0, 0, 0, 0],
)->setBackgroundColor('white');

echo $bobj->getInlineSvgCode();

CODE 39 with check character

Sun, 20 Sep 2026 00:00:00 +0000

CODE 39 with the modulo 43 check character computed over the payload and appended before encoding. Plain CODE 39 carries no check character at all, so this is the variant to use where the scanner cannot validate the data by any other means.

Type Token

Item	Value
Type token	`C39+`
Enum case	`BarcodeType::C39Plus`
Family	Linear
Standard	ANSI MH10.8M-1983, USD-3
Class	`\Com\Tecnick\Barcode\Type\Linear\CodeThreeNineCheck`

Input

Item	Value
Character set	as CODE 39
Length	1 to 30000 characters
Check	modulo 43, appended by the library
Extra parameters	none

Examples

Digits with the check character

<?php

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

$barcode = new \Com\Tecnick\Barcode\Barcode();
$bobj = $barcode->getBarcodeObj(
 type: 'C39+',
 code: '0123456789',
 width: -3,
 height: -30,
 color: 'black',
 padding: [0, 0, 0, 0],
)->setBackgroundColor('white');

echo $bobj->getInlineSvgCode();

CODE 49

Sun, 20 Sep 2026 00:00:00 +0000

CODE 49 stacks two to eight rows of eight characters into a single symbol, which puts the full ASCII set into a footprint no single-row format can reach. It dates from 1987, before the matrix formats existed, and the library builds the row split and the check symbols for you.

Type Token

Item	Value
Type token	`C49`
Enum case	`BarcodeType::C49`
Family	Linear
Standard	ANSI/AIM BC6
Class	`\Com\Tecnick\Barcode\Type\Linear\CodeFourNine`

Input

Item	Value
Character set	the printable ASCII characters
Length	2 to 8 rows of 8 characters, filled automatically
Check	two or three check symbols, computed by the library
Extra parameters	none

Examples

Several rows of text

<?php

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

$barcode = new \Com\Tecnick\Barcode\Barcode();
$bobj = $barcode->getBarcodeObj(
 type: 'C49',
 code: 'MULTIPLE ROWS IN CODE 49',
 width: -3,
 height: -3,
 color: 'black',
 padding: [0, 0, 0, 0],
)->setBackgroundColor('white');

echo $bobj->getInlineSvgCode();

CODE 93

Sun, 20 Sep 2026 00:00:00 +0000

CODE 93 was designed to replace CODE 39 where width mattered: nine modules per character against thirteen or more, two check characters instead of none, and the same full ASCII reach through shift pairs. Every character is drawn as three bars and three spaces, which also makes the symbol self-checking.

Type Token

Item	Value
Type token	`C93`
Enum case	`BarcodeType::C93`
Family	Linear
Standard	USS-93
Class	`\Com\Tecnick\Barcode\Type\Linear\CodeNineThree`

Input

Item	Value
Character set	the 128 ASCII characters
Length	1 to 30000 characters
Check	two check characters, C and K, appended by the library
Extra parameters	none

Examples

Digits

<?php

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

$barcode = new \Com\Tecnick\Barcode\Barcode();
$bobj = $barcode->getBarcodeObj(
 type: 'C93',
 code: '0123456789',
 width: -3,
 height: -30,
 color: 'black',
 padding: [0, 0, 0, 0],
)->setBackgroundColor('white');

echo $bobj->getInlineSvgCode();

Compact PDF417

Sun, 20 Sep 2026 00:00:00 +0000

Dropping the right row indicator and shortening the stop pattern takes about two codewords off every row. It is meant for clean printing on a controlled surface, where the redundancy it gives up was not going to be missed.

Type Token

Item	Value
Type token	`PDF417C`
Enum case	`BarcodeType::PDF417C`
Family	2D
Standard	ISO/IEC 15438
Class	`\Com\Tecnick\Barcode\Type\Square\PdfFourOneSevenCompact`

Input

Item	Value
Character set	any byte sequence
Length	as PDF417, in a narrower symbol
Check	Reed-Solomon error correction at the chosen level
Extra parameters	3 (see below)

Extra Parameters

Appended to the type token after commas, as in PDF417C,2,5.

Data Matrix Rectangular Extension

Sun, 20 Sep 2026 00:00:00 +0000

Standard Datamatrix offers six rectangular sizes. The rectangular extension adds a further set, from 8 by 48 up to 26 by 64, for marking surfaces that are long and thin: cables, pins, the edge of a circuit board. Leave the size parameter empty and the library picks the smallest that fits.

Type Token

Item	Value
Type token	`DMRE`
Enum case	`BarcodeType::DMRE`
Family	2D
Standard	ISO/IEC 21471
Class	`\Com\Tecnick\Barcode\Type\Square\Dmre`

Input

Item	Value
Character set	any byte sequence
Length	up to 172 characters, depending on the symbol size
Check	Reed-Solomon error correction, computed by the library
Extra parameters	3 (see below)

Extra Parameters

Appended to the type token after commas, as in DMRE,N,ASCII,8x144.

Datamatrix

Sun, 20 Sep 2026 00:00:00 +0000

Datamatrix is the matrix format of choice for marking small parts: the solid L-shaped finder and the alternating timing pattern along the other two edges give a reader the grid from a symbol only 10 modules square.

Six encoding schemes cover different payload shapes, from ASCII through the compacted C40, TXT and X12 sets to raw BASE256, and the encoder picks between them unless told otherwise. The GS1 variant prefixes the payload with FNC1 so the data reads as an element string.

Deutsche Post Identcode

Sun, 20 Sep 2026 00:00:00 +0000

Identcode identifies a consignment in the Deutsche Post network: two digits of primary distribution centre, three of customer number, six of consignment number, and a check digit. It is drawn as Interleaved 2 of 5.

Type Token

Item	Value
Type token	`IDENTCODE`
Enum case	`BarcodeType::IDENTCODE`
Family	Postal
Class	`\Com\Tecnick\Barcode\Type\Linear\Identcode`

Input

Item	Value
Character set	digits
Length	11 digits, or 12 with a valid check digit
Check	modulo 10 with weights 4 and 9, appended by the library
Extra parameters	none

Examples

A consignment number

<?php

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

$barcode = new \Com\Tecnick\Barcode\Barcode();
$bobj = $barcode->getBarcodeObj(
 type: 'IDENTCODE',
 code: '56310243031',
 width: -3,
 height: -30,
 color: 'black',
 padding: [0, 0, 0, 0],
)->setBackgroundColor('white');

echo $bobj->getInlineSvgCode();

Deutsche Post Leitcode

Sun, 20 Sep 2026 00:00:00 +0000

Leitcode routes the item rather than identifying it: five digits of postcode, three of street, three of house number, two of product code, and a check digit. Same symbology as Identcode, two digits longer.

Type Token

Item	Value
Type token	`LEITCODE`
Enum case	`BarcodeType::LEITCODE`
Family	Postal
Class	`\Com\Tecnick\Barcode\Type\Linear\Leitcode`

Input

Item	Value
Character set	digits
Length	13 digits, or 14 with a valid check digit
Check	modulo 10 with weights 4 and 9, appended by the library
Extra parameters	none

Examples

A routing code

<?php

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

$barcode = new \Com\Tecnick\Barcode\Barcode();
$bobj = $barcode->getBarcodeObj(
 type: 'LEITCODE',
 code: '2134807501640',
 width: -3,
 height: -30,
 color: 'black',
 padding: [0, 0, 0, 0],
)->setBackgroundColor('white');

echo $bobj->getInlineSvgCode();

EAN 2-digit add-on

Sun, 20 Sep 2026 00:00:00 +0000

A two-digit supplement, printed to the right of an EAN or UPC symbol and used for the issue number of a magazine or a periodical. It has no meaning on its own, and this type draws it on its own; to attach it to a main symbol, append it to the payload after a +.

Type Token

Item	Value
Type token	`EAN2`
Enum case	`BarcodeType::EAN2`
Family	Linear
Standard	GS1 General Specifications
Class	`\Com\Tecnick\Barcode\Type\Linear\EanTwo`

Input

Item	Value
Character set	digits
Length	1 or 2 digits
Check	none; the parity pattern of the two digits carries the check
Extra parameters	none

Examples

An issue number

<?php

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

$barcode = new \Com\Tecnick\Barcode\Barcode();
$bobj = $barcode->getBarcodeObj(
 type: 'EAN2',
 code: '12',
 width: -3,
 height: -30,
 color: 'black',
 padding: [0, 0, 0, 0],
)->setBackgroundColor('white');

echo $bobj->getInlineSvgCode();

EAN 5-digit add-on

Sun, 20 Sep 2026 00:00:00 +0000

Five digits printed to the right of an EAN or UPC symbol. On books the supplement carries the suggested retail price, with the first digit naming the currency.

Type Token

Item	Value
Type token	`EAN5`
Enum case	`BarcodeType::EAN5`
Family	Linear
Standard	GS1 General Specifications
Class	`\Com\Tecnick\Barcode\Type\Linear\EanFive`

Input

Item	Value
Character set	digits
Length	1 to 5 digits
Check	none; the parity pattern of the five digits carries the check
Extra parameters	none

Examples

A price supplement

<?php

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

$barcode = new \Com\Tecnick\Barcode\Barcode();
$bobj = $barcode->getBarcodeObj(
 type: 'EAN5',
 code: '52250',
 width: -3,
 height: -30,
 color: 'black',
 padding: [0, 0, 0, 0],
)->setBackgroundColor('white');

echo $bobj->getInlineSvgCode();

EAN-13

Sun, 20 Sep 2026 00:00:00 +0000

The thirteen-digit article number printed on retail packaging almost everywhere outside North America. The first digits are the GS1 company prefix, issued by a GS1 member organisation; the last is a modulo 10 check digit.

Give the library twelve digits and it computes the check. Give it thirteen and it verifies the one you supplied, rather than appending a second.

Type Token

Item	Value
Type token	`EAN13`
Enum case	`BarcodeType::EAN13`
Family	Linear
Standard	ISO/IEC 15420, GS1 General Specifications
Class	`\Com\Tecnick\Barcode\Type\Linear\EanOneThree`

Input

Item	Value
Character set	digits, plus `+` to introduce an add-on
Length	12 digits, or 13 with a valid check digit
Check	modulo 10, appended when the payload is 12 digits and verified when it is 13
Extra parameters	none

Examples

An article number

<?php

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

$barcode = new \Com\Tecnick\Barcode\Barcode();
$bobj = $barcode->getBarcodeObj(
 type: 'EAN13',
 code: '9781234567897',
 width: -3,
 height: -30,
 color: 'black',
 padding: [0, 0, 0, 0],
)->setBackgroundColor('white');

echo $bobj->getInlineSvgCode();

EAN-8

Sun, 20 Sep 2026 00:00:00 +0000

EAN-8 exists for packages with no room for the full thirteen digits. The number is allocated separately rather than derived from the EAN-13 of the same product, so the two are unrelated. Unlike EAN-13 and the UPC pair, EAN-8 takes no add-on symbol.

Type Token

Item	Value
Type token	`EAN8`
Enum case	`BarcodeType::EAN8`
Family	Linear
Standard	ISO/IEC 15420, GS1 General Specifications
Class	`\Com\Tecnick\Barcode\Type\Linear\EanEight`

Input

Item	Value
Character set	digits
Length	7 digits, or 8 with a valid check digit
Check	modulo 10, appended when the payload is 7 digits and verified when it is 8
Extra parameters	none

Examples

A short article number

<?php

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

$barcode = new \Com\Tecnick\Barcode\Barcode();
$bobj = $barcode->getBarcodeObj(
 type: 'EAN8',
 code: '1234567',
 width: -3,
 height: -30,
 color: 'black',
 padding: [0, 0, 0, 0],
)->setBackgroundColor('white');

echo $bobj->getInlineSvgCode();

Grayscale

Sun, 20 Sep 2026 00:00:00 +0000

The grayscale model holds one component, 0.0 for black to 1.0 for white. DeviceGray takes a single operand per colour operator, so a monochrome document written in it is smaller than the same document in DeviceRGB.

Model

Item	Value
Type string	`GRAY`
Enum case	`ColorModelType::Gray`
Class	`\Com\Tecnick\Color\Model\Gray`
PDF colour space	DeviceGray
Notations	`g(128)`, `g(50%)`, `["G",0.5]`

g() is a notation of this library, not a CSS function. getCssColor() emits it and getColorObj() reads it back. A browser does not parse it.

GS1 DataBar Expanded

Sun, 20 Sep 2026 00:00:00 +0000

The only member of the DataBar family that carries more than a GTIN. It takes the same bracketed element string as GS1-128, compacts it, and draws it in 4 to 22 symbol characters.

Capacity is counted in bits rather than characters, up to 252 of them, because the compaction depends on what the Application Identifiers are: a price field costs less than free text.

Type Token

Item	Value
Type token	`DATABAREXP`
Enum case	`BarcodeType::DATABAREXP`
Family	Linear
Standard	ISO/IEC 24724
Class	`\Com\Tecnick\Barcode\Type\Linear\GsOneDataBarExpanded`

Input

Item	Value
Character set	the printable ASCII characters, in the bracketed element string form
Length	4 to 22 symbol characters, up to 252 bits of compacted data
Check	per Application Identifier, where the definition specifies one
Extra parameters	none

Examples

A GTIN and a weight

<?php

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

$barcode = new \Com\Tecnick\Barcode\Barcode();
$bobj = $barcode->getBarcodeObj(
 type: 'DATABAREXP',
 code: '(01)90614141000015(3202)000150',
 width: -3,
 height: -3,
 color: 'black',
 padding: [0, 0, 0, 0],
)->setBackgroundColor('white');

echo $bobj->getInlineSvgCode();

GS1 DataBar Expanded Stacked

Sun, 20 Sep 2026 00:00:00 +0000

Expanded, folded into rows, for labels that are taller than they are wide. A row holds an even number of segments, from 2 to 20, and the default of 4 suits most label shapes.

Type Token

Item	Value
Type token	`DATABAREXPSTACK`
Enum case	`BarcodeType::DATABAREXPSTACK`
Family	Linear
Standard	ISO/IEC 24724
Class	`\Com\Tecnick\Barcode\Type\Linear\GsOneDataBarExpandedStacked`

Input

Item	Value
Character set	the printable ASCII characters, in the bracketed element string form
Length	4 to 22 symbol characters, up to 252 bits of compacted data
Check	per Application Identifier, where the definition specifies one
Extra parameters	2 (see below)

Extra Parameters

Appended to the type token after commas, as in DATABAREXPSTACK,0,6.

GS1 DataBar Limited

Sun, 20 Sep 2026 00:00:00 +0000

The narrowest of the family, 74 modules wide and 10 high, for items that cannot carry anything larger. The price of that size is the indicator digit: the first digit of the GTIN has to be 0 or 1, so the format only covers retail consumer units.

Type Token

Item	Value
Type token	`DATABARLIMITED`
Enum case	`BarcodeType::DATABARLIMITED`
Family	Linear
Standard	ISO/IEC 24724
Class	`\Com\Tecnick\Barcode\Type\Linear\GsOneDataBarLimited`

Input

Item	Value
Character set	digits
Length	13 digits, or 14 with a valid check digit; the indicator digit must be 0 or 1
Check	modulo 10, appended when the payload is 13 digits and verified when it is 14
Extra parameters	1 (see below)

Extra Parameters

Appended to the type token after commas, as in DATABARLIMITED,1.

GS1 DataBar Omnidirectional

Sun, 20 Sep 2026 00:00:00 +0000

GS1 DataBar was designed for the things EAN and UPC symbols do not fit: loose produce, small pharmaceutical packs, coupons. It carries a full GTIN-14 in a symbol 96 modules wide.

The omnidirectional variant is 33 modules high, enough for a slot scanner to read it at any orientation.

Type Token

Item	Value
Type token	`DATABAR`
Enum case	`BarcodeType::DATABAR`
Family	Linear
Standard	ISO/IEC 24724
Class	`\Com\Tecnick\Barcode\Type\Linear\GsOneDataBarOmni`

Input

Item	Value
Character set	digits
Length	13 digits, or 14 with a valid check digit
Check	modulo 10, appended when the payload is 13 digits and verified when it is 14
Extra parameters	1 (see below)

Extra Parameters

Appended to the type token after commas, as in DATABAR,1.

GS1 DataBar Stacked

Sun, 20 Sep 2026 00:00:00 +0000

Take the omnidirectional symbol, cut it in half and stack the halves: that is this format, for labels with more height than width. The two rows are separated by a pattern that tells the scanner how to put them back together.

Type Token

Item	Value
Type token	`DATABARSTACK`
Enum case	`BarcodeType::DATABARSTACK`
Family	Linear
Standard	ISO/IEC 24724
Class	`\Com\Tecnick\Barcode\Type\Linear\GsOneDataBarStacked`

Input

Item	Value
Character set	digits
Length	13 digits, or 14 with a valid check digit
Check	modulo 10, appended when the payload is 13 digits and verified when it is 14
Extra parameters	1 (see below)

Extra Parameters

Appended to the type token after commas, as in DATABARSTACK,1.

GS1 DataBar Stacked Omnidirectional

Sun, 20 Sep 2026 00:00:00 +0000

Two rows, each of them tall enough to be read on its own, which is what the stacked form gives up. The separator pattern between them alternates, so a scanner can tell which row it is looking at.

Type Token

Item	Value
Type token	`DATABARSTACKOMNI`
Enum case	`BarcodeType::DATABARSTACKOMNI`
Family	Linear
Standard	ISO/IEC 24724
Class	`\Com\Tecnick\Barcode\Type\Linear\GsOneDataBarStackedOmni`

Input

Item	Value
Character set	digits
Length	13 digits, or 14 with a valid check digit
Check	modulo 10, appended when the payload is 13 digits and verified when it is 14
Extra parameters	1 (see below)

Extra Parameters

Appended to the type token after commas, as in DATABARSTACKOMNI,1.

GS1 DataBar Truncated

Sun, 20 Sep 2026 00:00:00 +0000

Same encoding as the omnidirectional form, at 13 modules high instead of 33. Reading it needs a handheld scanner aimed across the bars, which is the trade for the height it saves.

Type Token

Item	Value
Type token	`DATABARTRUNC`
Enum case	`BarcodeType::DATABARTRUNC`
Family	Linear
Standard	ISO/IEC 24724
Class	`\Com\Tecnick\Barcode\Type\Linear\GsOneDataBarTruncated`

Input

Item	Value
Character set	digits
Length	13 digits, or 14 with a valid check digit
Check	modulo 10, appended when the payload is 13 digits and verified when it is 14
Extra parameters	1 (see below)

Extra Parameters

Appended to the type token after commas, as in DATABARTRUNC,1.

GS1-128

Sun, 20 Sep 2026 00:00:00 +0000

GS1-128 is CODE 128 carrying structured data: one or more Application Identifiers, each followed by its data field. AI 01 is a trade item number, 10 a batch, 17 an expiry date, and so on through the GS1 General Specifications.

Write the payload in the bracketed form, (ai)value(ai)value. The library parses it against the AI definitions, checks each field for length and character set, and inserts the FNC1 separators where a variable-length field needs one. Brackets are delimiters, so they cannot appear inside a value.

GS1-14

Sun, 20 Sep 2026 00:00:00 +0000

The same GTIN-14 that ITF-14 carries, drawn as a GS1-128 with Application Identifier 01 instead. Also catalogued as EAN-14 and SCC-14. Pass the digits and the library writes the element string.

Type Token

Item	Value
Type token	`GS114`
Enum case	`BarcodeType::GS114`
Family	Linear
Standard	GS1 General Specifications
Class	`\Com\Tecnick\Barcode\Type\Linear\GsOneOneFour`

Input

Item	Value
Character set	digits
Length	13 digits, or 14 with a valid check digit
Check	modulo 10, appended when the payload is 13 digits and verified when it is 14
Extra parameters	none

Examples

A GTIN-14

<?php

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

$barcode = new \Com\Tecnick\Barcode\Barcode();
$bobj = $barcode->getBarcodeObj(
 type: 'GS114',
 code: '9501101020917',
 width: -3,
 height: -30,
 color: 'black',
 padding: [0, 0, 0, 0],
)->setBackgroundColor('white');

echo $bobj->getInlineSvgCode();

Han Xin Code

Sun, 20 Sep 2026 00:00:00 +0000

Han Xin was designed in China for Chinese text, and encodes GB 18030 characters directly rather than through an escape mechanism. Eighty-four versions, from 23 modules square to 189, and four error correction levels from L1 to L4.

Its finder patterns differ from the QR Code ones, so a reader has to be told to look for it.

Type Token

Item	Value
Type token	`HANXIN`
Enum case	`BarcodeType::HANXIN`
Family	2D
Standard	GB/T 21049, ISO/IEC 20830
Class	`\Com\Tecnick\Barcode\Type\Square\HanXin`

Input

Item	Value
Character set	any byte sequence, with a dedicated mode for GB 18030 text
Length	up to 7827 digits or 4350 bytes
Check	Reed-Solomon error correction at the chosen level
Extra parameters	3 (see below)

Extra Parameters

Appended to the type token after commas, as in HANXIN,L3,10,2.

HIBC in Aztec Code

Sun, 20 Sep 2026 00:00:00 +0000

HIBC data in an Aztec symbol. Aztec needs no quiet zone, which buys a little more room on a label that is already full.

Type Token

Item	Value
Type token	`HIBCAZ`
Enum case	`BarcodeType::HIBCAZ`
Family	2D
Standard	ANSI/HIBC 2.6, ANSI/HIBC 1.3
Class	`\Com\Tecnick\Barcode\Type\Square\HibcAztec`

Input

Item	Value
Character set	the HIBC character set
Length	a primary structure of 6 to 23 characters, with an optional secondary structure
Check	modulo 43, appended by the library, plus the Aztec error correction
Extra parameters	none

Examples

A primary data structure

<?php

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

$barcode = new \Com\Tecnick\Barcode\Barcode();
$bobj = $barcode->getBarcodeObj(
 type: 'HIBCAZ',
 code: '+A123BJC5D6E71',
 width: -4,
 height: -4,
 color: 'black',
 padding: [0, 0, 0, 0],
)->setBackgroundColor('white');

echo $bobj->getInlineSvgCode();

HIBC in CODE 128

Sun, 20 Sep 2026 00:00:00 +0000

The same health industry data structure as HIBC39, drawn as a CODE 128 symbol instead. CODE 128 is denser, so this is the linear form to reach for when the label is tight.

Type Token

Item	Value
Type token	`HIBC128`
Enum case	`BarcodeType::HIBC128`
Family	Linear
Standard	ANSI/HIBC 2.6, ANSI/HIBC 1.3
Class	`\Com\Tecnick\Barcode\Type\Linear\HibcOneTwoEight`

Input

Item	Value
Character set	the HIBC character set
Length	a primary structure of 6 to 23 characters, with an optional secondary structure
Check	modulo 43, appended by the library
Extra parameters	none

Examples

A primary data structure

<?php

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

$barcode = new \Com\Tecnick\Barcode\Barcode();
$bobj = $barcode->getBarcodeObj(
 type: 'HIBC128',
 code: '+A123BJC5D6E71',
 width: -3,
 height: -30,
 color: 'black',
 padding: [0, 0, 0, 0],
)->setBackgroundColor('white');

echo $bobj->getInlineSvgCode();

HIBC in CODE 39

Sun, 20 Sep 2026 00:00:00 +0000

The health industry data structure, drawn as a CODE 39 symbol. It opens with +, then the Labeler Identification Code that HIBCC assigns, the product number, the unit of measure, and optionally a secondary structure carrying lot, serial or expiry.

The structure is independent of the symbology that carries it, so the same payload also encodes as HIBC128, HIBCDM, HIBCQR or HIBCAZ. The modulo 43 check character is appended for you.

HIBC in Datamatrix

Sun, 20 Sep 2026 00:00:00 +0000

HIBC data in a Datamatrix symbol. This is the combination that fits on a surgical instrument or a small vial, where a linear symbol has nowhere to go.

Type Token

Item	Value
Type token	`HIBCDM`
Enum case	`BarcodeType::HIBCDM`
Family	2D
Standard	ANSI/HIBC 2.6, ANSI/HIBC 1.3
Class	`\Com\Tecnick\Barcode\Type\Square\HibcDatamatrix`

Input

Item	Value
Character set	the HIBC character set
Length	a primary structure of 6 to 23 characters, with an optional secondary structure
Check	modulo 43, appended by the library, plus the Datamatrix error correction
Extra parameters	none

Examples

A primary data structure

<?php

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

$barcode = new \Com\Tecnick\Barcode\Barcode();
$bobj = $barcode->getBarcodeObj(
 type: 'HIBCDM',
 code: '+A123BJC5D6E71',
 width: -4,
 height: -4,
 color: 'black',
 padding: [0, 0, 0, 0],
)->setBackgroundColor('white');

echo $bobj->getInlineSvgCode();

HIBC in QR Code

Sun, 20 Sep 2026 00:00:00 +0000

The health industry data structure carried by a QR Code. Same payload rules as the linear HIBC types, same modulo 43 check character; what changes is the symbol around it and the amount of secondary data that will fit.

Type Token

Item	Value
Type token	`HIBCQR`
Enum case	`BarcodeType::HIBCQR`
Family	2D
Standard	ANSI/HIBC 2.6, ANSI/HIBC 1.3
Class	`\Com\Tecnick\Barcode\Type\Square\HibcQrCode`

Input

Item	Value
Character set	the HIBC character set
Length	a primary structure of 6 to 23 characters, with an optional secondary structure
Check	modulo 43, appended by the library, plus the QR Code error correction
Extra parameters	none

Examples

A primary data structure

<?php

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

$barcode = new \Com\Tecnick\Barcode\Barcode();
$bobj = $barcode->getBarcodeObj(
 type: 'HIBCQR',
 code: '+A123BJC5D6E71',
 width: -4,
 height: -4,
 color: 'black',
 padding: [0, 0, 0, 0],
)->setBackgroundColor('white');

echo $bobj->getInlineSvgCode();

HSL

Sun, 20 Sep 2026 00:00:00 +0000

Hue, saturation and lightness address the same colours as RGB in cylindrical coordinates. Darkening a colour changes one component instead of three, which is what palette and theme code uses the model for.

Model

Item	Value
Type string	`HSL`
Enum case	`ColorModelType::Hsl`
Class	`\Com\Tecnick\Color\Model\Hsl`
PDF colour space	DeviceRGB, by conversion
Notations	`hsl()`, `hsla()`

Components

Component	Key	Range	Out of range
Hue	`hue`	0.0 to 1.0, a fraction of a full turn	wrapped
Saturation	`saturation`	0.0 to 1.0	clamped
Lightness	`lightness`	0.0 to 1.0	clamped
Alpha	`alpha`	0.0 to 1.0, default 1.0	clamped

The hue is stored as a fraction, not as degrees. The hsl() notation takes degrees and getCssColor() emits degrees; the constructor does not.

Intelligent Mail Barcode

Sun, 20 Sep 2026 00:00:00 +0000

The Intelligent Mail Barcode replaced POSTNET and PLANET with one symbol carrying both routing and tracking: a 20-digit tracking code, then optionally a routing code of 5, 9 or 11 digits after a dash.

The result is always 65 four-state bars. Getting there takes an 11-bit cyclic redundancy check and a conversion through 13-bit codewords, which is where the bcmath extension earns its place: without it the library falls back to its own arbitrary precision arithmetic.

Intelligent Mail Barcode, pre-processed

Sun, 20 Sep 2026 00:00:00 +0000

The same symbol approached from the other end. The payload is the finished bar string, 65 characters of A, D, F and T for ascender, descender, full bar and tracker, and the library only draws it. Use it when the encoding has already been done by something else.

Type Token

Item	Value
Type token	`IMBPRE`
Enum case	`BarcodeType::IMBPRE`
Family	Postal
Standard	USPS-B-3200
Class	`\Com\Tecnick\Barcode\Type\Linear\ImbPre`

Input

Item	Value
Character set	`A`, `D`, `F` and `T`
Length	exactly 65 characters
Check	none; the input is already encoded
Extra parameters	none

Examples

A prepared bar string

<?php

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

$barcode = new \Com\Tecnick\Barcode\Barcode();
$bobj = $barcode->getBarcodeObj(
 type: 'IMBPRE',
 code: 'AADTFFDFTDADTAADAATFDTDDAAADDTDTTDAFADADDDTFFFDDTTTADFAAADFTDAADA',
 width: -3,
 height: -30,
 color: 'black',
 padding: [0, 0, 0, 0],
)->setBackgroundColor('white');

echo $bobj->getInlineSvgCode();

Interleaved 2 of 5

Sun, 20 Sep 2026 00:00:00 +0000

Interleaving is what makes this one compact: the first digit of each pair is drawn in the bars and the second in the spaces between them. A numeric payload comes out at roughly half the width of Standard 2 of 5.

The pairing means the digit count has to be even. The library prepends a zero when it is odd, so 012345678 and 0012345678 produce the same symbol.

Type Token

Item	Value
Type token	`I25`
Enum case	`BarcodeType::I25`
Family	Linear
Standard	ISO/IEC 16390
Class	`\Com\Tecnick\Barcode\Type\Linear\InterleavedTwoOfFive`

Input

Item	Value
Character set	digits
Length	any number of digits; an odd count is left-padded with a zero
Check	none. Use `I25+` for the modulo 10 check digit
Extra parameters	none

Examples

Ten digits

<?php

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

$barcode = new \Com\Tecnick\Barcode\Barcode();
$bobj = $barcode->getBarcodeObj(
 type: 'I25',
 code: '0123456789',
 width: -3,
 height: -30,
 color: 'black',
 padding: [0, 0, 0, 0],
)->setBackgroundColor('white');

echo $bobj->getInlineSvgCode();

Interleaved 2 of 5 with check digit

Sun, 20 Sep 2026 00:00:00 +0000

Interleaved 2 of 5 with a modulo 10 check digit. The check is computed first and the result padded to an even length afterwards, so a ten-digit payload is drawn as twelve digits.

Type Token

Item	Value
Type token	`I25+`
Enum case	`BarcodeType::I25Plus`
Family	Linear
Standard	ISO/IEC 16390
Class	`\Com\Tecnick\Barcode\Type\Linear\InterleavedTwoOfFiveCheck`

Input

Item	Value
Character set	digits
Length	any number of digits; the result is padded to an even length
Check	modulo 10, appended by the library
Extra parameters	none

Examples

Ten digits and the appended check

<?php

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

$barcode = new \Com\Tecnick\Barcode\Barcode();
$bobj = $barcode->getBarcodeObj(
 type: 'I25+',
 code: '0123456789',
 width: -3,
 height: -30,
 color: 'black',
 padding: [0, 0, 0, 0],
)->setBackgroundColor('white');

echo $bobj->getInlineSvgCode();

ITF-14

Sun, 20 Sep 2026 00:00:00 +0000

ITF-14 carries a GTIN-14, the trade item number of a shipping case or a pallet layer. It is Interleaved 2 of 5 inside a heavy rectangular frame, the bearer bar, which is there because corrugated board prints badly: without it a partial scan can be read as a valid shorter code.

The GTIN comes from a GS1 company prefix, which a GS1 member organisation issues.

Type Token

Item	Value
Type token	`ITF14`
Enum case	`BarcodeType::ITF14`
Family	Linear
Standard	GS1 General Specifications
Class	`\Com\Tecnick\Barcode\Type\Linear\ItfOneFour`

Input

Item	Value
Character set	digits
Length	13 digits, or 14 with a valid check digit
Check	modulo 10, appended when the payload is 13 digits and verified when it is 14
Extra parameters	none

Examples

A GTIN-14

<?php

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

$barcode = new \Com\Tecnick\Barcode\Barcode();
$bobj = $barcode->getBarcodeObj(
 type: 'ITF14',
 code: '09312345678907',
 width: -1,
 height: -1,
 color: 'black',
 padding: [0, 0, 0, 0],
)->setBackgroundColor('white');

echo $bobj->getInlineSvgCode();

Japan Post

Sun, 20 Sep 2026 00:00:00 +0000

Japan Post’s customer barcode carries the seven-digit postal code followed by the part of the address that identifies the delivery point. Bars take three shapes, and the alphabetic parts of an address are encoded through control characters, which is why the drawn symbol is longer than the text suggests.

Type Token

Item	Value
Type token	`JPPOST`
Enum case	`BarcodeType::JPPOST`
Family	Postal
Class	`\Com\Tecnick\Barcode\Type\Linear\JapanPost`

Input

Item	Value
Character set	`0-9`, `A-Z` and `-`
Length	a 7 digit postal code, then up to 13 characters of address
Check	modulo 19, appended by the library
Extra parameters	none

Examples

A postal code and address

<?php

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

$barcode = new \Com\Tecnick\Barcode\Barcode();
$bobj = $barcode->getBarcodeObj(
 type: 'JPPOST',
 code: '910-00673-80-25J1-2B',
 width: -3,
 height: -30,
 color: 'black',
 padding: [0, 0, 0, 0],
)->setBackgroundColor('white');

echo $bobj->getInlineSvgCode();

KIX

Sun, 20 Sep 2026 00:00:00 +0000

The Dutch customer index uses the same four bar states as the Royal Mail code, without the start pattern, the stop pattern or the check character. The sender prepares the delivery point string; PostNL defines what goes in it.

Type Token

Item	Value
Type token	`KIX`
Enum case	`BarcodeType::KIX`
Family	Postal
Class	`\Com\Tecnick\Barcode\Type\Linear\KlantIndex`

Input

Item	Value
Character set	`0-9` and `A-Z`
Length	1 to 30000 characters
Check	none
Extra parameters	none

Examples

A delivery point

<?php

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

$barcode = new \Com\Tecnick\Barcode\Barcode();
$bobj = $barcode->getBarcodeObj(
 type: 'KIX',
 code: '1231FZ13XHS',
 width: -3,
 height: -30,
 color: 'black',
 padding: [0, 0, 0, 0],
)->setBackgroundColor('white');

echo $bobj->getInlineSvgCode();

Linear Raw Mode

Sun, 20 Sep 2026 00:00:00 +0000

This is a custom format rather than a published symbology. It allows a bar pattern computed elsewhere to be drawn as it is: the payload is the pattern itself, a string of 0 and 1 in which each 1 is one module of bar, and the library encodes nothing.

Type Token

Item	Value
Type token	`LRAW`
Enum case	`BarcodeType::LRAW`
Family	Linear
Class	`\Com\Tecnick\Barcode\Type\Linear\Raw`

Input

Item	Value
Character set	`0` and `1`
Length	1 to 30000 characters
Check	none
Extra parameters	none

Examples

A bar pattern drawn as given

<?php

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

$barcode = new \Com\Tecnick\Barcode\Barcode();
$bobj = $barcode->getBarcodeObj(
 type: 'LRAW',
 code: '0101010101',
 width: -3,
 height: -30,
 color: 'black',
 padding: [0, 0, 0, 0],
)->setBackgroundColor('white');

echo $bobj->getInlineSvgCode();

LOGMARS

Sun, 20 Sep 2026 00:00:00 +0000

LOGMARS is CODE 39 as the United States military profiles it for logistics labelling. The encoding is identical to CODE 39; the standard fixes the dimensions, the bar ratio and the human readable line.

Type Token

Item	Value
Type token	`LOGMARS`
Enum case	`BarcodeType::LOGMARS`
Family	Linear
Standard	MIL-STD-1189B
Class	`\Com\Tecnick\Barcode\Type\Linear\Logmars`

Input

Item	Value
Character set	as CODE 39
Length	1 to 30000 characters
Check	modulo 43, appended by the library
Extra parameters	none

Examples

A part number

<?php

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

$barcode = new \Com\Tecnick\Barcode\Barcode();
$bobj = $barcode->getBarcodeObj(
 type: 'LOGMARS',
 code: '12345/ABCDE',
 width: -3,
 height: -30,
 color: 'black',
 padding: [0, 0, 0, 0],
)->setBackgroundColor('white');

echo $bobj->getInlineSvgCode();

Micro QR Code

Sun, 20 Sep 2026 00:00:00 +0000

Micro QR fits in one finder pattern instead of three, which takes the smallest symbol down to 11 modules square. Four versions, M1 to M4, and a ceiling of 35 digits: past that the data belongs in a full QR Code.

Type Token

Item	Value
Type token	`MICROQR`
Enum case	`BarcodeType::MICROQR`
Family	2D
Standard	ISO/IEC 18004
Class	`\Com\Tecnick\Barcode\Type\Square\MicroQrCode`

Input

Item	Value
Character set	numeric, alphanumeric and byte data
Length	up to 35 digits, 21 alphanumeric characters or 15 bytes at version M4
Check	Reed-Solomon error correction, computed by the library
Extra parameters	3 (see below)

Extra Parameters

Appended to the type token after commas, as in MICROQR,M,4,AN.

MSI

Sun, 20 Sep 2026 00:00:00 +0000

MSI, a variation on the Plessey code, was made for shelf edge labels and inventory tags rather than for anything that travels. Each character is four bits drawn as four bar and space pairs.

Type Token

Item	Value
Type token	`MSI`
Enum case	`BarcodeType::MSI`
Family	Linear
Class	`\Com\Tecnick\Barcode\Type\Linear\Msi`

Input

Item	Value
Character set	`0-9` and `A-F`
Length	1 to 30000 characters
Check	none. Use `MSI+` for the modulo 11 check digit
Extra parameters	none

Examples

Ten digits

<?php

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

$barcode = new \Com\Tecnick\Barcode\Barcode();
$bobj = $barcode->getBarcodeObj(
 type: 'MSI',
 code: '0123456789',
 width: -3,
 height: -30,
 color: 'black',
 padding: [0, 0, 0, 0],
)->setBackgroundColor('white');

echo $bobj->getInlineSvgCode();

MSI with check digit

Sun, 20 Sep 2026 00:00:00 +0000

MSI with a modulo 11 check digit appended. A payload whose check works out to 10 has no single character to write it in, and is rejected.

Type Token

Item	Value
Type token	`MSI+`
Enum case	`BarcodeType::MSIPlus`
Family	Linear
Class	`\Com\Tecnick\Barcode\Type\Linear\MsiCheck`

Input

Item	Value
Character set	`0-9` and `A-F`
Length	1 to 30000 characters
Check	modulo 11, appended by the library
Extra parameters	none

Examples

Ten digits and the appended check

<?php

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

$barcode = new \Com\Tecnick\Barcode\Barcode();
$bobj = $barcode->getBarcodeObj(
 type: 'MSI+',
 code: '0123456789',
 width: -3,
 height: -30,
 color: 'black',
 padding: [0, 0, 0, 0],
)->setBackgroundColor('white');

echo $bobj->getInlineSvgCode();

PDF417

Sun, 20 Sep 2026 00:00:00 +0000

PDF417 is stacked rather than matrix: rows of codewords, each 17 modules wide and made of four bars and four spaces, which is where the name comes from. Driving licences and boarding passes carry it because a linear scanner sweeping across the rows can read it.

An aspect ratio sets the shape, and the nine error correction levels run from 2 correctable codewords at level 0 to 512 at level 8.

Pharmacode

Sun, 20 Sep 2026 00:00:00 +0000

Pharmacode represents a single integer as a sequence of thin and thick bars, read from right to left. There is no character set behind it, no start or stop pattern and no check digit.

The design target was verification on a packaging line: the symbol can be printed in any colour on any background, and a reader only has to distinguish two bar widths. PHARMA-CODE is a trademark of Laetus GmbH.

Pharmacode Two-Track

Sun, 20 Sep 2026 00:00:00 +0000

The two-track form gives each position three states instead of two: a bar in the upper track, in the lower track, or spanning both. That widens the range to 64570080 without making the symbol longer.

Type Token

Item	Value
Type token	`PHARMA2T`
Enum case	`BarcodeType::PHARMA2T`
Family	Linear
Class	`\Com\Tecnick\Barcode\Type\Linear\PharmaTwoTracks`

Input

Item	Value
Character set	digits, read as one integer
Length	a value from 4 to 64570080
Check	none
Extra parameters	none

Examples

A value in the middle of the range

<?php

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

$barcode = new \Com\Tecnick\Barcode\Barcode();
$bobj = $barcode->getBarcodeObj(
 type: 'PHARMA2T',
 code: '123456',
 width: -3,
 height: -30,
 color: 'black',
 padding: [0, 0, 0, 0],
)->setBackgroundColor('white');

echo $bobj->getInlineSvgCode();

PLANET

Sun, 20 Sep 2026 00:00:00 +0000

PLANET is POSTNET with the tall and short bars exchanged: three tall bars per digit instead of two. The USPS used it to track mail through the network rather than to route it, and retired both formats together.

Type Token

Item	Value
Type token	`PLANET`
Enum case	`BarcodeType::PLANET`
Family	Postal
Standard	USPS-B-3200
Class	`\Com\Tecnick\Barcode\Type\Linear\Planet`

Input

Item	Value
Character set	digits
Length	11 or 13 digits in practice; the library accepts any number of them
Check	modulo 10, appended by the library
Extra parameters	none

Examples

A tracking number

<?php

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

$barcode = new \Com\Tecnick\Barcode\Barcode();
$bobj = $barcode->getBarcodeObj(
 type: 'PLANET',
 code: '0123456789',
 width: -3,
 height: -30,
 color: 'black',
 padding: [0, 0, 0, 0],
)->setBackgroundColor('white');

echo $bobj->getInlineSvgCode();

Plessey

Sun, 20 Sep 2026 00:00:00 +0000

The older of the pair, from the 1970s. Plessey encodes hexadecimal digits and protects them with an eight-bit cyclic redundancy check rather than a modulo check digit; the library appends the CRC bits and the reversed terminator.

Type Token

Item	Value
Type token	`PLESSEY`
Enum case	`BarcodeType::PLESSEY`
Family	Linear
Class	`\Com\Tecnick\Barcode\Type\Linear\Plessey`

Input

Item	Value
Character set	`0-9` and `A-F`, upper or lower case
Length	1 to 30000 characters
Check	an 8-bit CRC, appended by the library
Extra parameters	none

Examples

Sixteen hexadecimal digits

<?php

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

$barcode = new \Com\Tecnick\Barcode\Barcode();
$bobj = $barcode->getBarcodeObj(
 type: 'PLESSEY',
 code: '0123456789ABCDEF',
 width: -1,
 height: -30,
 color: 'black',
 padding: [0, 0, 0, 0],
)->setBackgroundColor('white');

echo $bobj->getInlineSvgCode();

POSTNET

Sun, 20 Sep 2026 00:00:00 +0000

POSTNET encodes a ZIP code in bar height rather than bar width: five bars per digit, two of them tall. It carried the ZIP, the ZIP+4 or the eleven-digit delivery point code, and the United States Postal Service retired it in favour of the Intelligent Mail Barcode.

Type Token

Item	Value
Type token	`POSTNET`
Enum case	`BarcodeType::POSTNET`
Family	Postal
Standard	USPS-B-3200
Class	`\Com\Tecnick\Barcode\Type\Linear\Postnet`

Input

Item	Value
Character set	digits
Length	5, 9 or 11 digits in practice; the library accepts any number of them
Check	modulo 10, appended by the library
Extra parameters	none

Examples

A ZIP+4 code

<?php

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

$barcode = new \Com\Tecnick\Barcode\Barcode();
$bobj = $barcode->getBarcodeObj(
 type: 'POSTNET',
 code: '123456789',
 width: -3,
 height: -30,
 color: 'black',
 padding: [0, 0, 0, 0],
)->setBackgroundColor('white');

echo $bobj->getInlineSvgCode();

PZN (Pharmazentralnummer)

Sun, 20 Sep 2026 00:00:00 +0000

Pharmaceutical products in the German supply chain are identified by a Pharmazentralnummer, allocated by IFA GmbH. The library draws it as a CODE 39 symbol with the leading dash and the modulo 11 check digit that the PZN-8 scheme requires.

Type Token

Item	Value
Type token	`PZN`
Enum case	`BarcodeType::PZN`
Family	Linear
Standard	IFA coding system, PZN-8
Class	`\Com\Tecnick\Barcode\Type\Linear\Pzn`

Input

Item	Value
Character set	digits
Length	7 digits, or 8 with a valid check digit
Check	modulo 11, appended by the library
Extra parameters	none

Examples

A Pharmazentralnummer

<?php

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

$barcode = new \Com\Tecnick\Barcode\Barcode();
$bobj = $barcode->getBarcodeObj(
 type: 'PZN',
 code: '2758089',
 width: -3,
 height: -30,
 color: 'black',
 padding: [0, 0, 0, 0],
)->setBackgroundColor('white');

echo $bobj->getInlineSvgCode();

QR Code

Sun, 20 Sep 2026 00:00:00 +0000

Denso Wave designed the QR Code in 1994 to track parts on a production line, and its three finder patterns are why a phone can read one at any angle. Forty versions, from 21 modules square to 177, and four error correction levels that trade capacity for damage tolerance: L recovers about 7 per cent of the symbol, H about 30.

Leave the version at 0 and the library picks the smallest symbol the data fits. QR Code is a registered trademark of DENSO WAVE INCORPORATED.

RGB

Sun, 20 Sep 2026 00:00:00 +0000

Three additive channels, each a fraction between 0 and 1. Every hex code and colour name parses into this model, and every conversion passes through it: toCmykArray() on an Hsl object converts to RGB first.

Model

Item	Value
Type string	`RGB`
Enum case	`ColorModelType::Rgb`
Class	`\Com\Tecnick\Color\Model\Rgb`
PDF colour space	DeviceRGB
Notations	`#RGB`, `#RGBA`, `#RRGGBB`, `#RRGGBBAA`, colour names, `rgb()`, `rgba()`, `["RGB",r,g,b]`

Components

Component	Key	Range	Out of range
Red	`red`	0.0 to 1.0	clamped
Green	`green`	0.0 to 1.0	clamped
Blue	`blue`	0.0 to 1.0	clamped
Alpha	`alpha`	0.0 to 1.0, default 1.0	clamped

Construction

<?php

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

$rgb = new \Com\Tecnick\Color\Model\Rgb([
 'red' => 0.2,
 'green' => 0.4,
 'blue' => 0.6,
]);

echo $rgb->getCssColor(), "\n";
echo $rgb->getRgbHexColor(), "\n";

rgb(51,102,153)
#336699

Output

Every accessor, against #336699:

RM4SCC

Sun, 20 Sep 2026 00:00:00 +0000

Royal Mail’s customer code puts its data in the shape of each bar: ascender, descender, both, or neither. Four states over four bars give 36 values per character, which is what an alphanumeric UK postcode needs.

Type Token

Item	Value
Type token	`RMS4CC`
Enum case	`BarcodeType::RMS4CC`
Family	Postal
Standard	RM4SCC
Class	`\Com\Tecnick\Barcode\Type\Linear\RoyalMailFourCc`

Input

Item	Value
Character set	`0-9` and `A-Z`
Length	1 to 30000 characters
Check	one check character, appended by the library
Extra parameters	none

Examples

A postcode and delivery point

<?php

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

$barcode = new \Com\Tecnick\Barcode\Barcode();
$bobj = $barcode->getBarcodeObj(
 type: 'RMS4CC',
 code: 'SN34RD1A',
 width: -3,
 height: -30,
 color: 'black',
 padding: [0, 0, 0, 0],
)->setBackgroundColor('white');

echo $bobj->getInlineSvgCode();

Royal Mail Mailmark

Sun, 20 Sep 2026 00:00:00 +0000

Mailmark replaced RM4SCC for bulk mail, adding the reporting data that the service is built on. The application string is 22 characters for the C barcode or 26 for the L, and packs a format code, a version, a class, the Supply Chain ID that Royal Mail issues, an item identifier and the destination postcode.

The two lengths are the two barcode types; nothing else selects between them.

Type Token

Item	Value
Type token	`MAILMARK`
Enum case	`BarcodeType::MAILMARK`
Family	Postal
Standard	Royal Mail Mailmark
Class	`\Com\Tecnick\Barcode\Type\Linear\Mailmark`

Input

Item	Value
Character set	`0-9`, `A-Z` and space, with the field-by-field rules of the specification
Length	exactly 22 characters for type C, or 26 for type L
Check	Reed-Solomon check symbols, computed by the library
Extra parameters	none

Examples

A type C application string

<?php

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

$barcode = new \Com\Tecnick\Barcode\Barcode();
$bobj = $barcode->getBarcodeObj(
 type: 'MAILMARK',
 code: '41038422416563762EF61AH8T ',
 width: -3,
 height: -30,
 color: 'black',
 padding: [0, 0, 0, 0],
)->setBackgroundColor('white');

echo $bobj->getInlineSvgCode();

Square Raw Mode

Sun, 20 Sep 2026 00:00:00 +0000

This is a custom format rather than a published symbology, the two-dimensional counterpart of LRAW. It allows a module grid computed elsewhere to be drawn as it is: rows of 0 and 1 separated by commas, one character per module, every row the same length.

Type Token

Item	Value
Type token	`SRAW`
Enum case	`BarcodeType::SRAW`
Family	2D
Class	`\Com\Tecnick\Barcode\Type\Square\Raw`

Input

Item	Value
Character set	`0` and `1`, with `,` separating the rows
Length	any grid whose rows are all the same length
Check	none
Extra parameters	none

Examples

A four by four grid

<?php

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

$barcode = new \Com\Tecnick\Barcode\Barcode();
$bobj = $barcode->getBarcodeObj(
 type: 'SRAW',
 code: '0101,1010,1100,0011',
 width: -4,
 height: -4,
 color: 'black',
 padding: [0, 0, 0, 0],
)->setBackgroundColor('white');

echo $bobj->getInlineSvgCode();

SSCC-18

Sun, 20 Sep 2026 00:00:00 +0000

An SSCC identifies one logistic unit, a pallet or a carton, uniquely and for as long as it exists. The symbol is a GS1-128 carrying Application Identifier 00, and this type takes the plain digits and builds the element string for you.

Type Token

Item	Value
Type token	`SSCC18`
Enum case	`BarcodeType::SSCC18`
Family	Linear
Standard	GS1 General Specifications
Class	`\Com\Tecnick\Barcode\Type\Linear\SsccOneEight`

Input

Item	Value
Character set	digits
Length	17 digits, or 18 with a valid check digit
Check	modulo 10, appended when the payload is 17 digits and verified when it is 18
Extra parameters	none

Examples

A serial shipping container code

<?php

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

$barcode = new \Com\Tecnick\Barcode\Barcode();
$bobj = $barcode->getBarcodeObj(
 type: 'SSCC18',
 code: '39501101020917171',
 width: -3,
 height: -30,
 color: 'black',
 padding: [0, 0, 0, 0],
)->setBackgroundColor('white');

echo $bobj->getInlineSvgCode();

Standard 2 of 5

Sun, 20 Sep 2026 00:00:00 +0000

Two of the five bars in each character are wide, which is where the family takes its name. Only the bars carry data here and the spaces separate them, so the symbol is wide and very tolerant of poor printing. Digits only.

Type Token

Item	Value
Type token	`S25`
Enum case	`BarcodeType::S25`
Family	Linear
Class	`\Com\Tecnick\Barcode\Type\Linear\StandardTwoOfFive`

Input

Item	Value
Character set	digits
Length	1 to 30000 characters
Check	none. Use `S25+` for the modulo 10 check digit
Extra parameters	none

Examples

Ten digits

<?php

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

$barcode = new \Com\Tecnick\Barcode\Barcode();
$bobj = $barcode->getBarcodeObj(
 type: 'S25',
 code: '0123456789',
 width: -3,
 height: -30,
 color: 'black',
 padding: [0, 0, 0, 0],
)->setBackgroundColor('white');

echo $bobj->getInlineSvgCode();

Standard 2 of 5 with check digit

Sun, 20 Sep 2026 00:00:00 +0000

Standard 2 of 5 with a modulo 10 check digit computed over the payload and appended before encoding.

Type Token

Item	Value
Type token	`S25+`
Enum case	`BarcodeType::S25Plus`
Family	Linear
Class	`\Com\Tecnick\Barcode\Type\Linear\StandardTwoOfFiveCheck`

Input

Item	Value
Character set	digits
Length	1 to 30000 characters
Check	modulo 10, appended by the library
Extra parameters	none

Examples

Ten digits and the appended check

<?php

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

$barcode = new \Com\Tecnick\Barcode\Barcode();
$bobj = $barcode->getBarcodeObj(
 type: 'S25+',
 code: '0123456789',
 width: -3,
 height: -30,
 color: 'black',
 padding: [0, 0, 0, 0],
)->setBackgroundColor('white');

echo $bobj->getInlineSvgCode();

Telepen

Sun, 20 Sep 2026 00:00:00 +0000

Telepen encodes the full ASCII range at a constant width per character, which makes the symbol length predictable from the payload length alone. Every symbol carries a modulo 127 check character. Telepen is a trademark of SB Electronic Systems.

Type Token

Item	Value
Type token	`TELEPEN`
Enum case	`BarcodeType::TELEPEN`
Family	Linear
Class	`\Com\Tecnick\Barcode\Type\Linear\Telepen`

Input

Item	Value
Character set	the 128 ASCII characters
Length	1 to 30000 characters
Check	modulo 127, appended by the library
Extra parameters	none

Examples

Letters and digits

<?php

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

$barcode = new \Com\Tecnick\Barcode\Barcode();
$bobj = $barcode->getBarcodeObj(
 type: 'TELEPEN',
 code: 'ABC123',
 width: -3,
 height: -30,
 color: 'black',
 padding: [0, 0, 0, 0],
)->setBackgroundColor('white');

echo $bobj->getInlineSvgCode();

UPC-A

Sun, 20 Sep 2026 00:00:00 +0000

The twelve-digit North American retail symbol, and the oldest of this family: the first UPC-A was scanned in 1974. It is an EAN-13 with a leading zero, and the library encodes it as one, which is why getExtendedCode() returns thirteen digits.

Type Token

Item	Value
Type token	`UPCA`
Enum case	`BarcodeType::UPCA`
Family	Linear
Standard	ISO/IEC 15420, GS1 General Specifications
Class	`\Com\Tecnick\Barcode\Type\Linear\UpcA`

Input

Item	Value
Character set	digits, plus `+` to introduce an add-on
Length	11 digits, or 12 with a valid check digit
Check	modulo 10, appended when the payload is 11 digits and verified when it is 12
Extra parameters	none

Examples

A product code

<?php

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

$barcode = new \Com\Tecnick\Barcode\Barcode();
$bobj = $barcode->getBarcodeObj(
 type: 'UPCA',
 code: '72527273070',
 width: -3,
 height: -30,
 color: 'black',
 padding: [0, 0, 0, 0],
)->setBackgroundColor('white');

echo $bobj->getInlineSvgCode();

UPC-E

Sun, 20 Sep 2026 00:00:00 +0000

Six digits instead of twelve, for packages too small to carry UPC-A. The compression works by suppressing runs of zeros in the manufacturer and product fields, so only UPC-A codes with the right zero pattern have a UPC-E form at all.

A code with no UPC-E form is rejected at encode time, before it reaches a label.

Type Token

Item	Value
Type token	`UPCE`
Enum case	`BarcodeType::UPCE`
Family	Linear
Standard	ISO/IEC 15420, GS1 General Specifications
Class	`\Com\Tecnick\Barcode\Type\Linear\UpcE`

Input

Item	Value
Character set	digits, plus `+` to introduce an add-on
Length	6 digits, or the 8 or 12 digit form it expands to
Check	computed from the expanded UPC-A form
Extra parameters	none

Examples

A compressed product code

<?php

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

$barcode = new \Com\Tecnick\Barcode\Barcode();
$bobj = $barcode->getBarcodeObj(
 type: 'UPCE',
 code: '725277',
 width: -3,
 height: -30,
 color: 'black',
 padding: [0, 0, 0, 0],
)->setBackgroundColor('white');

echo $bobj->getInlineSvgCode();

Examples

Sun, 26 Apr 2026 00:00:00 +0000

Every example below is a standalone PHP script from the tc-lib-pdf repository, shipped with the PDF it produces. Each page embeds both, and links to the raw .pdf and the .phps source so they can be downloaded or read directly.

The scripts live in examples/ in the repository and run in place, because local file reads are restricted to an allowlist covering the package tree. Fonts must be generated first: see /docs/fonts/.

Documentation

Sun, 19 Apr 2026 00:00:00 +0000

One guide per topic. Start with fonts, since nothing renders until they have been generated.

Guides

/docs/fonts/ : installation-time font generation, custom font import, third-party font licences.
/docs/html-css/ : addHTMLCell(), the cascade, the supported CSS subset, tables, forms, and page flow.
/docs/development/ : local QA, the preflight matrix, RPM and DEB packaging.
/docs/enums/ : the typed enums exposed across the tc-lib stack.
/docs/remote-resources/ : host and path allowlists, cURL policy, the full fileOptions reference.
/docs/digital-signatures/ : CMS and PAdES signatures, RFC 3161 timestamps, LTV material.
/docs/standards/ : PDF/A, PDF/X and PDF/UA modes, hybrid invoices, reproducible output.
/docs/pdf-import/ : importing and placing pages from existing PDFs.
/docs/cache/ : the optional external cache for font subsets and images.
/docs/ai-assistants/ : using tc-lib-pdf with LLM coding assistants, and the legacy TCPDF API they reach for by default.
/docs/srcdoc/ : generated API reference for every package.
/docs/license/ : the full LGPL-3.0-or-later text.

Quick Links

Feature index: /features/
Library comparison: /comparison/
API docs: /docs/srcdoc/tc-lib-pdf
Examples index: /examples/
Package ecosystem: /projects/
Machine-readable site index: /llms.txt
Project overview: /

tc-lib Projects

Sun, 19 Apr 2026 00:00:00 +0000

tc-lib-pdf composes a set of independently versioned Composer packages. Installing tecnickcom/tc-lib-pdf pulls the ones it needs; each can also be required on its own by a project that wants only that piece.

Every package targets PHP 8.2 or later, is published under LGPL-3.0-or-later, and has generated API reference under /docs/srcdoc/.

Document Generation

tc-lib-pdf : the top-level library. Document authoring, text and HTML layout, page management, and PDF output. API reference · GitHub · Packagist
tc-lib-pdf-page : page geometry, formats, margins, the five page boxes, page groups, and page-level attributes.
tc-lib-pdf-graph : vector primitives, the graphics style stack, transformations, transparency, and shadings.

Text and Fonts

tc-lib-pdf-font : font loading, parsing, subsetting, embedding, and the font data generation step. See also /docs/fonts/.
tc-lib-unicode : Unicode string processing, the bidirectional algorithm (UAX #9), normalization, and Arabic shaping.
tc-lib-unicode-data : the generated Unicode character data tables that tc-lib-unicode reads.

Colour, Images, and Barcodes

tc-lib-color : colour parsing and conversion across RGB, HSL, CMYK, Lab, grayscale, and spot colours, for both CSS and PDF output. One page per colour model, plus the notations the parser accepts and the 150 named colours.
tc-lib-pdf-image : image loading, PNG and JPEG parsing, transparency and soft masks, ICC profiles, and embedding.
tc-lib-barcode : 73 linear, postal, GS1, and two-dimensional barcode symbologies, rendered as PNG, SVG, HTML, or PDF operators. One page per symbology under Linear, 2D and Postal.

Reading, Encryption, and Signing

tc-lib-pdf-parser : reads existing PDF files, for import and manipulation. See also /docs/pdf-import/.
tc-lib-pdf-filter : PDF stream filters and predictors, used when decoding parsed content.
tc-lib-pdf-encrypt : document encryption and permissions, from RC4-40 to AES-256 R6, including public-key recipients.
tc-lib-pdf-sign : signature primitives (PKCS#7, CAdES, PAdES baseline), RFC 3161 timestamps, and LTV material. See also /docs/digital-signatures/.

Support

tc-lib-file : file and data-URI helpers used internally for asset loading, with the local path and remote host allowlists. See also /docs/remote-resources/.

Quick Links

Project overview: /
Feature index: /features/
Runnable examples: /examples/
Guides: /docs/
Generated API reference: /docs/srcdoc/

Search

Mon, 01 Jan 0001 00:00:00 +0000

Features

Mon, 31 Aug 2026 00:00:00 +0000

What the library provides, grouped by area, with a link to the guide or the runnable example that covers each item. For how this compares with the other PHP PDF tools, see /comparison/.

Pages and Layout

Named page formats: ISO, ANSI, JIS, envelope, photographic and other series, plus arbitrary custom sizes. See /examples/E004_page_formats/.
Portrait, landscape, and orientation derived from the requested size.
Units of points, millimetres, centimetres, and inches, selected per document.
The five page boxes (MediaBox, CropBox, BleedBox, TrimBox, ArtBox), each with its BoxColorInfo guidelines, and omitPageBox() / keepPageBox() for the ISO 15930 rule that a page declares a TrimBox or an ArtBox but not both. See /examples/E048_page_boxes_prepress/.
Page, header, content, and footer margins, with mirrored gutters in booklet mode.
Writable regions: equal columns, or rectangles computed around reserved areas that text and HTML flow must avoid. See /examples/E080_no_write_regions/.
Page stack operations: add, clone, move, delete, and select, with page groups for per-group numbering. See /examples/E054_page_groups_numbering/ and /examples/E055_page_reorder_booklet/.
Page number aliases (~#PN for the page number, ~#PT for the total pages of the group) resolved at output time, in text written with any font type, in /ActualText, and in XObjects, keeping the aligned edge of centered, right-aligned, and justified lines.
Page rotation, preferred zoom, and page transitions.
Headers, footers, and default page content. See /examples/E005_header_footer/.
Per-page transparency group control, with the group omitted on fully opaque pages.

Text and Typography

Text cells with horizontal alignment (left, centre, right, justified) and vertical alignment (top, centre, bottom, ascent, baseline, descent). See /examples/E023_cell_alignment/.
Overflow fit modes: truncate, stretch, or shrink the font to the cell. See /examples/E074_text_cell_fit_modes/.
Line wrapping and line height control. See /examples/E083_text_line_wrap/.
Line break controls: soft hyphen, zero width space, word joiner, and zero width no-break space, kept through the bidirectional reordering.
A word wider than the line broken between two characters, switchable through enableWordBreakFallback(), and line breaks after a hyphen joining two letters, switchable through enableHyphenBreaks().
Hyphenation, including custom dictionaries. See /examples/E028_text_hyphenation/ and /examples/E064_custom_hyphenation_dictionary/.
Font stretching and character spacing, combinable in one matrix. See /examples/E079_font_stretch_spacing_matrix/.
Text rendering modes: fill, stroke, fill and stroke, invisible, and the clipping variants. See /examples/E026_text_rendering_modes/.
Measured output: getTextCell() returns the operators plus the bounding box and metrics, so text can be positioned from what it actually measures. See /examples/E071_gettextcell_bbox_metrics/.
Absolute positioning alongside flowed content. See /examples/E076_absolute_position/.
Cell borders and background fills. See /examples/E022_cell_borders/.

Multilingual Text

Unicode 17 character data, generated from UCD 17.0.0.
Unicode Bidirectional Algorithm (UAX #9), verified against the official BidiCharacterTest.txt and BidiTest.txt conformance suites. See /examples/E062_bidi_mixed_rtl_ltr/.
Forced paragraph direction (auto, right-to-left, left-to-right) per text call.
Line breaking of mixed-direction text, with each wrapped line reordered on its own. See /examples/E085_bidi_line_break/.
Line breaking of Chinese, Japanese, and Korean text without spaces, with the UAX #14 line start and end rules, switchable through enableIdeographicBreaks(). See /examples/E086_cjk_line_break/.
Arabic shaping driven by the Joining_Type property, with lam-alef and allah ligatures placed so combining marks keep following their base. See /examples/E003_rtl_languages/.
Devanagari left-positional matra reordering and Hangul Jamo composition into precomposed syllables.
Coverage checks across scripts. See /examples/E046_pangrams/.

Two boundaries are worth knowing. Shaping is codepoint-level substitution rather than OpenType Layout: there is no GSUB or GPOS processing, so the cursive scripts other than Arabic (Syriac, N’Ko, Mandaic, Adlam) are drawn unshaped, and Indic shaping stops at matra reordering. In the bidirectional algorithm, rule L3 (combining marks displayed in a different order) is not implemented, and the paragraph separator is appended to the paragraph output rather than being reset by L1 and reversed by L2.

PHP PDF Libraries Compared

Mon, 31 Aug 2026 00:00:00 +0000

A feature comparison of the PDF tools most often used from PHP. For the full tc-lib-pdf capability index, see /features/.

Two classes of tool are compared separately, because they solve different problems: libraries that write PDF from PHP, and renderers that drive a browser engine and return its print output.

Versions, licences, and PHP requirements come from Packagist. Capabilities come from each project’s own documentation and source, cover what the package itself provides without third-party extensions, and were checked on 2026-08-31. Corrections are welcome: open an issue on tc-lib-pdf.

Sponsor

Mon, 01 Jan 0001 00:00:00 +0000

tc-lib-pdf, the legacy TCPDF (installed 100M+ times), and the wider tc-lib package stack are built and maintained by Nicola Asuni (Tecnick.com LTD). For over 25 years this has been free, open-source infrastructure that thousands of products and research pipelines depend on every day.

Sponsorship pays for the unglamorous half of that: security fixes, tracking standards revisions, and answering issues. If your company ships one of these packages, it is closer to an insurance premium than to a donation.

Legal

Mon, 01 Jan 0001 00:00:00 +0000

Trademarks

Any trademarks, service marks, collective marks, design rights, personality rights or similar rights that are mentioned, used or cited on this website are the property of their respective owners. Unless otherwise stated, this website and its owners are neither endorsed by nor affiliated with any of the holders of such rights, and cannot grant any rights to use otherwise protected materials. Your use of any such property is at your own risk.

HTML and CSS

Tue, 08 Sep 2026 00:00:00 +0000

tc-lib-pdf renders a subset of HTML and CSS directly, with no browser engine involved. Markup goes into a placed block on the page, and the engine resolves the cascade, the box model, floats, tables, and page breaks itself.

The Two Entry Points

public addHTMLCell(
 string $html,
 float $posx = 0,
 float $posy = 0,
 float $width = 0,
 float $height = 0,
 ?TCellDef $cell = null,
 array $styles = [],
): void

public getHTMLCell(/* the same parameters */): string

addHTMLCell() writes the result into the document. It accounts for automatic page and region breaks, appending content to each page stream the block reaches, so a block longer than the remaining space continues onto the following pages.

Development and Packaging

Mon, 08 Jun 2026 00:00:00 +0000

Composer is how tc-lib-pdf is normally installed. This page covers the other side: working on the library itself, and building the RPM and DEB packages that some deployment models need.

Development Workflow

Use the project Makefile as the main entry point for local development tasks:

# Install all development dependencies
make deps

# List all available Make targets
make help

# Run the full quality pipeline (dependency checks, formatting, lint, static analysis, tests)
make qa

# Run the same checks and produce the coverage report
make qa-coverage

# Generate one sample per conformance mode and run the external validators (if installed)
make preflight

Build artifacts and reports are written to target/.

Typed Enums

Thu, 06 Aug 2026 00:00:00 +0000

String options such as page units, conformance modes, alignment codes, blend modes, barcode types, filter names, and signature profiles are also available as backed enums. The enums make the accepted values discoverable from the IDE and checkable by static analysis, and the plain strings remain accepted everywhere.

The enum-with-union-type Pattern

Every affected parameter is declared as a string|Enum union, and the backing value of each enum case is exactly the equivalent string:

Remote Resources

Thu, 06 Aug 2026 00:00:00 +0000

By default tc-lib-pdf does not fetch remote URLs. Images, fonts, and SVG files referenced by HTTP or HTTPS are blocked unless you explicitly allow the originating hosts. Local file reads are split between internal library IO and markup-originated resource loads, with separate allowlists.

How Remote Access Is Controlled

Remote access is configured through the optional fileOptions array passed as the last argument to the Tcpdf constructor (and forwarded to initClassObjects()).

Digital Signatures

Fri, 05 Jun 2026 00:00:00 +0000

tc-lib-pdf produces detached CMS (PKCS#7) signatures and PAdES baseline signatures (ETSI EN 319 142-1) with optional RFC 3161 timestamps, LTV (Long-Term Validation) material, and archive timestamps. The signature itself is embedded in the signed revision; LTV material and archive timestamps are written in further incremental revisions. The cryptography lives in the companion package tc-lib-pdf-sign, while the host library keeps the ByteRange placement, the incremental update writer, and the public facade.

Standards and Conformance

Fri, 05 Jun 2026 00:00:00 +0000

tc-lib-pdf has conformance modes for archival (PDF/A), print exchange (PDF/X) and accessible tagged output (PDF/UA). Selecting one changes what the library emits: features the standard forbids are suppressed, the metadata it requires is written, and the problems that cannot be fixed without discarding your content are reported instead. See Conformance Warnings.

PDF/A Archival

Use the mode constructor argument to select the desired PDF/A profile:

$pdf = new \Com\Tecnick\Pdf\Tcpdf(mode: 'pdfa1');
$pdf = new \Com\Tecnick\Pdf\Tcpdf(mode: 'pdfa1a');
$pdf = new \Com\Tecnick\Pdf\Tcpdf(mode: 'pdfa1b');
$pdf = new \Com\Tecnick\Pdf\Tcpdf(mode: 'pdfa2a');
$pdf = new \Com\Tecnick\Pdf\Tcpdf(mode: 'pdfa2b');
$pdf = new \Com\Tecnick\Pdf\Tcpdf(mode: 'pdfa2u');
$pdf = new \Com\Tecnick\Pdf\Tcpdf(mode: 'pdfa3a');
$pdf = new \Com\Tecnick\Pdf\Tcpdf(mode: 'pdfa3b');
$pdf = new \Com\Tecnick\Pdf\Tcpdf(mode: 'pdfa3u');

The mode argument is declared as string|PdfConformance, so every mode is also available as a case of the \Com\Tecnick\Pdf\PdfConformance enum:

PDF Import

Fri, 05 Jun 2026 00:00:00 +0000

tc-lib-pdf can import pages from existing PDFs as Form XObjects and place them on destination pages.

Register A Source

$sourceId = $pdf->setImportSourceFile('/path/to/source.pdf');
// or: $sourceId = $pdf->setImportSourceData($rawPdfBytes);

$count = $pdf->getSourcePageCount($sourceId);

setImportSourceFile() reads the file through the same local path allowlist as other resources: the path must be inside one of the allowedPaths file options (see /docs/remote-resources/). A path outside the allowlist raises ImportSourceNotFoundException, as a missing file does. setImportSourceData() takes the bytes directly and performs no path check.

External Cache

Thu, 06 Aug 2026 00:00:00 +0000

tc-lib-pdf can reuse generated font subsets and processed images across Tcpdf instances and PHP processes through an optional external cache that you provide.

No cache backend is shipped: you implement an interface that bridges to your own store (filesystem, APCu, Redis, a PSR-16 cache, and so on). Caching is disabled by default.

One cache instance is reused by every cacheable subsystem (font subsets and images), so a single backend, connection, and configuration serves them all.

Fonts

Sun, 19 Apr 2026 00:00:00 +0000

tc-lib-pdf delegates font parsing, subsetting, embedding, and generated font data to tc-lib-pdf-font.

How the Font Stack Is Split

tc-lib-pdf: document generation, text layout, and PDF output orchestration.
tc-lib-pdf-font: font loading, parsing, subsetting, embedding, and font data generation.

This package boundary keeps the core PDF engine focused and lets the font pipeline evolve independently.

Supported Font Types

The tc-lib ecosystem supports the major font classes expected in production PDF workflows:

AI Coding Assistants

Tue, 08 Sep 2026 00:00:00 +0000

Some of the readers of this documentation are language models writing code on someone’s behalf. This page collects what the project publishes for them, and what to tell an assistant so its output runs.

Machine-Readable Indexes

/llms.txt: a condensed index of this site in the llms.txt format, with one entry per guide, per package, and per example group, so an assistant can find the right page without crawling the whole site.
/docs/srcdoc/: the generated API reference for every class in every package, one page per class.
/examples/: 95 runnable scripts, each page carrying a description, the rendered PDF, and the PHP source at a stable /files/examples/ URL.
/features/: the capability index, area by area.

Everything is plain HTML with no JavaScript required, and robots.txt allows every crawler, retrieval agents included. The .phps sources are served as plain text, so an assistant can fetch a whole example directly, for instance https://tcpdf.org/files/examples/E006_minimal.phps.

Free Software License

Sat, 01 Jan 2005 00:00:00 +0000

**********************************************************************
* LICENSE
*
* SOFTWARE : tc-lib-pdf
* AUTHOR : Nicola Asuni 
* COPYRIGHT : 2002-2026 Nicola Asuni - Tecnick.com LTD
**********************************************************************

 This is free software: you can redistribute it and/or modify it
 under the terms of the GNU Lesser General Public License as
 published by the Free Software Foundation, either version 3 of the
 License, or (at your option) any later version.

**********************************************************************
**********************************************************************

 GNU LESSER GENERAL PUBLIC LICENSE
 Version 3, 29 June 2007

 Copyright (C) 2007 Free Software Foundation, Inc. 
 Everyone is permitted to copy and distribute verbatim copies
 of this license document, but changing it is not allowed.


 This version of the GNU Lesser General Public License incorporates
the terms and conditions of version 3 of the GNU General Public
License, supplemented by the additional permissions listed below.

 0. Additional Definitions.

 As used herein, "this License" refers to version 3 of the GNU Lesser
General Public License, and the "GNU GPL" refers to version 3 of the GNU
General Public License.

 "The Library" refers to a covered work governed by this License,
other than an Application or a Combined Work as defined below.

 An "Application" is any work that makes use of an interface provided
by the Library, but which is not otherwise based on the Library.
Defining a subclass of a class defined by the Library is deemed a mode
of using an interface provided by the Library.

 A "Combined Work" is a work produced by combining or linking an
Application with the Library. The particular version of the Library
with which the Combined Work was made is also called the "Linked
Version".

 The "Minimal Corresponding Source" for a Combined Work means the
Corresponding Source for the Combined Work, excluding any source code
for portions of the Combined Work that, considered in isolation, are
based on the Application, and not on the Linked Version.

 The "Corresponding Application Code" for a Combined Work means the
object code and/or source code for the Application, including any data
and utility programs needed for reproducing the Combined Work from the
Application, but excluding the System Libraries of the Combined Work.

 1. Exception to Section 3 of the GNU GPL.

 You may convey a covered work under sections 3 and 4 of this License
without being bound by section 3 of the GNU GPL.

 2. Conveying Modified Versions.

 If you modify a copy of the Library, and, in your modifications, a
facility refers to a function or data to be supplied by an Application
that uses the facility (other than as an argument passed when the
facility is invoked), then you may convey a copy of the modified
version:

 a) under this License, provided that you make a good faith effort to
 ensure that, in the event an Application does not supply the
 function or data, the facility still operates, and performs
 whatever part of its purpose remains meaningful, or

 b) under the GNU GPL, with none of the additional permissions of
 this License applicable to that copy.

 3. Object Code Incorporating Material from Library Header Files.

 The object code form of an Application may incorporate material from
a header file that is part of the Library. You may convey such object
code under terms of your choice, provided that, if the incorporated
material is not limited to numerical parameters, data structure
layouts and accessors, or small macros, inline functions and templates
(ten or fewer lines in length), you do both of the following:

 a) Give prominent notice with each copy of the object code that the
 Library is used in it and that the Library and its use are
 covered by this License.

 b) Accompany the object code with a copy of the GNU GPL and this license
 document.

 4. Combined Works.

 You may convey a Combined Work under terms of your choice that,
taken together, effectively do not restrict modification of the
portions of the Library contained in the Combined Work and reverse
engineering for debugging such modifications, if you also do each of
the following:

 a) Give prominent notice with each copy of the Combined Work that
 the Library is used in it and that the Library and its use are
 covered by this License.

 b) Accompany the Combined Work with a copy of the GNU GPL and this license
 document.

 c) For a Combined Work that displays copyright notices during
 execution, include the copyright notice for the Library among
 these notices, as well as a reference directing the user to the
 copies of the GNU GPL and this license document.

 d) Do one of the following:

 0) Convey the Minimal Corresponding Source under the terms of this
 License, and the Corresponding Application Code in a form
 suitable for, and under terms that permit, the user to
 recombine or relink the Application with a modified version of
 the Linked Version to produce a modified Combined Work, in the
 manner specified by section 6 of the GNU GPL for conveying
 Corresponding Source.

 1) Use a suitable shared library mechanism for linking with the
 Library. A suitable mechanism is one that (a) uses at run time
 a copy of the Library already present on the user's computer
 system, and (b) will operate properly with a modified version
 of the Library that is interface-compatible with the Linked
 Version.

 e) Provide Installation Information, but only if you would otherwise
 be required to provide such information under section 6 of the
 GNU GPL, and only to the extent that such information is
 necessary to install and execute a modified version of the
 Combined Work produced by recombining or relinking the
 Application with a modified version of the Linked Version. (If
 you use option 4d0, the Installation Information must accompany
 the Minimal Corresponding Source and Corresponding Application
 Code. If you use option 4d1, you must provide the Installation
 Information in the manner specified by section 6 of the GNU GPL
 for conveying Corresponding Source.)

 5. Combined Libraries.

 You may place library facilities that are a work based on the
Library side by side in a single library together with other library
facilities that are not Applications and are not covered by this
License, and convey such a combined library under terms of your
choice, if you do both of the following:

 a) Accompany the combined library with a copy of the same work based
 on the Library, uncombined with any other library facilities,
 conveyed under the terms of this License.

 b) Give prominent notice with the combined library that part of it
 is a work based on the Library, and explaining where to find the
 accompanying uncombined form of the same work.

 6. Revised Versions of the GNU Lesser General Public License.

 The Free Software Foundation may publish revised and/or new versions
of the GNU Lesser General Public License from time to time. Such new
versions will be similar in spirit to the present version, but may
differ in detail to address new problems or concerns.

 Each version is given a distinguishing version number. If the
Library as you received it specifies that a certain numbered version
of the GNU Lesser General Public License "or any later version"
applies to it, you have the option of following the terms and
conditions either of that published version or of any later version
published by the Free Software Foundation. If the Library as you
received it does not specify a version number of the GNU Lesser
General Public License, you may choose any version of the GNU Lesser
General Public License ever published by the Free Software Foundation.

 If the Library as you received it specifies that a proxy can decide
whether future versions of the GNU Lesser General Public License shall
apply, that proxy's public statement of acceptance of any version is
permanent authorization for you to choose that version for the
Library.

**********************************************************************
**********************************************************************

 GNU GENERAL PUBLIC LICENSE
 Version 3, 29 June 2007

 Copyright (C) 2007 Free Software Foundation, Inc. 
 Everyone is permitted to copy and distribute verbatim copies
 of this license document, but changing it is not allowed.

 Preamble

 The GNU General Public License is a free, copyleft license for
software and other kinds of works.

 The licenses for most software and other practical works are designed
to take away your freedom to share and change the works. By contrast,
the GNU General Public License is intended to guarantee your freedom to
share and change all versions of a program--to make sure it remains free
software for all its users. We, the Free Software Foundation, use the
GNU General Public License for most of our software; it applies also to
any other work released this way by its authors. You can apply it to
your programs, too.

 When we speak of free software, we are referring to freedom, not
price. Our General Public Licenses are designed to make sure that you
have the freedom to distribute copies of free software (and charge for
them if you wish), that you receive source code or can get it if you
want it, that you can change the software or use pieces of it in new
free programs, and that you know you can do these things.

 To protect your rights, we need to prevent others from denying you
these rights or asking you to surrender the rights. Therefore, you have
certain responsibilities if you distribute copies of the software, or if
you modify it: responsibilities to respect the freedom of others.

 For example, if you distribute copies of such a program, whether
gratis or for a fee, you must pass on to the recipients the same
freedoms that you received. You must make sure that they, too, receive
or can get the source code. And you must show them these terms so they
know their rights.

 Developers that use the GNU GPL protect your rights with two steps:
(1) assert copyright on the software, and (2) offer you this License
giving you legal permission to copy, distribute and/or modify it.

 For the developers' and authors' protection, the GPL clearly explains
that there is no warranty for this free software. For both users' and
authors' sake, the GPL requires that modified versions be marked as
changed, so that their problems will not be attributed erroneously to
authors of previous versions.

 Some devices are designed to deny users access to install or run
modified versions of the software inside them, although the manufacturer
can do so. This is fundamentally incompatible with the aim of
protecting users' freedom to change the software. The systematic
pattern of such abuse occurs in the area of products for individuals to
use, which is precisely where it is most unacceptable. Therefore, we
have designed this version of the GPL to prohibit the practice for those
products. If such problems arise substantially in other domains, we
stand ready to extend this provision to those domains in future versions
of the GPL, as needed to protect the freedom of users.

 Finally, every program is threatened constantly by software patents.
States should not allow patents to restrict development and use of
software on general-purpose computers, but in those that do, we wish to
avoid the special danger that patents applied to a free program could
make it effectively proprietary. To prevent this, the GPL assures that
patents cannot be used to render the program non-free.

 The precise terms and conditions for copying, distribution and
modification follow.

 TERMS AND CONDITIONS

 0. Definitions.

 "This License" refers to version 3 of the GNU General Public License.

 "Copyright" also means copyright-like laws that apply to other kinds of
works, such as semiconductor masks.

 "The Program" refers to any copyrightable work licensed under this
License. Each licensee is addressed as "you". "Licensees" and
"recipients" may be individuals or organizations.

 To "modify" a work means to copy from or adapt all or part of the work
in a fashion requiring copyright permission, other than the making of an
exact copy. The resulting work is called a "modified version" of the
earlier work or a work "based on" the earlier work.

 A "covered work" means either the unmodified Program or a work based
on the Program.

 To "propagate" a work means to do anything with it that, without
permission, would make you directly or secondarily liable for
infringement under applicable copyright law, except executing it on a
computer or modifying a private copy. Propagation includes copying,
distribution (with or without modification), making available to the
public, and in some countries other activities as well.

 To "convey" a work means any kind of propagation that enables other
parties to make or receive copies. Mere interaction with a user through
a computer network, with no transfer of a copy, is not conveying.

 An interactive user interface displays "Appropriate Legal Notices"
to the extent that it includes a convenient and prominently visible
feature that (1) displays an appropriate copyright notice, and (2)
tells the user that there is no warranty for the work (except to the
extent that warranties are provided), that licensees may convey the
work under this License, and how to view a copy of this License. If
the interface presents a list of user commands or options, such as a
menu, a prominent item in the list meets this criterion.

 1. Source Code.

 The "source code" for a work means the preferred form of the work
for making modifications to it. "Object code" means any non-source
form of a work.

 A "Standard Interface" means an interface that either is an official
standard defined by a recognized standards body, or, in the case of
interfaces specified for a particular programming language, one that
is widely used among developers working in that language.

 The "System Libraries" of an executable work include anything, other
than the work as a whole, that (a) is included in the normal form of
packaging a Major Component, but which is not part of that Major
Component, and (b) serves only to enable use of the work with that
Major Component, or to implement a Standard Interface for which an
implementation is available to the public in source code form. A
"Major Component", in this context, means a major essential component
(kernel, window system, and so on) of the specific operating system
(if any) on which the executable work runs, or a compiler used to
produce the work, or an object code interpreter used to run it.

 The "Corresponding Source" for a work in object code form means all
the source code needed to generate, install, and (for an executable
work) run the object code and to modify the work, including scripts to
control those activities. However, it does not include the work's
System Libraries, or general-purpose tools or generally available free
programs which are used unmodified in performing those activities but
which are not part of the work. For example, Corresponding Source
includes interface definition files associated with source files for
the work, and the source code for shared libraries and dynamically
linked subprograms that the work is specifically designed to require,
such as by intimate data communication or control flow between those
subprograms and other parts of the work.

 The Corresponding Source need not include anything that users
can regenerate automatically from other parts of the Corresponding
Source.

 The Corresponding Source for a work in source code form is that
same work.

 2. Basic Permissions.

 All rights granted under this License are granted for the term of
copyright on the Program, and are irrevocable provided the stated
conditions are met. This License explicitly affirms your unlimited
permission to run the unmodified Program. The output from running a
covered work is covered by this License only if the output, given its
content, constitutes a covered work. This License acknowledges your
rights of fair use or other equivalent, as provided by copyright law.

 You may make, run and propagate covered works that you do not
convey, without conditions so long as your license otherwise remains
in force. You may convey covered works to others for the sole purpose
of having them make modifications exclusively for you, or provide you
with facilities for running those works, provided that you comply with
the terms of this License in conveying all material for which you do
not control copyright. Those thus making or running the covered works
for you must do so exclusively on your behalf, under your direction
and control, on terms that prohibit them from making any copies of
your copyrighted material outside their relationship with you.

 Conveying under any other circumstances is permitted solely under
the conditions stated below. Sublicensing is not allowed; section 10
makes it unnecessary.

 3. Protecting Users' Legal Rights From Anti-Circumvention Law.

 No covered work shall be deemed part of an effective technological
measure under any applicable law fulfilling obligations under article
11 of the WIPO copyright treaty adopted on 20 December 1996, or
similar laws prohibiting or restricting circumvention of such
measures.

 When you convey a covered work, you waive any legal power to forbid
circumvention of technological measures to the extent such circumvention
is effected by exercising rights under this License with respect to
the covered work, and you disclaim any intention to limit operation or
modification of the work as a means of enforcing, against the work's
users, your or third parties' legal rights to forbid circumvention of
technological measures.

 4. Conveying Verbatim Copies.

 You may convey verbatim copies of the Program's source code as you
receive it, in any medium, provided that you conspicuously and
appropriately publish on each copy an appropriate copyright notice;
keep intact all notices stating that this License and any
non-permissive terms added in accord with section 7 apply to the code;
keep intact all notices of the absence of any warranty; and give all
recipients a copy of this License along with the Program.

 You may charge any price or no price for each copy that you convey,
and you may offer support or warranty protection for a fee.

 5. Conveying Modified Source Versions.

 You may convey a work based on the Program, or the modifications to
produce it from the Program, in the form of source code under the
terms of section 4, provided that you also meet all of these conditions:

 a) The work must carry prominent notices stating that you modified
 it, and giving a relevant date.

 b) The work must carry prominent notices stating that it is
 released under this License and any conditions added under section
 7. This requirement modifies the requirement in section 4 to
 "keep intact all notices".

 c) You must license the entire work, as a whole, under this
 License to anyone who comes into possession of a copy. This
 License will therefore apply, along with any applicable section 7
 additional terms, to the whole of the work, and all its parts,
 regardless of how they are packaged. This License gives no
 permission to license the work in any other way, but it does not
 invalidate such permission if you have separately received it.

 d) If the work has interactive user interfaces, each must display
 Appropriate Legal Notices; however, if the Program has interactive
 interfaces that do not display Appropriate Legal Notices, your
 work need not make them do so.

 A compilation of a covered work with other separate and independent
works, which are not by their nature extensions of the covered work,
and which are not combined with it such as to form a larger program,
in or on a volume of a storage or distribution medium, is called an
"aggregate" if the compilation and its resulting copyright are not
used to limit the access or legal rights of the compilation's users
beyond what the individual works permit. Inclusion of a covered work
in an aggregate does not cause this License to apply to the other
parts of the aggregate.

 6. Conveying Non-Source Forms.

 You may convey a covered work in object code form under the terms
of sections 4 and 5, provided that you also convey the
machine-readable Corresponding Source under the terms of this License,
in one of these ways:

 a) Convey the object code in, or embodied in, a physical product
 (including a physical distribution medium), accompanied by the
 Corresponding Source fixed on a durable physical medium
 customarily used for software interchange.

 b) Convey the object code in, or embodied in, a physical product
 (including a physical distribution medium), accompanied by a
 written offer, valid for at least three years and valid for as
 long as you offer spare parts or customer support for that product
 model, to give anyone who possesses the object code either (1) a
 copy of the Corresponding Source for all the software in the
 product that is covered by this License, on a durable physical
 medium customarily used for software interchange, for a price no
 more than your reasonable cost of physically performing this
 conveying of source, or (2) access to copy the
 Corresponding Source from a network server at no charge.

 c) Convey individual copies of the object code with a copy of the
 written offer to provide the Corresponding Source. This
 alternative is allowed only occasionally and noncommercially, and
 only if you received the object code with such an offer, in accord
 with subsection 6b.

 d) Convey the object code by offering access from a designated
 place (gratis or for a charge), and offer equivalent access to the
 Corresponding Source in the same way through the same place at no
 further charge. You need not require recipients to copy the
 Corresponding Source along with the object code. If the place to
 copy the object code is a network server, the Corresponding Source
 may be on a different server (operated by you or a third party)
 that supports equivalent copying facilities, provided you maintain
 clear directions next to the object code saying where to find the
 Corresponding Source. Regardless of what server hosts the
 Corresponding Source, you remain obligated to ensure that it is
 available for as long as needed to satisfy these requirements.

 e) Convey the object code using peer-to-peer transmission, provided
 you inform other peers where the object code and Corresponding
 Source of the work are being offered to the general public at no
 charge under subsection 6d.

 A separable portion of the object code, whose source code is excluded
from the Corresponding Source as a System Library, need not be
included in conveying the object code work.

 A "User Product" is either (1) a "consumer product", which means any
tangible personal property which is normally used for personal, family,
or household purposes, or (2) anything designed or sold for incorporation
into a dwelling. In determining whether a product is a consumer product,
doubtful cases shall be resolved in favor of coverage. For a particular
product received by a particular user, "normally used" refers to a
typical or common use of that class of product, regardless of the status
of the particular user or of the way in which the particular user
actually uses, or expects or is expected to use, the product. A product
is a consumer product regardless of whether the product has substantial
commercial, industrial or non-consumer uses, unless such uses represent
the only significant mode of use of the product.

 "Installation Information" for a User Product means any methods,
procedures, authorization keys, or other information required to install
and execute modified versions of a covered work in that User Product from
a modified version of its Corresponding Source. The information must
suffice to ensure that the continued functioning of the modified object
code is in no case prevented or interfered with solely because
modification has been made.

 If you convey an object code work under this section in, or with, or
specifically for use in, a User Product, and the conveying occurs as
part of a transaction in which the right of possession and use of the
User Product is transferred to the recipient in perpetuity or for a
fixed term (regardless of how the transaction is characterized), the
Corresponding Source conveyed under this section must be accompanied
by the Installation Information. But this requirement does not apply
if neither you nor any third party retains the ability to install
modified object code on the User Product (for example, the work has
been installed in ROM).

 The requirement to provide Installation Information does not include a
requirement to continue to provide support service, warranty, or updates
for a work that has been modified or installed by the recipient, or for
the User Product in which it has been modified or installed. Access to a
network may be denied when the modification itself materially and
adversely affects the operation of the network or violates the rules and
protocols for communication across the network.

 Corresponding Source conveyed, and Installation Information provided,
in accord with this section must be in a format that is publicly
documented (and with an implementation available to the public in
source code form), and must require no special password or key for
unpacking, reading or copying.

 7. Additional Terms.

 "Additional permissions" are terms that supplement the terms of this
License by making exceptions from one or more of its conditions.
Additional permissions that are applicable to the entire Program shall
be treated as though they were included in this License, to the extent
that they are valid under applicable law. If additional permissions
apply only to part of the Program, that part may be used separately
under those permissions, but the entire Program remains governed by
this License without regard to the additional permissions.

 When you convey a copy of a covered work, you may at your option
remove any additional permissions from that copy, or from any part of
it. (Additional permissions may be written to require their own
removal in certain cases when you modify the work.) You may place
additional permissions on material, added by you to a covered work,
for which you have or can give appropriate copyright permission.

 Notwithstanding any other provision of this License, for material you
add to a covered work, you may (if authorized by the copyright holders of
that material) supplement the terms of this License with terms:

 a) Disclaiming warranty or limiting liability differently from the
 terms of sections 15 and 16 of this License; or

 b) Requiring preservation of specified reasonable legal notices or
 author attributions in that material or in the Appropriate Legal
 Notices displayed by works containing it; or

 c) Prohibiting misrepresentation of the origin of that material, or
 requiring that modified versions of such material be marked in
 reasonable ways as different from the original version; or

 d) Limiting the use for publicity purposes of names of licensors or
 authors of the material; or

 e) Declining to grant rights under trademark law for use of some
 trade names, trademarks, or service marks; or

 f) Requiring indemnification of licensors and authors of that
 material by anyone who conveys the material (or modified versions of
 it) with contractual assumptions of liability to the recipient, for
 any liability that these contractual assumptions directly impose on
 those licensors and authors.

 All other non-permissive additional terms are considered "further
restrictions" within the meaning of section 10. If the Program as you
received it, or any part of it, contains a notice stating that it is
governed by this License along with a term that is a further
restriction, you may remove that term. If a license document contains
a further restriction but permits relicensing or conveying under this
License, you may add to a covered work material governed by the terms
of that license document, provided that the further restriction does
not survive such relicensing or conveying.

 If you add terms to a covered work in accord with this section, you
must place, in the relevant source files, a statement of the
additional terms that apply to those files, or a notice indicating
where to find the applicable terms.

 Additional terms, permissive or non-permissive, may be stated in the
form of a separately written license, or stated as exceptions;
the above requirements apply either way.

 8. Termination.

 You may not propagate or modify a covered work except as expressly
provided under this License. Any attempt otherwise to propagate or
modify it is void, and will automatically terminate your rights under
this License (including any patent licenses granted under the third
paragraph of section 11).

 However, if you cease all violation of this License, then your
license from a particular copyright holder is reinstated (a)
provisionally, unless and until the copyright holder explicitly and
finally terminates your license, and (b) permanently, if the copyright
holder fails to notify you of the violation by some reasonable means
prior to 60 days after the cessation.

 Moreover, your license from a particular copyright holder is
reinstated permanently if the copyright holder notifies you of the
violation by some reasonable means, this is the first time you have
received notice of violation of this License (for any work) from that
copyright holder, and you cure the violation prior to 30 days after
your receipt of the notice.

 Termination of your rights under this section does not terminate the
licenses of parties who have received copies or rights from you under
this License. If your rights have been terminated and not permanently
reinstated, you do not qualify to receive new licenses for the same
material under section 10.

 9. Acceptance Not Required for Having Copies.

 You are not required to accept this License in order to receive or
run a copy of the Program. Ancillary propagation of a covered work
occurring solely as a consequence of using peer-to-peer transmission
to receive a copy likewise does not require acceptance. However,
nothing other than this License grants you permission to propagate or
modify any covered work. These actions infringe copyright if you do
not accept this License. Therefore, by modifying or propagating a
covered work, you indicate your acceptance of this License to do so.

 10. Automatic Licensing of Downstream Recipients.

 Each time you convey a covered work, the recipient automatically
receives a license from the original licensors, to run, modify and
propagate that work, subject to this License. You are not responsible
for enforcing compliance by third parties with this License.

 An "entity transaction" is a transaction transferring control of an
organization, or substantially all assets of one, or subdividing an
organization, or merging organizations. If propagation of a covered
work results from an entity transaction, each party to that
transaction who receives a copy of the work also receives whatever
licenses to the work the party's predecessor in interest had or could
give under the previous paragraph, plus a right to possession of the
Corresponding Source of the work from the predecessor in interest, if
the predecessor has it or can get it with reasonable efforts.

 You may not impose any further restrictions on the exercise of the
rights granted or affirmed under this License. For example, you may
not impose a license fee, royalty, or other charge for exercise of
rights granted under this License, and you may not initiate litigation
(including a cross-claim or counterclaim in a lawsuit) alleging that
any patent claim is infringed by making, using, selling, offering for
sale, or importing the Program or any portion of it.

 11. Patents.

 A "contributor" is a copyright holder who authorizes use under this
License of the Program or a work on which the Program is based. The
work thus licensed is called the contributor's "contributor version".

 A contributor's "essential patent claims" are all patent claims
owned or controlled by the contributor, whether already acquired or
hereafter acquired, that would be infringed by some manner, permitted
by this License, of making, using, or selling its contributor version,
but do not include claims that would be infringed only as a
consequence of further modification of the contributor version. For
purposes of this definition, "control" includes the right to grant
patent sublicenses in a manner consistent with the requirements of
this License.

 Each contributor grants you a non-exclusive, worldwide, royalty-free
patent license under the contributor's essential patent claims, to
make, use, sell, offer for sale, import and otherwise run, modify and
propagate the contents of its contributor version.

 In the following three paragraphs, a "patent license" is any express
agreement or commitment, however denominated, not to enforce a patent
(such as an express permission to practice a patent or covenant not to
sue for patent infringement). To "grant" such a patent license to a
party means to make such an agreement or commitment not to enforce a
patent against the party.

 If you convey a covered work, knowingly relying on a patent license,
and the Corresponding Source of the work is not available for anyone
to copy, free of charge and under the terms of this License, through a
publicly available network server or other readily accessible means,
then you must either (1) cause the Corresponding Source to be so
available, or (2) arrange to deprive yourself of the benefit of the
patent license for this particular work, or (3) arrange, in a manner
consistent with the requirements of this License, to extend the patent
license to downstream recipients. "Knowingly relying" means you have
actual knowledge that, but for the patent license, your conveying the
covered work in a country, or your recipient's use of the covered work
in a country, would infringe one or more identifiable patents in that
country that you have reason to believe are valid.

 If, pursuant to or in connection with a single transaction or
arrangement, you convey, or propagate by procuring conveyance of, a
covered work, and grant a patent license to some of the parties
receiving the covered work authorizing them to use, propagate, modify
or convey a specific copy of the covered work, then the patent license
you grant is automatically extended to all recipients of the covered
work and works based on it.

 A patent license is "discriminatory" if it does not include within
the scope of its coverage, prohibits the exercise of, or is
conditioned on the non-exercise of one or more of the rights that are
specifically granted under this License. You may not convey a covered
work if you are a party to an arrangement with a third party that is
in the business of distributing software, under which you make payment
to the third party based on the extent of your activity of conveying
the work, and under which the third party grants, to any of the
parties who would receive the covered work from you, a discriminatory
patent license (a) in connection with copies of the covered work
conveyed by you (or copies made from those copies), or (b) primarily
for and in connection with specific products or compilations that
contain the covered work, unless you entered into that arrangement,
or that patent license was granted, prior to 28 March 2007.

 Nothing in this License shall be construed as excluding or limiting
any implied license or other defenses to infringement that may
otherwise be available to you under applicable patent law.

 12. No Surrender of Others' Freedom.

 If conditions are imposed on you (whether by court order, agreement or
otherwise) that contradict the conditions of this License, they do not
excuse you from the conditions of this License. If you cannot convey a
covered work so as to satisfy simultaneously your obligations under this
License and any other pertinent obligations, then as a consequence you may
not convey it at all. For example, if you agree to terms that obligate you
to collect a royalty for further conveying from those to whom you convey
the Program, the only way you could satisfy both those terms and this
License would be to refrain entirely from conveying the Program.

 13. Use with the GNU Affero General Public License.

 Notwithstanding any other provision of this License, you have
permission to link or combine any covered work with a work licensed
under version 3 of the GNU Affero General Public License into a single
combined work, and to convey the resulting work. The terms of this
License will continue to apply to the part which is the covered work,
but the special requirements of the GNU Affero General Public License,
section 13, concerning interaction through a network will apply to the
combination as such.

 14. Revised Versions of this License.

 The Free Software Foundation may publish revised and/or new versions of
the GNU General Public License from time to time. Such new versions will
be similar in spirit to the present version, but may differ in detail to
address new problems or concerns.

 Each version is given a distinguishing version number. If the
Program specifies that a certain numbered version of the GNU General
Public License "or any later version" applies to it, you have the
option of following the terms and conditions either of that numbered
version or of any later version published by the Free Software
Foundation. If the Program does not specify a version number of the
GNU General Public License, you may choose any version ever published
by the Free Software Foundation.

 If the Program specifies that a proxy can decide which future
versions of the GNU General Public License can be used, that proxy's
public statement of acceptance of a version permanently authorizes you
to choose that version for the Program.

 Later license versions may give you additional or different
permissions. However, no additional obligations are imposed on any
author or copyright holder as a result of your choosing to follow a
later version.

 15. Disclaimer of Warranty.

 THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
ALL NECESSARY SERVICING, REPAIR OR CORRECTION.

 16. Limitation of Liability.

 IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
SUCH DAMAGES.

 17. Interpretation of Sections 15 and 16.

 If the disclaimer of warranty and limitation of liability provided
above cannot be given local legal effect according to their terms,
reviewing courts shall apply local law that most closely approximates
an absolute waiver of all civil liability in connection with the
Program, unless a warranty or assumption of liability accompanies a
copy of the Program in return for a fee.

 END OF TERMS AND CONDITIONS

 How to Apply These Terms to Your New Programs

 If you develop a new program, and you want it to be of the greatest
possible use to the public, the best way to achieve this is to make it
free software which everyone can redistribute and change under these terms.

 To do so, attach the following notices to the program. It is safest
to attach them to the start of each source file to most effectively
state the exclusion of warranty; and each file should have at least
the "copyright" line and a pointer to where the full notice is found.

 
 Copyright (C)  

 This program is free software: you can redistribute it and/or modify
 it under the terms of the GNU General Public License as published by
 the Free Software Foundation, either version 3 of the License, or
 (at your option) any later version.

 This program is distributed in the hope that it will be useful,
 but WITHOUT ANY WARRANTY; without even the implied warranty of
 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
 GNU General Public License for more details.

 You should have received a copy of the GNU General Public License
 along with this program. If not, see .

Also add information on how to contact you by electronic and paper mail.

 If the program does terminal interaction, make it output a short
notice like this when it starts in an interactive mode:

  Copyright (C)  
 This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
 This is free software, and you are welcome to redistribute it
 under certain conditions; type `show c' for details.

The hypothetical commands `show w' and `show c' should show the appropriate
parts of the General Public License. Of course, your program's commands
might be different; for a GUI interface, you would use an "about box".

 You should also get your employer (if you work as a programmer) or school,
if any, to sign a "copyright disclaimer" for the program, if necessary.
For more information on this, and how to apply and follow the GNU GPL, see
.

 The GNU General Public License does not permit incorporating your program
into proprietary programs. If your program is a subroutine library, you
may consider it more useful to permit linking proprietary applications with
the library. If this is what you want to do, use the GNU Lesser General
Public License instead of this License. But first, please read
.

**********************************************************************
**********************************************************************

Source Code Documentation

Sun, 19 Apr 2026 00:00:00 +0000

API reference generated from the source of each package: one page per class, listing its namespace, methods, parameters, and inherited members.

For narrative documentation, start from /docs/. For working code, start from /examples/.

Packages

tc-lib-pdf : the top-level document API, \Com\Tecnick\Pdf.
tc-lib-pdf-page : \Com\Tecnick\Pdf\Page.
tc-lib-pdf-graph : \Com\Tecnick\Pdf\Graph.
tc-lib-pdf-font : \Com\Tecnick\Pdf\Font.
tc-lib-pdf-image : \Com\Tecnick\Pdf\Image.
tc-lib-pdf-parser : \Com\Tecnick\Pdf\Parser.
tc-lib-pdf-filter : \Com\Tecnick\Pdf\Filter.
tc-lib-pdf-encrypt : \Com\Tecnick\Pdf\Encrypt.
tc-lib-pdf-sign : \Com\Tecnick\Pdf\Sign.
tc-lib-color : \Com\Tecnick\Color.
tc-lib-barcode : \Com\Tecnick\Barcode.
tc-lib-unicode : \Com\Tecnick\Unicode.
tc-lib-unicode-data : \Com\Tecnick\Unicode\Data.
tc-lib-file : \Com\Tecnick\File.

Legacy

TCPDF : the deprecated single-class library, kept online for projects still running it. New projects should use tc-lib-pdf.

tc-lib-barcode

Sun, 19 Apr 2026 00:00:00 +0000

Overview

tc-lib-barcode is a pure-PHP barcode generation library for industrial, retail, logistics, and document automation workflows.

Encoding follows the published specification for each symbology, and the result comes back as a bar grid you can render however the target needs: SVG or PDF operators for print, PNG for a web preview. Coverage spans 73 formats across the linear, 2D, and postal families, including the GS1 DataBar and GS1-128 sets, the HIBC health industry profiles, the Chinese Han Xin Code, and the national postal symbologies of the United States, the United Kingdom, Germany, the Netherlands, Japan, and Australia.

tc-lib-color

Sun, 19 Apr 2026 00:00:00 +0000

Overview

tc-lib-color provides parsing, conversion, and formatting of color values for web and PDF rendering pipelines.

One normalization layer covers RGB, CMYK, HSL, grayscale, Lab, and spot colors, in both their CSS and their PDF representations. Conversions written ad hoc in three places tend to round differently in all three; here they do not.

Repository and API Docs

GitHub: https://github.com/tecnickcom/tc-lib-color
API docs: https://tcpdf.org/docs/srcdoc/tc-lib-color
Packagist: https://packagist.org/packages/tecnickcom/tc-lib-color

Project Metadata

Item	Value
Namespace	`\Com\Tecnick\Color`
License	GNU LGPL v3

Installation

composer require tecnickcom/tc-lib-color

Where It Fits

Use this package whenever rendering needs explicit color conversions and repeatable output across digital and print contexts. It is a direct dependency of tecnickcom/tc-lib-pdf and is used internally for all color operations during PDF composition.

tc-lib-file

Sun, 19 Apr 2026 00:00:00 +0000

Overview

tc-lib-file provides low-level file access and byte-reading primitives used by higher-level PDF and document libraries.

It is a small package doing an outsized job. Every host allowlist, path allowlist, size limit, and transport control that the rest of the stack relies on is enforced here, in one place that can be audited on its own.

Repository and API Docs

GitHub: https://github.com/tecnickcom/tc-lib-file
API docs: https://tcpdf.org/docs/srcdoc/tc-lib-file
Packagist: https://packagist.org/packages/tecnickcom/tc-lib-file

Project Metadata

Item	Value
Namespace	`\Com\Tecnick\File`
License	GNU LGPL v3

Installation

composer require tecnickcom/tc-lib-file

Where It Fits

Wherever an input can arrive as a filesystem path, a data URI, a remote URL, or a raw string, and the code handling it should not have to care which.

tc-lib-unicode

Sun, 19 Apr 2026 00:00:00 +0000

Overview

tc-lib-unicode provides Unicode conversion utilities and bidirectional algorithm support for multilingual text processing.

Directionality is where most of the work is. A paragraph mixing Hebrew or Arabic with Latin text and numerals has to be reordered before it can be drawn, and this package implements UAX #9 to do it.

Repository and API Docs

GitHub: https://github.com/tecnickcom/tc-lib-unicode
API docs: https://tcpdf.org/docs/srcdoc/tc-lib-unicode
Packagist: https://packagist.org/packages/tecnickcom/tc-lib-unicode

Project Metadata

Item	Value
Namespace	`\Com\Tecnick\Unicode`
License	GNU LGPL v3

Installation

composer require tecnickcom/tc-lib-unicode

Where It Fits

Any text that is not plain left-to-right Latin: right-to-left scripts, Arabic shaping, Devanagari and Hangul reordering, or mixed-direction runs on one line.

tc-lib-unicode-data

Thu, 06 Aug 2026 00:00:00 +0000

Overview

tc-lib-unicode-data is a data-centric package that ships Unicode lookup tables, mappings, and constants consumed by tc-lib-unicode and related libraries.

Keeping the tables in their own package means a UCD update is a version bump here, with nothing to review in the algorithms that read them.

Repository and API Docs

GitHub: https://github.com/tecnickcom/tc-lib-unicode-data
API docs: https://tcpdf.org/docs/srcdoc/tc-lib-unicode-data
Packagist: https://packagist.org/packages/tecnickcom/tc-lib-unicode-data

Project Metadata

Item	Value
Namespace	`\Com\Tecnick\Unicode\Data`
License	GNU LGPL v3

Installation

composer require tecnickcom/tc-lib-unicode-data

Where It Fits

Usually indirectly, through tc-lib-unicode. Reach for it directly when you need to inspect a code point’s properties yourself.

tc-lib-pdf-encrypt

Sun, 19 Apr 2026 00:00:00 +0000

Overview

tc-lib-pdf-encrypt implements core PDF encryption routines, including password handling and permission flag control.

The security mechanics of the PDF specification sit behind a small API, so a document generator applies a policy without touching the cryptography underneath it.

Repository and API Docs

GitHub: https://github.com/tecnickcom/tc-lib-pdf-encrypt
API docs: https://tcpdf.org/docs/srcdoc/tc-lib-pdf-encrypt
Packagist: https://packagist.org/packages/tecnickcom/tc-lib-pdf-encrypt

Project Metadata

Item	Value
Namespace	`\Com\Tecnick\Pdf\Encrypt`
License	GNU LGPL v3

Installation

composer require tecnickcom/tc-lib-pdf-encrypt

Where It Fits

When a generated PDF has to carry an access policy: an open or owner password, restrictions on printing and modification, or certificate-based recipients.

tc-lib-pdf-filter

Thu, 06 Aug 2026 00:00:00 +0000

Overview

tc-lib-pdf-filter decodes and applies PDF stream filters defined by the PDF specification.

A stream can carry a chain of filters rather than a single one, so both the generation and the parsing side run their bytes through this package.

Repository and API Docs

GitHub: https://github.com/tecnickcom/tc-lib-pdf-filter
API docs: https://tcpdf.org/docs/srcdoc/tc-lib-pdf-filter
Packagist: https://packagist.org/packages/tecnickcom/tc-lib-pdf-filter

Project Metadata

Item	Value
Namespace	`\Com\Tecnick\Pdf\Filter`
License	GNU LGPL v3

Installation

composer require tecnickcom/tc-lib-pdf-filter

Where It Fits

When you are reading or writing PDF streams directly and need the decode chain to behave exactly as the specification describes it.

tc-lib-pdf-font

Sun, 19 Apr 2026 00:00:00 +0000

Overview

tc-lib-pdf-font provides font import and runtime font-stack services for PDF composition engines.

It sits between the font files on disk and the text a document draws, holding the metrics, the encodings, and the tooling that turns a TTF or an OTF into something a PDF can embed.

In practice, there are two phases:

Build phase: convert source fonts (.ttf, .pfb, .afm) into font definition assets.
Runtime phase: load those generated assets through the font stack when rendering PDF content.

Repository and API Docs

GitHub: https://github.com/tecnickcom/tc-lib-pdf-font
API docs: https://tcpdf.org/docs/srcdoc/tc-lib-pdf-font
Packagist: https://packagist.org/packages/tecnickcom/tc-lib-pdf-font

Project Metadata

Item	Value
Namespace	`\Com\Tecnick\Pdf\Font`
License	GNU LGPL v3

Installation

composer require tecnickcom/tc-lib-pdf-font

For full PDF rendering with this font engine, install tecnickcom/tc-lib-pdf in your application.

tc-lib-pdf-graph

Sun, 19 Apr 2026 00:00:00 +0000

Overview

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

The API stays close to the PDF graphics operators themselves: paths, paint, clipping, shadings, and transforms, with the operator tokens visible in the method names and enum values.

Repository and API Docs

GitHub: https://github.com/tecnickcom/tc-lib-pdf-graph
API docs: https://tcpdf.org/docs/srcdoc/tc-lib-pdf-graph
Packagist: https://packagist.org/packages/tecnickcom/tc-lib-pdf-graph

Project Metadata

Item	Value
Namespace	`\Com\Tecnick\Pdf\Graph`
License	GNU LGPL v3

Installation

composer require tecnickcom/tc-lib-pdf-graph

Where It Fits

Diagrams, overlays, crop and registration marks, and any vector component you want to draw once and place many times.

tc-lib-pdf-image

Sun, 19 Apr 2026 00:00:00 +0000

Overview

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

Decoding, re-encoding, alpha extraction, and ICC handling all happen here, so document-level code deals in image identifiers and placement rather than in pixels.

Repository and API Docs

GitHub: https://github.com/tecnickcom/tc-lib-pdf-image
API docs: https://tcpdf.org/docs/srcdoc/tc-lib-pdf-image
Packagist: https://packagist.org/packages/tecnickcom/tc-lib-pdf-image

Project Metadata

Item	Value
Namespace	`\Com\Tecnick\Pdf\Image`
License	GNU LGPL v3

Installation

composer require tecnickcom/tc-lib-pdf-image

Where It Fits

When a document pulls in artwork the application did not produce: uploads, assets from a CDN, or files a customer supplied.

tc-lib-pdf-page

Sun, 19 Apr 2026 00:00:00 +0000

Overview

tc-lib-pdf-page keeps the page stack of a PDF document and writes out the page tree, the page objects, and the content streams.

Page size, orientation, boxes, and margins are resolved here rather than in the document builder, which is what keeps multi-page layout rules consistent across a document.

Repository and API Docs

GitHub: https://github.com/tecnickcom/tc-lib-pdf-page
API docs: https://tcpdf.org/docs/srcdoc/tc-lib-pdf-page
Packagist: https://packagist.org/packages/tecnickcom/tc-lib-pdf-page

Project Metadata

Item	Value
Namespace	`\Com\Tecnick\Pdf\Page`
License	GNU LGPL v3

Installation

composer require tecnickcom/tc-lib-pdf-page

Where It Fits

Print-bound work, mainly, where trim and bleed have to be exact, and any document whose pagination is more involved than one page after another.

tc-lib-pdf-parser

Sun, 19 Apr 2026 00:00:00 +0000

Overview

tc-lib-pdf-parser parses raw PDF data into structured PHP arrays for extraction, analysis, and downstream processing.

It is built for tooling: inspecting content, pulling out metadata, checking structure, and feeding migration pipelines. It also backs the page import in tc-lib-pdf.

Repository and API Docs

GitHub: https://github.com/tecnickcom/tc-lib-pdf-parser
API docs: https://tcpdf.org/docs/srcdoc/tc-lib-pdf-parser
Packagist: https://packagist.org/packages/tecnickcom/tc-lib-pdf-parser

Project Metadata

Item	Value
Namespace	`\Com\Tecnick\Pdf\Parser`
License	GNU LGPL v3

Installation

composer require tecnickcom/tc-lib-pdf-parser

Where It Fits

When PDFs arrive from outside and have to be read: analysed, merged, mined for content, or stamped and passed on.

tc-lib-pdf-sign

Sun, 12 Jul 2026 00:00:00 +0000

Overview

tc-lib-pdf-sign provides the cryptographic building blocks and PDF signature objects used by tc-lib-pdf to produce signed PDF documents.

The crypto and the PDF object generation live here, while the host library keeps the ByteRange placement, the incremental update writer, and the public facade. The package assembles CMS/CAdES signatures natively in pure PHP through a small DER ASN.1 codec, so it can embed the ESS signing-certificate-v2 attribute that openssl_pkcs7_sign() cannot add. That attribute is what lifts a plain PKCS#7 signature to a PAdES baseline signature.

TCPDF

Mon, 02 Nov 2026 17:09:42 +0000

Source: https://github.com/tecnickcom/TCPDF

Global namespace

Classes:

Files

config/tcpdf_config.php: Configuration file for TCPDF.
tcpdf_autoconfig.php: Try to automatically configure some TCPDF constants if not defined.

tc-lib-pdf

Mon, 02 Nov 2026 17:03:35 +0000

Author: Nicola Asuni <info@tecnick.com>
License: https://www.gnu.org/copyleft/lesser.html GNU-LGPL v3 (see LICENSE)
Source: https://github.com/tecnickcom/tc-lib-pdf

Com\Tecnick\Pdf

Classes:

Base: Output PDF data
Cell: Cell PDF data
CSS: CSS PDF class
Exception: Custom Exception class
HTML: HTML PDF class
JavaScript: JavaScript PDF class
MetaInfo: Meta Information PDF class
Output: Output PDF data
PdfColor: PDF color adapter with conformance-aware output.
SVG: SVG PDF class
Tcpdf: Tcpdf PDF class
Text: Text PDF data

Enums:

tc-lib-pdf-font

Mon, 02 Nov 2026 16:16:50 +0000

Author: Nicola Asuni <info@tecnick.com>
License: https://www.gnu.org/copyleft/lesser.html GNU-LGPL v3 (see LICENSE)
Source: https://github.com/tecnickcom/tc-lib-pdf-font

Com\Tecnick\Pdf\Font

Classes:

Buffer
Core
Definition: Reads the decoded font definition file at the types the font data declares.
Exception: Custom Exception class
FileWriter: Writes the artifacts produced by the font import.
Font
FontPaths: Shared font paths rooted at the library base directory.
Import
Load
OutFont
Output
OutUtil
Stack
Subset
UniToCid
Zlib: Compression and decompression of the stored font artifacts.

Interfaces:

tc-lib-pdf-page

Sat, 24 Oct 2026 09:38:58 +0100

Author: Nicola Asuni <info@tecnick.com>
License: https://www.gnu.org/copyleft/lesser.html GNU-LGPL v3 (see LICENSE)
Source: https://github.com/tecnickcom/tc-lib-pdf-page

Com\Tecnick\Pdf\Page

Classes:

Box
Exception: Custom Exception class.
Format
Mode
Page
Region
Settings

Enums:

Orientation: Backed enum for the requested page orientation: ‘P’ (portrait), ‘L’ (landscape) or ’’ (auto-detect from the page dimensions).
PageBoxType: Backed enum for the PDF page boundary box names.
PageDisplayMode: Backed enum for the PDF /PageMode name.
PageLayout: Backed enum for the PDF /PageLayout name.
TransparencyGroupMode: Backed enum for the per-page transparency /Group emission policy: ‘auto’ (every standard page except those explicitly flagged as opaque), ‘always’ or ’never’.
Unit: Backed enum for the document unit of measure.

tc-lib-barcode

Sat, 17 Oct 2026 11:50:05 +0100

Author: Nicola Asuni <info@tecnick.com>
License: https://www.gnu.org/copyleft/lesser.html GNU-LGPL v3 (see LICENSE)
Source: https://github.com/tecnickcom/tc-lib-barcode

Com\Tecnick\Barcode

Classes:

Barcode: Barcode factory class
Exception: Custom Exception class
Math: Arbitrary precision arithmetic on non-negative decimal integer strings.
Type: Barcode Type class

Interfaces:

Model: Barcode Model interface

Enums:

BarcodeType: Backed enum for the supported barcode symbologies.

Com\Tecnick\Barcode\Type

Classes:

Convert: Barcode Convert class
GsOneElementString: GS1 Application Identifier element strings (GS1 General Specifications) Reads the bracketed form “(ai)value(ai)value…”, which is also the human readable interpretation, and checks the Application Id
Hibc: Hibc data structure class HIBC (Health Industry Bar Code) data structures Validates a data structure of the Supplier Labeling Standard (ANSI/HIBC 2.6) or of the Provider Applications Standard (ANSI/HI
Linear: Barcode type class
Raw: Raw Barcode type class RAW MODE (comma-separated rows)
ReedSolomon: Reed-Solomon error correction over GF(2^n)
Square: Barcode type class

Traits:

tc-lib-pdf-encrypt

Sat, 17 Oct 2026 11:08:48 +0100

Author: Nicola Asuni <info@tecnick.com>
License: https://www.gnu.org/copyleft/lesser.html GNU-LGPL v3 (see LICENSE)
Source: https://github.com/tecnickcom/tc-lib-pdf-encrypt

Com\Tecnick\Pdf\Encrypt

Classes:

Compute: Computes the PDF encryption data.
Data: Encryption constants and settings.
Decrypt: Authenticates a password (or private key for public-key mode) against a PDF encryption dictionary and recovers the document file-encryption key.
Encrypt: Encrypts data for PDF documents.
Exception: Custom Exception class
Output: Generates the PDF encryption dictionary.

Com\Tecnick\Pdf\Encrypt\Type

Classes:

AES: AES
AESnopad: AES no-padding
AESSixteen: AESSixteen 16 bytes = 128 bit
AESThirtytwo: AESThirtytwo 32 bytes = 256 bit
MDFiveSixteen: MD5-16
RCFour: RC4 is the standard encryption algorithm used in PDF format
RCFourFive: RC4-40 is the standard encryption algorithm used in PDF format The key length is 5 bytes (40 bits)
RCFourSixteen: RC4-128 is the standard encryption algorithm used in PDF format The key length is 16 bytes (128 bits)
Seed: generate random seed

tc-lib-pdf-image

Sat, 10 Oct 2026 09:54:01 +0100

Author: Nicola Asuni <info@tecnick.com>
License: https://www.gnu.org/copyleft/lesser.html GNU-LGPL v3 (see LICENSE)
Source: https://github.com/tecnickcom/tc-lib-pdf-image

Com\Tecnick\Pdf\Image

Classes:

Exception: Custom Exception class
Import
Output

Interfaces:

ImageCacheInterface: External cache used to persist processed image data across Import instances and PHP processes.

Com\Tecnick\Pdf\Image\Import

Classes:

Jpeg
Png

Interfaces:

ImageImportInterface

tc-lib-unicode

Sat, 10 Oct 2026 09:43:12 +0100

Author: Nicola Asuni <info@tecnick.com>
License: https://www.gnu.org/copyleft/lesser.html GNU-LGPL v3 (see LICENSE)
Source: https://github.com/tecnickcom/tc-lib-unicode

Com\Tecnick\Unicode

Classes:

Bidi: Unicode Bidirectional Algorithm (UAX #9): reorders each paragraph of the input from logical to visual order and applies the Arabic shaping.
Convert: Malformed input policy: a string or char array that is not valid UTF-8 raises an exception, while a code point that cannot be encoded (negative, surrogate or greater than U+10FFFF) is replaced with ‘?
Exception: Custom Exception class
Substitution: Context-sensitive Unicode character substitution.

Enums:

tc-lib-unicode-data

Sat, 10 Oct 2026 09:31:57 +0100

Author: Nicola Asuni <info@tecnick.com>
License: https://www.gnu.org/copyleft/lesser.html GNU-LGPL v3 (see LICENSE)
Source: https://github.com/tecnickcom/tc-lib-unicode-data

Com\Tecnick\Unicode\Data

Classes:

Arabic: Arabic shaping data (ArabicShaping.txt and UnicodeData.txt).
Bracket: Paired bracket properties (BidiBrackets.txt).
Constant: Code points of the bidirectional formatting characters and of some common separators.
Encoding: Font encoding maps: character code to glyph name for each supported encoding.
Identity: CMap stream for the Identity-H encoding.
Latin: Unicode to Latin1 character substitutions.
LineBreak: Line_Break property values (UAX #14) of the classes that take part in ideographic line breaking.
Mirror: Bidi_Mirroring_Glyph property values (BidiMirroring.txt).
Pattern: Regular expressions matching directional text.
Type: Bidirectional character types (UAX #9).

Enums:

tc-lib-pdf-graph

Mon, 21 Sep 2026 00:11:31 +0100

Author: Nicola Asuni <info@tecnick.com>
License: https://www.gnu.org/copyleft/lesser.html GNU-LGPL v3 (see LICENSE)
Source: https://github.com/tecnickcom/tc-lib-pdf-graph

Com\Tecnick\Pdf\Graph

Classes:

Base
Draw
Exception: Custom Exception class
Gradient
Raw
Style
Transform

Enums:

BlendMode: Backed enum of the PDF blend modes (PDF 32000-1:2008 - 11.3.5).
PathPaintOp: Backed enum of the PDF path-painting operators (PDF 32000-1:2008 - 8.5.3).

tc-lib-pdf-parser

Sun, 13 Sep 2026 10:23:18 +0100

Author: Nicola Asuni <info@tecnick.com>
License: https://www.gnu.org/copyleft/lesser.html GNU-LGPL v3 (see LICENSE)
Source: https://github.com/tecnickcom/tc-lib-pdf-parser

Com\Tecnick\Pdf\Parser

Classes:

Exception: Custom Exception class
LimitException: Raised when a parsing safety limit prevents an object from being resolved.
Parser: PHP class for parsing PDF documents.

Com\Tecnick\Pdf\Parser\Process

Classes:

RawObject: Process Raw Objects
Xref: Process the cross-reference sections and the trailer
XrefStream: Process the cross-reference stream entries

tc-lib-pdf-sign

Sat, 05 Sep 2026 08:07:42 +0100

Author: Nicola Asuni <info@tecnick.com>
License: https://www.gnu.org/copyleft/lesser.html GNU-LGPL v3 (see LICENSE)
Source: https://github.com/tecnickcom/tc-lib-pdf-sign

Com\Tecnick\Pdf\Sign

Classes:

Config: Immutable signature configuration value object.
Exception: Custom Exception class for the PDF signature library.
RevokedException: Thrown when a responder or a CRL states that a certificate is revoked.
Signer: Package-internal orchestration entry point that ties the CMS builder, the RFC 3161 timestamp codec, and the LTV material collector together behind two host-facing calls.

Enums:

tc-lib-pdf-filter

Sat, 05 Sep 2026 08:07:26 +0100

Author: Nicola Asuni <info@tecnick.com>
License: https://www.gnu.org/copyleft/lesser.html GNU-LGPL v3 (see LICENSE)
Source: https://github.com/tecnickcom/tc-lib-pdf-filter

Com\Tecnick\Pdf\Filter

Classes:

Exception: Exception thrown by this library.
Filter: Decoder for the PDF stream filters (PDF 32000-1:2008 §7.4).
Predictor: Reverses the predictor applied before LZW or Flate compression (PDF 32000-1:2008 Table 8).

Enums:

FilterType: Backed enum of the standard PDF stream filters (PDF 32000-1:2008 §7.4).

Com\Tecnick\Pdf\Filter\Type

Classes:

AsciiEightFive: ASCII85Decode filter (PDF 32000-1:2008 §7.4.3).
AsciiHex: ASCIIHexDecode filter (PDF 32000-1:2008 §7.4.2).
CcittFax: CCITTFaxDecode filter (PDF 32000-1:2008 §7.4.6).
Crypt: Crypt filter (PDF 32000-1:2008 §7.4.10).
Dct: DCTDecode filter (PDF 32000-1:2008 §7.4.8).
Flate: FlateDecode filter (PDF 32000-1:2008 §7.4.4).
JbigTwo: JBIG2Decode filter (PDF 32000-1:2008 §7.4.7).
Jpx: JPXDecode filter (PDF 32000-1:2008 §7.4.9).
Lzw: LZWDecode filter (PDF 32000-1:2008 §7.4.4).
RunLength: RunLengthDecode filter (PDF 32000-1:2008 §7.4.5).

Interfaces:

tc-lib-file

Wed, 26 Aug 2026 20:23:24 +0100

Author: Nicola Asuni <info@tecnick.com>
License: https://www.gnu.org/copyleft/lesser.html GNU-LGPL v3 (see LICENSE)
Source: https://github.com/tecnickcom/tc-lib-file

Com\Tecnick\File

Classes:

Byte: Big-endian byte-level reads from a binary string The 32-bit readers (getULong(), getLong(), getFixed()) assume a 64-bit PHP build: on a 32-bit build the intermediate left shift overflows the platform
Cache: File caching system with per-instance directory path and file prefix
Dir: Writable parent-directory lookup
Exception: Library exception type
File: Local and remote file reads behind host and path allowlists

Files

src/Cache.php: Cache.php

tc-lib-color

Wed, 26 Aug 2026 15:23:50 +0100

Author: Nicola Asuni <info@tecnick.com>
License: https://www.gnu.org/copyleft/lesser.html GNU-LGPL v3 (see LICENSE)
Source: https://github.com/tecnickcom/tc-lib-color

Com\Tecnick\Color

Classes:

ComponentNormalizer: Scales a parsed CSS component value into the [0..1] range used by the color models.
Css: Css Color class Parses the CSS and Acrobat JavaScript color notations.
Exception: Custom Exception class Raised for an invalid input condition: an unparsable color string, an unknown color or spot color name, a PDF resource that cannot be referenced.
Model: Color Model class
Pdf: PDF Color class Extension points: getPdfColor() and getColorObject().
Spot: Spot Color class Extension points: getSpotColor() and the protected resolveSpotColorData().
UnknownComponentException: Raised when a color model is given a component name it does not define.
Web: Web Color class Extension point: getColorObj().

Interfaces:

Example E000 : overview

Sun, 26 Apr 2026 00:00:00 +0000

A visual showcase of the library on a few pages: barcodes, QR codes, SVG artwork, raster images, transparency, and gradients.

Rendered PDF: E000_overview.pdf
PHP source: E000_overview.phps
All examples: /examples/
Category: Start Here

PDF

Source Code

<?php

declare(strict_types=1);

/**
 * E000_overview.php
 *
 * @since 2017-05-08
 * @category Library
 * @package Pdf
 * @author Nicola Asuni <info@tecnick.com>
 * @copyright 2002-2026 Nicola Asuni - Tecnick.com LTD
 * @license https://www.gnu.org/copyleft/lesser.html GNU-LGPL v3 (see LICENSE)
 * @link https://github.com/tecnickcom/tc-lib-pdf
 *
 * This file is part of tc-lib-pdf software library.
 */

// NOTE: local file reads (images, fonts, attachments) are restricted to an allowlist of
// trusted paths that covers this package tree, so run the examples in place. To read assets
// from other locations, list them in the 'allowedPaths' entry of the fileOptions constructor
// parameter (see E047_remote_resources_security.php).

// NOTE: run make fonts in the project root to generate the dependencies and example fonts.

// autoloader when using Composer
require __DIR__ . '/../vendor/autoload.php';

\define('OUTPUT_FILE', \realpath(__DIR__ . '/../target') . '/example_overview.pdf');

// define fonts directory
\define('K_PATH_FONTS', \realpath(__DIR__ . '/../vendor/tecnickcom/tc-lib-pdf-font/target/fonts'));

// autoloader when using RPM or DEB package installation
//require ('/usr/share/php/Com/Tecnick/Pdf/autoload.php');

// main TCPDF object
$pdf = new \Com\Tecnick\Pdf\Tcpdf(
 unit: \Com\Tecnick\Pdf\Page\Unit::Millimeter,
 isunicode: true,
 subsetfont: false,
 compress: true,
 mode: \Com\Tecnick\Pdf\PdfConformance::None,
 objEncrypt: null,
);

// ----------

$pdf->setCreator('tc-lib-pdf');
$pdf->setAuthor('Nicola Asuni');
$pdf->setSubject('tc-lib-pdf example: 000');
$pdf->setTitle('tc-lib-pdf Visual Showcase');
$pdf->setKeywords('TCPDF tc-lib-pdf showcase barcode qr svg image transparency gradients');
$pdf->setPDFFilename('000_overview.pdf');

$pdf->setViewerPreferences(['DisplayDocTitle' => true]);

$pdf->enableDefaultPageContent();

// ----------
// Insert fonts

$titleFont = $pdf->font->insert($pdf->pon, 'dejavusans', 'B', 30);
$subtitleFont = $pdf->font->insert($pdf->pon, 'dejavusans', '', 13);
$bodyFont = $pdf->font->insert($pdf->pon, 'dejavusans', '', 10);
$smallFont = $pdf->font->insert($pdf->pon, 'dejavusans', '', 8);

$imgdir = __DIR__ . '/images';

// ----------
// Add first page

$page01 = $pdf->addPage();
$pdf->setBookmark(name: 'Visual showcase', link: '', level: 0, page: -1, posx: 0, posy: 0, fstyle: 'B', color: 'blue');

$pageW = (float) $page01['width'];
$pageH = (float) $page01['height'];

$cardStyle = [
 'all' => [
 'lineWidth' => 0.35,
 'lineCap' => 'butt',
 'lineJoin' => 'miter',
 'dashArray' => [],
 'dashPhase' => 0,
 'lineColor' => 'rgb(193,216,242)',
 'fillColor' => 'rgb(255,255,255)',
 ],
];

$lineStyle = [
 'all' => [
 'lineWidth' => 0.25,
 'lineCap' => 'butt',
 'lineJoin' => 'miter',
 'dashArray' => [],
 'dashPhase' => 0,
 'lineColor' => 'rgb(147,196,227)',
 'fillColor' => 'rgb(147,196,227)',
 ],
];

$barcodeStyle = [
 'lineWidth' => 0,
 'lineCap' => 'butt',
 'lineJoin' => 'miter',
 'dashArray' => [],
 'dashPhase' => 0,
 'lineColor' => 'black',
 'fillColor' => 'black',
];

$textOnDark = $pdf->color->getPdfColor('rgb(244,250,255)');
$textOnLight = $pdf->color->getPdfColor('rgb(22,37,61)');

// Background atmosphere.
$pdf->page->addContent($pdf->graph->getLinearGradient(0, 0, $pageW, $pageH, 'rgb(10,27,60)', 'rgb(0,171,193)', [
 0,
 0,
 1,
 1,
]));

$pdf->page->addContent($pdf->graph->getAlpha(0.12));
for ($lineY = -20; $lineY <= 330; $lineY += 12) {
 $pdf->page->addContent($pdf->graph->getLine(0, (float) $lineY, $pageW, (float) ($lineY + 95), $lineStyle));
}

$pdf->page->addContent($pdf->graph->getAlpha(0.28));
$pdf->page->addContent($pdf->graph->getCircle(167, 46, 40, 0, 360, 'F', [
 'all' => [
 'lineWidth' => 0,
 'lineCap' => 'butt',
 'lineJoin' => 'miter',
 'dashArray' => [],
 'dashPhase' => 0,
 'lineColor' => 'rgb(255,255,255)',
 'fillColor' => 'rgb(255,255,255)',
 ],
]));
$pdf->page->addContent($pdf->graph->getAlpha(1.0));

// Main title block.
$pdf->page->addContent($textOnDark);
$pdf->page->addContent($titleFont['out']);
$pdf->addHTMLCell(
 html: '<div style="font-size:30pt; font-weight:bold; color:rgb(244,250,255);">tc-lib-pdf</div>',
 posx: 15,
 posy: 18,
 width: 120,
);

$pdf->page->addContent($subtitleFont['out']);
$pdf->addHTMLCell(
 html: '<div style="font-size:13pt; line-height:1.3; color:rgb(244,250,255);">Modern PDF generation in pure PHP: vectors, images, barcodes, and rich page composition.</div>',
 posx: 15,
 posy: 34,
 width: 125,
);

// Left feature card.
$pdf->page->addContent($pdf->graph->getAlpha(0.90));
$pdf->page->addContent($pdf->graph->getRect(12, 56, 89, 137, 'DF', $cardStyle));
$pdf->page->addContent($pdf->graph->getAlpha(1.0));

$pdf->page->addContent($textOnLight);
$pdf->page->addContent($subtitleFont['out']);
$pdf->addHTMLCell(
 html: '<div style="font-size:13pt; color:rgb(22,37,61);">Cool Features</div>',
 posx: 18,
 posy: 64,
 width: 72,
);

$pdf->page->addContent($bodyFont['out']);
$features =
 '<ul style="font-size:10pt; color:rgb(22,37,61); margin:0; padding-left:12pt;">'
 . '<li>Native SVG rendering</li>'
 . '<li>JPEG/PNG with transparency</li>'
 . '<li>1D/2D barcodes (QR, DataMatrix)</li>'
 . '<li>Gradients and vector primitives</li>'
 . '<li>HTML/CSS text layout</li>'
 . '<li>Digital signatures and PDF/X, PDF/UA support</li>'
 . '</ul>';
$pdf->addHTMLCell(html: $features, posx: 18, posy: 74, width: 79);

$logoFile = $imgdir . '/tcpdf_logo.jpg';
if (\is_file($logoFile)) {
 $logoId = $pdf->image->add($logoFile);
 $pdf->page->addContent($pdf->image->getSetImage($logoId, 153, 10, 40, 13, $pageH));
}

// SVG art panel.
$pdf->page->addContent($pdf->graph->getAlpha(0.92));
$pdf->page->addContent($pdf->graph->getRect(106, 70, 92, 121, 'DF', $cardStyle));
$pdf->page->addContent($pdf->graph->getAlpha(1.0));

$svgFile = $imgdir . '/testsvgblend.svg';
if (\is_file($svgFile)) {
 $svgObj = $pdf->addSVG(img: $svgFile, posx: 111, posy: 76, width: 82, height: 108, pageheight: $pageH);
 $pdf->page->addContent($pdf->getSetSVG(soid: $svgObj));
}

$pdf->page->addContent($textOnLight);
$pdf->page->addContent($smallFont['out']);
$pdf->addHTMLCell(
 html: '<div style="font-size:8pt; text-align:center; color:rgb(22,37,61);">SVG graphic rendered directly into PDF vectors</div>',
 posx: 111,
 posy: 182,
 width: 82,
);

// QR code panel.
$pdf->page->addContent($pdf->graph->getAlpha(0.92));
$pdf->page->addContent($pdf->graph->getRect(12, 198, 186, 76, 'DF', $cardStyle));
$pdf->page->addContent($pdf->graph->getAlpha(1.0));

$pdf->page->addContent($textOnLight);
$pdf->page->addContent($subtitleFont['out']);
$pdf->addHTMLCell(
 html: '<div style="font-size:13pt; color:rgb(22,37,61);">Scan to Explore</div>',
 posx: 18,
 posy: 206,
 width: 92,
);

$pdf->page->addContent($bodyFont['out']);
$pdf->addHTMLCell(
 html: '<div style="font-size:10pt; line-height:1.25; color:rgb(22,37,61);">This QR code points to the official TCPDF project page:</div>',
 posx: 18,
 posy: 216,
 width: 118,
);
$pdf->addHTMLCell(
 html: '<div style="font-size:10pt; color:rgb(22,37,61);"><a href="https://tcpdf.org">https://tcpdf.org</a></div>',
 posx: 18,
 posy: 228,
 width: 118,
);

$pdf->page->addContent($pdf->getBarcode(
 type: 'QRCODE,H',
 code: 'https://tcpdf.org',
 posx: 145,
 posy: 206,
 width: 45,
 height: 45,
 padding: [0, 0, 0, 0],
 style: $barcodeStyle,
));

// =============================================================

// ----------
// get PDF document as raw string
$rawpdf = $pdf->getOutPDFString();

// ----------

// Various output modes:

//$pdf->savePDF(\dirname(__DIR__).'/target', $rawpdf);
$pdf->renderPDF(rawpdf: $rawpdf);

//$pdf->downloadPDF($rawpdf);
//echo $pdf->getMIMEAttachmentPDF($rawpdf);

Example E001 : invoice

Sun, 26 Apr 2026 00:00:00 +0000

A hybrid electronic invoice: a Factur-X 1.07 and ZUGFeRD 2.3 XML payload embedded in a PDF/A-3 document, with the PDF/A extension schema written into XMP.

Rendered PDF: E001_invoice.pdf
PHP source: E001_invoice.phps
All examples: /examples/
Category: Standards and Conformance
Guide: Standards and Conformance

PDF

Source Code

<?php

declare(strict_types=1);

/**
 * E001_invoice.php
 *
 * @since 2017-05-08
 * @category Library
 * @package Pdf
 * @author Nicola Asuni <info@tecnick.com>
 * @copyright 2002-2026 Nicola Asuni - Tecnick.com LTD
 * @license https://www.gnu.org/copyleft/lesser.html GNU-LGPL v3 (see LICENSE)
 * @link https://github.com/tecnickcom/tc-lib-pdf
 *
 * This file is part of tc-lib-pdf software library.
 */

// NOTE: local file reads (images, fonts, attachments) are restricted to an allowlist of
// trusted paths that covers this package tree, so run the examples in place. To read assets
// from other locations, list them in the 'allowedPaths' entry of the fileOptions constructor
// parameter (see E047_remote_resources_security.php).

// NOTE: run make fonts in the project root to generate the dependencies and example fonts.

// autoloader when using Composer
require __DIR__ . '/../vendor/autoload.php';

// define fonts directory
\define('K_PATH_FONTS', \realpath(__DIR__ . '/../vendor/tecnickcom/tc-lib-pdf-font/target/fonts'));

// autoloader when using RPM or DEB package installation
//require ('/usr/share/php/Com/Tecnick/Pdf/autoload.php');

// main TCPDF object
$pdf = new \Com\Tecnick\Pdf\Tcpdf(
 unit: \Com\Tecnick\Pdf\Page\Unit::Millimeter,
 isunicode: true,
 subsetfont: false,
 compress: true,
 mode: \Com\Tecnick\Pdf\PdfConformance::Pdfa3,
 objEncrypt: null,
);

// ----------

$pdf->setCreator('tc-lib-pdf');
$pdf->setAuthor('Nicola Asuni');
$pdf->setSubject('tc-lib-pdf example: 001');
$pdf->setTitle('Example Invoice Factur-X 1.07 / ZUGFeRD 2.3');
$pdf->setKeywords('TCPDF tc-lib-pdf invoice Factur-X ZUGFeRD e-invoice XML');
$pdf->setPDFFilename('001_invoice.pdf');

$pdf->setViewerPreferences(['DisplayDocTitle' => true]);

$pdf->enableDefaultPageContent();

// ----------
// Insert fonts

$bfont1 = $pdf->font->insert($pdf->pon, 'dejavusans', '', 10);

// ----------

// Factur-X 1.07 / ZUGFeRD 2.3

$pageF01 = $pdf->addPage();
$pdf->setBookmark(name: 'Factur', link: '', level: 0, page: -1, posx: 0, posy: 0, fstyle: 'B', color: '');

$pdf->page->addContent($bfont1['out']);

$invoiceHTML = '
<h2 style="color:#003366;">INVOICE EXAMPLE</h2>
<table border="0" cellspacing="0" cellpadding="2" style="width:100%;">
 <tr>
 <td style="width:50%; vertical-align:top;">
 <b>Seller</b><br/>
 ELEKTRON Industrieservice GmbH<br/>
 Geschäftsführer Egon Schrempp Amtsgericht Stuttgart HRB 1234<br/>
 Erfurter Strasse 13<br/>
 74465 Demoort, DE<br/>
 VAT: DE136695976
 </td>
 <td style="width:50%; vertical-align:top; text-align:right;">
 <b>Invoice No.:</b> 181301674<br/>
 <b>Invoice Date:</b> 15.11.2024<br/>
 <b>Delivery Date:</b> 01.11.2024<br/>
 <b>Order Ref.:</b> per Mail vom 01.09.2024<br/>
 <b>Project:</b> 13130162
 </td>
 </tr>
</table>
<br/>
<b>Bill To:</b><br/>
ConsultingService GmbH<br/>
Attn: Liselotte Müller-Lüdenscheidt<br/>
Musterstr. 18<br/>
76138 Karlsruhe, DE<br/>
<br/>
<table border="1" cellspacing="0" cellpadding="3" style="width:100%; text-align:right;">
 <tr style="background-color:#003366; color:#ffffff;">
 <th style="text-align:left; width:8%;">Pos.</th>
 <th style="text-align:left; width:40%;">Description</th>
 <th style="width:12%;">Qty</th>
 <th style="width:10%;">Unit</th>
 <th style="width:15%;">Unit Price</th>
 <th style="width:15%;">Amount</th>
 </tr>
 <tr>
 <td style="text-align:left;">01</td>
 <td style="text-align:left;">TGA Obermonteur/Monteur<br/><i>Beamermontage</i></td>
 <td>3</td>
 <td>HUR</td>
 <td>43.20</td>
 <td>129.60</td>
 </tr>
 <tr>
 <td style="text-align:left;">02</td>
 <td style="text-align:left;">Beamer-Deckenhalterung<br/><i>Außerhalb Angebot</i></td>
 <td>1</td>
 <td>H87</td>
 <td>122.50</td>
 <td>122.50</td>
 </tr>
</table>
<br/>
<table border="0" cellspacing="0" cellpadding="2" style="width:100%;">
 <tr>
 <td style="width:60%;"></td>
 <td style="width:40%;">
 <table border="1" cellspacing="0" cellpadding="3" style="width:100%; text-align:right;">
 <tr><td style="text-align:left;">Net Total</td><td>EUR 252.10</td></tr>
 <tr><td style="text-align:left;">VAT 19%</td><td>EUR 47.90</td></tr>
 <tr><td style="text-align:left;"><b>Grand Total</b></td><td><b>EUR 300.00</b></td></tr>
 <tr><td style="text-align:left;">Prepaid</td><td>EUR 0.00</td></tr>
 <tr><td style="text-align:left;"><b>Due Amount</b></td><td><b>EUR 300.00</b></td></tr>
 </table>
 </td>
 </tr>
</table>
<br/>
<b>Payment Terms:</b> Zahlbar sofort rein netto<br/>
<b>Bank:</b> IBAN DE91100000000123456789<br/>
<b>Payment Reference:</b> Rechnung 181301674<br/>
<br/>
<i>Factur-X 1.07 / ZUGFeRD 2.3 — embedded XML attachment: factur-x.xml</i>
';

$pdf->page->addContent($pdf->getHTMLCell($invoiceHTML, 15, 15, 180));

$invoiceXML = <<<XML
 <?xml version='1.0' encoding='UTF-8' ?>
 <rsm:CrossIndustryInvoice xmlns:rsm="urn:un:unece:uncefact:data:standard:CrossIndustryInvoice:100" xmlns:qdt="urn:un:unece:uncefact:data:standard:QualifiedDataType:100" xmlns:ram="urn:un:unece:uncefact:data:standard:ReusableAggregateBusinessInformationEntity:100" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:udt="urn:un:unece:uncefact:data:standard:UnqualifiedDataType:100">
 <rsm:ExchangedDocumentContext>
 <ram:BusinessProcessSpecifiedDocumentContextParameter>
 <ram:ID>Baurechnung</ram:ID>
 </ram:BusinessProcessSpecifiedDocumentContextParameter>
 <ram:GuidelineSpecifiedDocumentContextParameter>
 <ram:ID>urn:cen.eu:en16931:2017</ram:ID>
 </ram:GuidelineSpecifiedDocumentContextParameter>
 </rsm:ExchangedDocumentContext>
 <rsm:ExchangedDocument>
 <ram:ID>181301674</ram:ID>
 <ram:TypeCode>204</ram:TypeCode>
 <ram:IssueDateTime>
 <udt:DateTimeString format="102">20241115</udt:DateTimeString>
 </ram:IssueDateTime>
 <ram:IncludedNote>
 <ram:Content>Rapport-Nr.: 42389 vom 01.11.2024
 Im 2. OG BT1 Besprechungsraum eine Beamerhalterung an die Decke montiert. Dafür eine Deckenplatte ausgesägt. Beamerhalterung zur Montage auseinander gebaut. Ein Stromkabel für den Beamer, ein HDMI Kabel und ein VGA Kabel durch die Halterung gezogen. Beamerhalterung wieder zusammengebaut und Beamer montiert. Beamer verkabelt und ausgerichtet. Decke geschlossen.</ram:Content>
 </ram:IncludedNote>
 </rsm:ExchangedDocument>
 <rsm:SupplyChainTradeTransaction>
 <ram:IncludedSupplyChainTradeLineItem>
 <ram:AssociatedDocumentLineDocument>
 <ram:LineID>01</ram:LineID>
 <ram:IncludedNote>
 <ram:Content>01 Beamermontage
 Für die doppelte Verlegung, falls erforderlich.</ram:Content>
 </ram:IncludedNote>
 </ram:AssociatedDocumentLineDocument>
 <ram:SpecifiedTradeProduct>
 <ram:Name>TGA Obermonteur/Monteur</ram:Name>
 </ram:SpecifiedTradeProduct>
 <ram:SpecifiedLineTradeAgreement>
 <ram:GrossPriceProductTradePrice>
 <ram:ChargeAmount>43.2</ram:ChargeAmount>
 </ram:GrossPriceProductTradePrice>
 <ram:NetPriceProductTradePrice>
 <ram:ChargeAmount>43.2</ram:ChargeAmount>
 </ram:NetPriceProductTradePrice>
 </ram:SpecifiedLineTradeAgreement>
 <ram:SpecifiedLineTradeDelivery>
 <ram:BilledQuantity unitCode="HUR">3</ram:BilledQuantity>
 </ram:SpecifiedLineTradeDelivery>
 <ram:SpecifiedLineTradeSettlement>
 <ram:ApplicableTradeTax>
 <ram:TypeCode>VAT</ram:TypeCode>
 <ram:CategoryCode>S</ram:CategoryCode>
 <ram:RateApplicablePercent>19</ram:RateApplicablePercent>
 </ram:ApplicableTradeTax>
 <ram:SpecifiedTradeSettlementLineMonetarySummation>
 <ram:LineTotalAmount>129.6</ram:LineTotalAmount>
 </ram:SpecifiedTradeSettlementLineMonetarySummation>
 </ram:SpecifiedLineTradeSettlement>
 </ram:IncludedSupplyChainTradeLineItem>
 <ram:IncludedSupplyChainTradeLineItem>
 <ram:AssociatedDocumentLineDocument>
 <ram:LineID>02</ram:LineID>
 <ram:IncludedNote>
 <ram:Content>02 Außerhalb Angebot</ram:Content>
 </ram:IncludedNote>
 </ram:AssociatedDocumentLineDocument>
 <ram:SpecifiedTradeProduct>
 <ram:Name>Beamer-Deckenhalterung</ram:Name>
 </ram:SpecifiedTradeProduct>
 <ram:SpecifiedLineTradeAgreement>
 <ram:GrossPriceProductTradePrice>
 <ram:ChargeAmount>122.5</ram:ChargeAmount>
 </ram:GrossPriceProductTradePrice>
 <ram:NetPriceProductTradePrice>
 <ram:ChargeAmount>122.5</ram:ChargeAmount>
 </ram:NetPriceProductTradePrice>
 </ram:SpecifiedLineTradeAgreement>
 <ram:SpecifiedLineTradeDelivery>
 <ram:BilledQuantity unitCode="H87">1</ram:BilledQuantity>
 </ram:SpecifiedLineTradeDelivery>
 <ram:SpecifiedLineTradeSettlement>
 <ram:ApplicableTradeTax>
 <ram:TypeCode>VAT</ram:TypeCode>
 <ram:CategoryCode>S</ram:CategoryCode>
 <ram:RateApplicablePercent>19</ram:RateApplicablePercent>
 </ram:ApplicableTradeTax>
 <ram:SpecifiedTradeSettlementLineMonetarySummation>
 <ram:LineTotalAmount>122.5</ram:LineTotalAmount>
 </ram:SpecifiedTradeSettlementLineMonetarySummation>
 </ram:SpecifiedLineTradeSettlement>
 </ram:IncludedSupplyChainTradeLineItem>
 <ram:ApplicableHeaderTradeAgreement> 
 <ram:BuyerReference>Liselotte Müller-Lüdenscheidt</ram:BuyerReference>
 <ram:SellerTradeParty>
 <ram:ID>549910</ram:ID>
 <ram:Name>ELEKTRON Industrieservice GmbH</ram:Name>
 <ram:Description>Geschäftsführer Egon Schrempp Amtsgericht Stuttgart HRB 1234</ram:Description>
 <ram:PostalTradeAddress>
 <ram:PostcodeCode>74465</ram:PostcodeCode>
 <ram:LineOne>Erfurter Strasse 13</ram:LineOne>
 <ram:CityName>Demoort</ram:CityName>
 <ram:CountryID>DE</ram:CountryID>
 </ram:PostalTradeAddress>
 <ram:SpecifiedTaxRegistration>
 <ram:ID schemeID="VA">DE136695976</ram:ID>
 </ram:SpecifiedTaxRegistration>
 </ram:SellerTradeParty>
 <ram:BuyerTradeParty>
 <ram:ID>16259</ram:ID>
 <ram:Name>ConsultingService GmbH</ram:Name>
 <ram:PostalTradeAddress>
 <ram:PostcodeCode>76138</ram:PostcodeCode>
 <ram:LineOne>Musterstr. 18</ram:LineOne>
 <ram:CityName>Karlsruhe</ram:CityName>
 <ram:CountryID>DE</ram:CountryID>
 </ram:PostalTradeAddress>
 </ram:BuyerTradeParty>
 <ram:SellerOrderReferencedDocument>
 <ram:IssuerAssignedID>per Mail vom 01.09.2024</ram:IssuerAssignedID>
 </ram:SellerOrderReferencedDocument>
 <ram:AdditionalReferencedDocument>
 <ram:IssuerAssignedID>13130162</ram:IssuerAssignedID>
 <ram:URIID>#ef=Aufmass.png</ram:URIID>
 <ram:TypeCode>916</ram:TypeCode>
 </ram:AdditionalReferencedDocument>
 <ram:AdditionalReferencedDocument>
 <ram:IssuerAssignedID>42389</ram:IssuerAssignedID>
 <ram:URIID>#ef=ElektronRapport_neu-red.pdf</ram:URIID>
 <ram:TypeCode>916</ram:TypeCode>
 </ram:AdditionalReferencedDocument>
 <ram:SpecifiedProcuringProject>
 <ram:ID>13130162</ram:ID>
 <ram:Name>Projekt</ram:Name>
 </ram:SpecifiedProcuringProject>
 </ram:ApplicableHeaderTradeAgreement>
 <ram:ApplicableHeaderTradeDelivery>
 <ram:ActualDeliverySupplyChainEvent>
 <ram:OccurrenceDateTime>
 <udt:DateTimeString format="102">20241101</udt:DateTimeString>
 </ram:OccurrenceDateTime>
 </ram:ActualDeliverySupplyChainEvent>
 </ram:ApplicableHeaderTradeDelivery>
 <ram:ApplicableHeaderTradeSettlement>
 <ram:PaymentReference>Rechnung 181301674</ram:PaymentReference>
 <ram:InvoiceCurrencyCode>EUR</ram:InvoiceCurrencyCode>
 <ram:SpecifiedTradeSettlementPaymentMeans>
 <ram:TypeCode>58</ram:TypeCode>
 <ram:PayeePartyCreditorFinancialAccount>
 <ram:IBANID>DE91100000000123456789</ram:IBANID>
 </ram:PayeePartyCreditorFinancialAccount>
 </ram:SpecifiedTradeSettlementPaymentMeans>
 <ram:ApplicableTradeTax>
 <ram:CalculatedAmount>47.9</ram:CalculatedAmount>
 <ram:TypeCode>VAT</ram:TypeCode>
 <ram:BasisAmount>252.1</ram:BasisAmount>
 <ram:CategoryCode>S</ram:CategoryCode>
 <ram:RateApplicablePercent>19</ram:RateApplicablePercent>
 </ram:ApplicableTradeTax>
 <ram:SpecifiedTradePaymentTerms>
 <ram:Description>Zahlbar sofort rein netto</ram:Description>
 </ram:SpecifiedTradePaymentTerms>
 <ram:SpecifiedTradeSettlementHeaderMonetarySummation>
 <ram:LineTotalAmount>252.1</ram:LineTotalAmount>
 <ram:ChargeTotalAmount>0</ram:ChargeTotalAmount>
 <ram:AllowanceTotalAmount>0</ram:AllowanceTotalAmount>
 <ram:TaxBasisTotalAmount>252.1</ram:TaxBasisTotalAmount>
 <ram:TaxTotalAmount currencyID="EUR">47.9</ram:TaxTotalAmount>
 <ram:GrandTotalAmount>300</ram:GrandTotalAmount>
 <ram:TotalPrepaidAmount>0</ram:TotalPrepaidAmount>
 <ram:DuePayableAmount>300</ram:DuePayableAmount>
 </ram:SpecifiedTradeSettlementHeaderMonetarySummation>
 <ram:ReceivableSpecifiedTradeAccountingAccount>
 <ram:ID>420</ram:ID>
 </ram:ReceivableSpecifiedTradeAccountingAccount>
 </ram:ApplicableHeaderTradeSettlement>
 </rsm:SupplyChainTradeTransaction>
 </rsm:CrossIndustryInvoice>
 XML;

// Embeds the XML with the file name, MIME type and /AFRelationship required by the
// profile, and adds the PDF/A extension schema and the profile XMP properties.
$pdf->setFacturX(
 xml: $invoiceXML,
 profile: \Com\Tecnick\Pdf\HybridProfile::FacturX,
 level: \Com\Tecnick\Pdf\HybridConformance::En16931,
);

// =============================================================

$rawpdf = $pdf->getOutPDFString();

$pdf->renderPDF(rawpdf: $rawpdf);

Example E002 : font dump

Sun, 26 Apr 2026 00:00:00 +0000

Dumps the metrics and glyph coverage of the bundled font families, for checking what a font can actually render.

Rendered PDF: E002_font_dump.pdf
PHP source: E002_font_dump.phps
All examples: /examples/
Category: Fonts
Guide: Fonts

PDF

Source Code

<?php

declare(strict_types=1);

/**
 * E002_font_dump.php
 *
 * @since 2026-04-19
 * @category Library
 * @package Pdf
 * @author Nicola Asuni <info@tecnick.com>
 * @copyright 2002-2026 Nicola Asuni - Tecnick.com LTD
 * @license https://www.gnu.org/copyleft/lesser.html GNU-LGPL v3 (see LICENSE)
 * @link https://github.com/tecnickcom/tc-lib-pdf
 *
 * This file is part of tc-lib-pdf software library.
 */

// NOTE: local file reads (images, fonts, attachments) are restricted to an allowlist of
// trusted paths that covers this package tree, so run the examples in place. To read assets
// from other locations, list them in the 'allowedPaths' entry of the fileOptions constructor
// parameter (see E047_remote_resources_security.php).

// NOTE: run make fonts in the project root to generate the dependencies and example fonts.

// autoloader when using Composer
require __DIR__ . '/../vendor/autoload.php';

// define fonts directory
\define('K_PATH_FONTS', \realpath(__DIR__ . '/../vendor/tecnickcom/tc-lib-pdf-font/target/fonts'));

// autoloader when using RPM or DEB package installation
//require ('/usr/share/php/Com/Tecnick/Pdf/autoload.php');

// main TCPDF object
$pdf = new \Com\Tecnick\Pdf\Tcpdf(
 unit: \Com\Tecnick\Pdf\Page\Unit::Millimeter,
 isunicode: true,
 subsetfont: false,
 compress: true,
 mode: \Com\Tecnick\Pdf\PdfConformance::None,
 objEncrypt: null,
);

// ----------

$pdf->setCreator('tc-lib-pdf');
$pdf->setAuthor('Nicola Asuni');
$pdf->setSubject('tc-lib-pdf example: 002');
$pdf->setTitle('Font Dump and Glyph Coverage');
$pdf->setKeywords('TCPDF tc-lib-pdf fonts glyphs unicode dump metrics');
$pdf->setPDFFilename('002_font_dump.pdf');

$pdf->setViewerPreferences(['DisplayDocTitle' => true]);

$pdf->enableDefaultPageContent();

// ----------
// Insert fonts

$titlefont = $pdf->font->insert($pdf->pon, 'helvetica', 'B', 16);

// core font families and styles
$corefonts = [
 ['family' => 'courier', 'style' => ''],
 ['family' => 'courier', 'style' => 'B'],
 ['family' => 'courier', 'style' => 'I'],
 ['family' => 'courier', 'style' => 'BI'],
 ['family' => 'helvetica', 'style' => ''],
 ['family' => 'helvetica', 'style' => 'B'],
 ['family' => 'helvetica', 'style' => 'I'],
 ['family' => 'helvetica', 'style' => 'BI'],
 ['family' => 'times', 'style' => ''],
 ['family' => 'times', 'style' => 'B'],
 ['family' => 'times', 'style' => 'I'],
 ['family' => 'times', 'style' => 'BI'],
 ['family' => 'symbol', 'style' => ''],
 ['family' => 'zapfdingbats', 'style' => ''],
];

foreach ($corefonts as $fontcfg) {
 $family = $fontcfg['family'];
 $style = $fontcfg['style'];
 $fontname = $family . ($style !== '' ? ' ' . $style : '');

 $page = $pdf->addPage();
 $pdf->setBookmark(
 name: 'Font: ' . $fontname,
 link: '',
 level: 0,
 page: -1,
 posx: 0,
 posy: 0,
 fstyle: 'B',
 color: '',
 );

 // title
 $pdf->page->addContent($titlefont['out']);
 $title = $pdf->getTextCell(
 'FONT: ' . $fontname,
 15,
 15,
 180,
 10,
 valign: \Com\Tecnick\Pdf\TextVAlign::Center,
 halign: \Com\Tecnick\Pdf\TextHAlign::Center,
 );
 $pdf->page->addContent($title);

 // glyph table font
 $charfont = $pdf->font->insert($pdf->pon, $family, $style, 16);
 $pdf->page->addContent($charfont['out']);

 // render character table (0-255) as a 16x16 grid
 for ($i = 0; $i < 256; ++$i) {
 $col = $i % 16;
 $row = (int) ($i / 16);
 $posx = 15 + ($col * 11.25);
 $posy = 30 + ($row * 11.25);

 $txt = $pdf->uniconv->chr($i);
 $cell = $pdf->getTextCell(
 $txt,
 $posx,
 $posy,
 11.25,
 11.25,
 valign: \Com\Tecnick\Pdf\TextVAlign::Center,
 halign: \Com\Tecnick\Pdf\TextHAlign::Center,
 );
 $pdf->page->addContent($cell);
 }

 $pangram = $pdf->getTextCell(
 'The quick brown fox jumps over the lazy dog',
 15,
 220,
 180,
 8,
 valign: \Com\Tecnick\Pdf\TextVAlign::Center,
 halign: \Com\Tecnick\Pdf\TextHAlign::Center,
 );
 $pdf->page->addContent($pangram);
}

// =============================================================

$rawpdf = $pdf->getOutPDFString();

$pdf->renderPDF(rawpdf: $rawpdf);

Example E003 : rtl languages

Sun, 26 Apr 2026 00:00:00 +0000

Persian and Arabic right-to-left text, with Arabic shaping driven by the Joining_Type property and the lam-alef and allah ligatures.

Rendered PDF: E003_rtl_languages.pdf
PHP source: E003_rtl_languages.phps
All examples: /examples/
Category: Multilingual Text

PDF

Source Code

<?php

declare(strict_types=1);

/**
 * E003_persian_arabic.php
 *
 * @since 2026-04-19
 * @category Library
 * @package Pdf
 * @author Nicola Asuni <info@tecnick.com>
 * @copyright 2002-2026 Nicola Asuni - Tecnick.com LTD
 * @license https://www.gnu.org/copyleft/lesser.html GNU-LGPL v3 (see LICENSE)
 * @link https://github.com/tecnickcom/tc-lib-pdf
 *
 * This file is part of tc-lib-pdf software library.
 */

// NOTE: local file reads (images, fonts, attachments) are restricted to an allowlist of
// trusted paths that covers this package tree, so run the examples in place. To read assets
// from other locations, list them in the 'allowedPaths' entry of the fileOptions constructor
// parameter (see E047_remote_resources_security.php).

// NOTE: run make fonts in the project root to generate the dependencies and example fonts.

// autoloader when using Composer
require __DIR__ . '/../vendor/autoload.php';

// define fonts directory
\define('K_PATH_FONTS', \realpath(__DIR__ . '/../vendor/tecnickcom/tc-lib-pdf-font/target/fonts'));

// autoloader when using RPM or DEB package installation
//require ('/usr/share/php/Com/Tecnick/Pdf/autoload.php');

// main TCPDF object
$pdf = new \Com\Tecnick\Pdf\Tcpdf(
 unit: \Com\Tecnick\Pdf\Page\Unit::Millimeter,
 isunicode: true,
 subsetfont: false,
 compress: false,
 mode: \Com\Tecnick\Pdf\PdfConformance::None,
 objEncrypt: null,
);

// ----------

$pdf->setCreator('tc-lib-pdf');
$pdf->setAuthor('Nicola Asuni');
$pdf->setSubject('tc-lib-pdf example: 003');
$pdf->setTitle('Persian and Arabic RTL Text Rendering');
$pdf->setKeywords('TCPDF tc-lib-pdf persian arabic rtl bidi unicode shaping');
$pdf->setPDFFilename('003_persian_arabic.pdf');

$pdf->setViewerPreferences(['DisplayDocTitle' => true]);

$pdf->enableDefaultPageContent(false);

$bfont = $pdf->font->insert($pdf->pon, 'dejavusans', '', 12);

// ----------

$txtEngPersian = 'PERSIAN: "The process of printing and correctly displaying Persian texts in digital systems requires full support for the Unicode standard and right-to-left layout. In this test text, all letters of the Persian alphabet, including specific letters like "Pe", "Che", "Zhe", and "Gaf", are included to verify their correct connectivity. Additionally, the use of Persian numbers (1234567890) and punctuation marks like commas (,) and semicolons (;) is essential for accurately measuring the alignment of lines and margins on multi-line pages."';

$txtPersian = 'فرآیند چاپ و نمایش صحیح متون فارسی در سیستم‌های دیجیتال نیازمند پشتیبانی کامل از استاندارد یونیکد و چیدمان راست‌به‌چپ است. در این متن آزمایشی، تمامی حروف الفبای فارسی از جمله حروف خاص مانند «پ»، «چ»، «ژ» و «گ» گنجانده شده‌اند تا صحت اتصال آن‌ها بررسی شود. همچنین استفاده از اعداد فارسی (۱۲۳۴۵۶۷۸۹۰) و علائم نگارشی مانند ویرگول (،) و نقطه‌ویرگول (؛) برای سنجش دقیق ترازبندی خطوط و حاشیه‌های صفحات چندخطی الزامی است.';

$htmlPersian = '<p style="direction:rtl;text-align:right;color:#003366;" lang="fa">فرآیند چاپ و نمایش صحیح متون فارسی در سیستم‌های دیجیتال نیازمند پشتیبانی کامل از استاندارد یونیکد و چیدمان راست‌به‌چپ است. در این متن آزمایشی، تمامی حروف الفبای فارسی از جمله حروف خاص مانند <span style="color:#660000;">«پ»، «چ»، «ژ» و «گ»</span> گنجانده شده‌اند تا صحت اتصال آن‌ها بررسی شود. همچنین استفاده از اعداد فارسی <span style="color:#006600;">(۱۲۳۴۵۶۷۸۹۰)</span> و علائم نگارشی مانند ویرگول (،) و نقطه‌ویرگول (؛) برای سنجش دقیق ترازبندی خطوط و حاشیه‌های صفحات چندخطی الزامی است.</p>';

$txtEngArabic = 'ARABIC: "The process of printing and correctly displaying Arabic texts on digital screens requires full support for the Unicode system and right-to-left formatting. This test text contains various letters, including elongated letters and different Hamzas (أ، إ، آ، ء، ئ، ؤ), to ensure the accuracy of letter connectivity. The text also includes Arabic numerals (1234567890) and punctuation marks such as the comma (،) and semicolon (؛) to verify the integrity of line alignment and multi-page margins."';

$txtArabic = 'إن عملية طباعة النصوص العربية وعرضها بشكل صحيح على الشاشات الرقمية تتطلب دعماً كاملاً لنظام اليونيكود والتنسيق من اليمين إلى اليسار. يحتوي هذا النص التجريبي على حروف متنوعة تشمل الحروف الممدودة والهمزات المختلفة مثل (أ، إ، آ، ء، ئ، ؤ) لضمان دقة اتصال الحروف ببعضها. كما يتضمن النص الأرقام العربية (١٢٣٤٥٦٧٨٩٠) وعلامات الترقيم كالفاصلة (،) والفاصلة المنقوطة (؛) للتحقق من سلامة محاذاة الأسطر وهوامش الصفحات المتعددة.';

$htmlArabic = '<p style="direction:rtl;text-align:right;color:#003366;" lang="ar">إن عملية طباعة النصوص العربية وعرضها بشكل صحيح على الشاشات الرقمية تتطلب دعماً كاملاً لنظام اليونيكود والتنسيق من اليمين إلى اليسار. يحتوي هذا النص التجريبي على حروف متنوعة تشمل الحروف الممدودة والهمزات المختلفة مثل <span style="color:#660000;">(أ، إ، آ، ء، ئ، ؤ)</span> لضمان دقة اتصال الحروف ببعضها. كما يتضمن النص الأرقام العربية <span style="color:#006600;">(١٢٣٤٥٦٧٨٩٠)</span> وعلامات الترقيم كالفاصلة (،) والفاصلة المنقوطة (؛) للتحقق من سلامة محاذاة الأسطر وهوامش الصفحات المتعددة.</p>';

$txtEngHebrew = 'HEBREW: "The process of printing and correctly displaying text in Hebrew on digital systems requires full support for the Unicode standard and right-to-left formatting. In this experimental text, all letters of the alphabet are included, including the final letters (ך, ם, ן, ף, ץ) to verify their correct display. Furthermore, the text integrates numbers (1234567890) and various punctuation marks like a comma (,) and semicolon (;) in order to examine line alignment and page margins in long paragraphs."';

$txtHebrew = 'תהליך ההדפסה וההצגה התקינה של טקסט בעברית במערכות דיגיטליות דורש תמיכה מלאה בתקן יוניקוד ובתצורת כתיבה מימין לשמאל. בטקסט ניסיוני זה נכללו כל אותיות האלפבית, כולל האותיות הסופיות (ך, ם, ן, ף, ץ) כדי לבדוק את תקינות התצוגה שלהן. כמו כן, הטקסט משלב מספרים (1234567890) וסימני פיסוק שונים כמו פסיק (,) ונקודה ופסיק (;) על מנת לבחון את יישור השורות ואת שולי העמודים בפסקאות ארוכות.';

$htmlHebrew = '<p style="direction:rtl;text-align:right;color:#003366;" lang="he">תהליך ההדפסה וההצגה התקינה של טקסט בעברית במערכות דיגיטליות דורש תמיכה מלאה בתקן יוניקוד ובתצורת כתיבה מימין לשמאל. בטקסט ניסיוני זה נכללו כל אותיות האלפבית, כולל האותיות הסופיות <span style="color:#660000;">(ך, ם, ן, ף, ץ)</span> כדי לבדוק את תקינות התצוגה שלהן. כמו כן, הטקסט משלב מספרים <span style="color:#006600;">(1234567890)</span> וסימני פיסוק שונים כמו פסיק (,) ונקודה ופסיק (;) על מנת לבחון את יישור השורות ואת שולי העמודים בפסקאות ארוכות.</p>';

// ----------

$psx = 15;
$lnw = 180;

// ----------

$page = $pdf->addPage();

$pdf->page->addContent($bfont['out']);

$pdf->setRTL(false);
$pdf->addHTMLCell(
 html: '<h1>RTL (Right-To-Left) Examples</h1><h2>1. getTextCell()</h2>',
 posx: $psx,
 posy: 15,
 width: $lnw,
);

$pdf->setRTL(false);
$pdf->page->addContent($pdf->getTextCell(
 txt: $txtEngPersian,
 posx: $psx,
 posy: 40,
 width: $lnw,
 halign: \Com\Tecnick\Pdf\TextHAlign::Left,
));
$pdf->setRTL(true);
$pdf->page->addContent($pdf->getTextCell(
 txt: $txtPersian,
 posx: $psx,
 posy: 80,
 width: $lnw,
 halign: \Com\Tecnick\Pdf\TextHAlign::Right,
));

$pdf->setRTL(false);
$pdf->page->addContent($pdf->getTextCell(
 txt: $txtEngArabic,
 posx: $psx,
 posy: 120,
 width: $lnw,
 halign: \Com\Tecnick\Pdf\TextHAlign::Left,
));
$pdf->setRTL(true);
$pdf->page->addContent($pdf->getTextCell(
 txt: $txtArabic,
 posx: $psx,
 posy: 160,
 width: $lnw,
 halign: \Com\Tecnick\Pdf\TextHAlign::Right,
));

$pdf->setRTL(false);
$pdf->page->addContent($pdf->getTextCell(
 txt: $txtEngHebrew,
 posx: $psx,
 posy: 200,
 width: $lnw,
 halign: \Com\Tecnick\Pdf\TextHAlign::Left,
));
$pdf->setRTL(true);
$pdf->page->addContent($pdf->getTextCell(
 txt: $txtHebrew,
 posx: $psx,
 posy: 240,
 width: $lnw,
 halign: \Com\Tecnick\Pdf\TextHAlign::Right,
));

// ----------

$page = $pdf->addPage();

$pdf->page->addContent($bfont['out']);

$pdf->setRTL(false);
$pdf->addHTMLCell(html: '<h2>2. addTextCell()</h2>', posx: $psx, posy: 15, width: $lnw);

$pdf->setRTL(false);
$pdf->addTextCell(
 txt: $txtEngPersian,
 posx: $psx,
 posy: 40,
 width: $lnw,
 halign: \Com\Tecnick\Pdf\TextHAlign::Left,
 drawcell: false,
);
$pdf->setRTL(true);
$pdf->addTextCell(
 txt: $txtPersian,
 posx: $psx,
 posy: 80,
 width: $lnw,
 halign: \Com\Tecnick\Pdf\TextHAlign::Right,
 drawcell: false,
);

$pdf->setRTL(false);
$pdf->addTextCell(
 txt: $txtEngArabic,
 posx: $psx,
 posy: 120,
 width: $lnw,
 halign: \Com\Tecnick\Pdf\TextHAlign::Left,
 drawcell: false,
);
$pdf->setRTL(true);
$pdf->addTextCell(
 txt: $txtArabic,
 posx: $psx,
 posy: 160,
 width: $lnw,
 halign: \Com\Tecnick\Pdf\TextHAlign::Right,
 drawcell: false,
);

$pdf->setRTL(false);
$pdf->addTextCell(
 txt: $txtEngHebrew,
 posx: $psx,
 posy: 200,
 width: $lnw,
 halign: \Com\Tecnick\Pdf\TextHAlign::Left,
 drawcell: false,
);
$pdf->setRTL(true);
$pdf->addTextCell(
 txt: $txtHebrew,
 posx: $psx,
 posy: 240,
 width: $lnw,
 halign: \Com\Tecnick\Pdf\TextHAlign::Right,
 drawcell: false,
);

// ----------

$page = $pdf->addPage();

$pdf->page->addContent($bfont['out']);

$pdf->setRTL(false);
$pdf->addHTMLCell(html: '<h2>3. getHTMLCell() - simple text</h2>', posx: $psx, posy: 15, width: $lnw);

$pdf->setRTL(false);
$pdf->page->addContent($pdf->getHTMLCell(html: $txtEngPersian, posx: $psx, posy: 40, width: $lnw));
$pdf->setRTL(true);
$pdf->page->addContent($pdf->getHTMLCell(html: $txtPersian, posx: $psx, posy: 80, width: $lnw));

$pdf->setRTL(false);
$pdf->page->addContent($pdf->getHTMLCell(html: $txtEngArabic, posx: $psx, posy: 120, width: $lnw));
$pdf->setRTL(true);
$pdf->page->addContent($pdf->getHTMLCell(html: $txtArabic, posx: $psx, posy: 160, width: $lnw));

$pdf->setRTL(false);
$pdf->page->addContent($pdf->getHTMLCell(html: $txtEngHebrew, posx: $psx, posy: 200, width: $lnw));
$pdf->setRTL(true);
$pdf->page->addContent($pdf->getHTMLCell(html: $txtHebrew, posx: $psx, posy: 240, width: $lnw));

// ----------

$page = $pdf->addPage();

$pdf->page->addContent($bfont['out']);

$pdf->setRTL(false);
$pdf->addHTMLCell(html: '<h2>4. addtHTMLCell() - simple text</h2>', posx: $psx, posy: 15, width: $lnw);

$pdf->setRTL(false);
$pdf->addHTMLCell(html: $txtEngPersian, posx: $psx, posy: 40, width: $lnw);
$pdf->setRTL(true);
$pdf->addHTMLCell(html: $txtPersian, posx: $psx, posy: 80, width: $lnw);

$pdf->setRTL(false);
$pdf->addHTMLCell(html: $txtEngArabic, posx: $psx, posy: 120, width: $lnw);
$pdf->setRTL(true);
$pdf->addHTMLCell(html: $txtArabic, posx: $psx, posy: 160, width: $lnw);

$pdf->setRTL(false);
$pdf->addHTMLCell(html: $txtEngHebrew, posx: $psx, posy: 200, width: $lnw);
$pdf->setRTL(true);
$pdf->addHTMLCell(html: $txtHebrew, posx: $psx, posy: 240, width: $lnw);

// ----------

$page = $pdf->addPage();

$pdf->page->addContent($bfont['out']);

$pdf->setRTL(false);
$pdf->addHTMLCell(html: '<h2>5. getHTMLCell() - HTML fragments</h2>', posx: $psx, posy: 15, width: $lnw);

$pdf->page->addContent($pdf->getHTMLCell(html: $txtEngPersian, posx: $psx, posy: 40, width: $lnw));
$pdf->page->addContent($pdf->getHTMLCell(html: $htmlPersian, posx: $psx, posy: 80, width: $lnw));

$pdf->page->addContent($pdf->getHTMLCell(html: $txtEngArabic, posx: $psx, posy: 120, width: $lnw));
$pdf->page->addContent($pdf->getHTMLCell(html: $htmlArabic, posx: $psx, posy: 160, width: $lnw));

$pdf->page->addContent($pdf->getHTMLCell(html: $txtEngHebrew, posx: $psx, posy: 200, width: $lnw));
$pdf->page->addContent($pdf->getHTMLCell(html: $htmlHebrew, posx: $psx, posy: 240, width: $lnw));

// ----------

$page = $pdf->addPage();

$pdf->page->addContent($bfont['out']);

$pdf->addHTMLCell(html: '<h2>6. addtHTMLCell() - HTML fragments</h2>', posx: $psx, posy: 15, width: $lnw);

$pdf->addHTMLCell(html: $txtEngPersian, posx: $psx, posy: 40, width: $lnw);
$pdf->addHTMLCell(html: $htmlPersian, posx: $psx, posy: 80, width: $lnw);

$pdf->addHTMLCell(html: $txtEngArabic, posx: $psx, posy: 120, width: $lnw);
$pdf->addHTMLCell(html: $htmlArabic, posx: $psx, posy: 160, width: $lnw);

$pdf->addHTMLCell(html: $txtEngHebrew, posx: $psx, posy: 200, width: $lnw);
$pdf->addHTMLCell(html: $htmlHebrew, posx: $psx, posy: 240, width: $lnw);

// ----------

$page = $pdf->addPage();

$pdf->page->addContent($bfont['out']);

$pdf->addHTMLCell(html: '<h2>7. addtHTMLCell() - HTML fragments with images</h2>', posx: $psx, posy: 15, width: $lnw);

$rtlHtmlWithImage = '<p style="direction:rtl;text-align:right;color:#003366;" lang="fa"><img src="images/tcpdf_logo.jpg" alt="TCPDF logo" height="3mm" border="0" /> فرآیند چاپ و نمایش صحیح متون فارسی در سیستم‌های دیجیتال نیازمند پشتیبانی کامل از استاندارد یونیکد و چیدمان راست‌به‌چپ است. در این متن آزمایشی، تمامی حروف الفبای فارسی از جمله حروف خاص مانند <img src="images/tcpdf_logo.jpg" alt="TCPDF logo" height="3mm" border="0" /> <span style="color:#660000;">«پ»، «چ»، «ژ» و «گ»</span> گنجانده شده‌اند تا صحت اتصال آن‌ها بررسی شود. همچنین استفاده از اعداد فارسی <img src="images/tcpdf_logo.jpg" alt="TCPDF logo" height="3mm" border="0" /> <span style="color:#006600;">(۱۲۳۴۵۶۷۸۹۰)</span> و علائم نگارشی مانند ویرگول (،) و نقطه‌ویرگول (؛) برای سنجش دقیق ترازبندی خطوط و حاشیه‌های صفحات چندخطی الزامی است. <img src="images/tcpdf_logo.jpg" alt="TCPDF logo" height="3mm" border="0" /></p>';

$pdf->addHTMLCell(html: $rtlHtmlWithImage, posx: $psx, posy: 40, width: $lnw);

// ----------

$page = $pdf->addPage();

$pdf->page->addContent($bfont['out']);

$pdf->addHTMLCell(
 html: '<h2>8. addHTMLCell() - RTL paragraph spanning a page break</h2>',
 posx: $psx,
 posy: 15,
 width: $lnw,
);

// A long multi-fragment RTL paragraph placed low on the page so that it overflows
// the page bottom and must continue on the next page. This exercises Stage 2e (RTL
// region/page continuation): the inter-fragment engine must flow the remaining
// right-to-left lines into the next page, keeping them top-down and right-to-left,
// instead of falling back to the forward-cursor renderer. See
// PLAN_RTL_HTML_FRAGMENTS.md increment 4.
$arabicSpanCycle =
 $txtArabic
 . ' <span style="color:#660000;">'
 . $txtArabic
 . '</span> '
 . $txtArabic
 . ' <span style="color:#006600;">'
 . $txtArabic
 . '</span> ';
$htmlArabicLong =
 '<p style="direction:rtl;text-align:right;color:#003366;" lang="ar">' . \str_repeat($arabicSpanCycle, 2) . '</p>';
$pdf->addHTMLCell(html: $htmlArabicLong, posx: $psx, posy: 180, width: $lnw);

// =============================================================

$rawpdf = $pdf->getOutPDFString();

$pdf->renderPDF(rawpdf: $rawpdf);

Example E004 : page formats

Sun, 26 Apr 2026 00:00:00 +0000

Named page formats from the ISO, ANSI, JIS, envelope, and photographic series, page orientation, and arbitrary custom sizes.

Rendered PDF: E004_page_formats.pdf
PHP source: E004_page_formats.phps
All examples: /examples/
Category: Pages and Layout

PDF

Source Code

<?php

declare(strict_types=1);

/**
 * E004_page_formats.php
 *
 * @since 2026-04-19
 * @category Library
 * @package Pdf
 * @author Nicola Asuni <info@tecnick.com>
 * @copyright 2002-2026 Nicola Asuni - Tecnick.com LTD
 * @license https://www.gnu.org/copyleft/lesser.html GNU-LGPL v3 (see LICENSE)
 * @link https://github.com/tecnickcom/tc-lib-pdf
 *
 * This file is part of tc-lib-pdf software library.
 */

// NOTE: local file reads (images, fonts, attachments) are restricted to an allowlist of
// trusted paths that covers this package tree, so run the examples in place. To read assets
// from other locations, list them in the 'allowedPaths' entry of the fileOptions constructor
// parameter (see E047_remote_resources_security.php).

// NOTE: run make fonts in the project root to generate the dependencies and example fonts.

// autoloader when using Composer
require __DIR__ . '/../vendor/autoload.php';

// define fonts directory
\define('K_PATH_FONTS', \realpath(__DIR__ . '/../vendor/tecnickcom/tc-lib-pdf-font/target/fonts'));

// autoloader when using RPM or DEB package installation
//require ('/usr/share/php/Com/Tecnick/Pdf/autoload.php');

// main TCPDF object
$pdf = new \Com\Tecnick\Pdf\Tcpdf(
 unit: \Com\Tecnick\Pdf\Page\Unit::Millimeter,
 isunicode: true,
 subsetfont: false,
 compress: true,
 mode: \Com\Tecnick\Pdf\PdfConformance::None,
 objEncrypt: null,
);

// ----------

$pdf->setCreator('tc-lib-pdf');
$pdf->setAuthor('Nicola Asuni');
$pdf->setSubject('tc-lib-pdf example: 004');
$pdf->setTitle('Page Formats and Orientation');
$pdf->setKeywords('TCPDF tc-lib-pdf page formats orientation A4 Letter custom size');
$pdf->setPDFFilename('004_page_formats.pdf');

$pdf->setViewerPreferences(['DisplayDocTitle' => true]);

$pdf->enableDefaultPageContent(false);

// ----------
// Get all page formats from the Format class
$formats = \Com\Tecnick\Pdf\Page\Format::FORMAT;

// Insert monospace font
$bfont = $pdf->font->insert($pdf->pon, 'courier', '', 8);

// Conversion factor: points to mm and inches
$mmRatio = \Com\Tecnick\Pdf\Page\Format::UNITRATIO['mm'];
$inRatio = \Com\Tecnick\Pdf\Page\Format::UNITRATIO['in'];

// Loop through all formats
foreach ($formats as $formatName => $dimensions) {
 // Add a new page using the named format.
 $page = $pdf->addPage(['format' => $formatName]);

 // Get dimensions.
 $widthPt = $dimensions[0];
 $heightPt = $dimensions[1];

 // Calculate dimensions in mm and inches.
 $widthMm = $widthPt / $mmRatio;
 $heightMm = $heightPt / $mmRatio;
 $widthIn = $widthPt / $inRatio;
 $heightIn = $heightPt / $inRatio;

 // Print multiline text at top-left corner.
 $x = 2;
 $y = 2;
 $w = 60;

 // Define multiline HTML text to display.
 $html = '<h2>' . $formatName . '</h2>';

 if ($page['width'] > ($w + (2 * $x))) {
 $html .= '<table border="1" cellspacing="0" cellpadding="2" style="text-align:right">
 <tr><th>unit</th><th>width</th><th>height</th></tr>';
 $html .= \sprintf('<tr><td>mm</td><td>%.3f</td><td>%.3f</td></tr>', $widthMm, $heightMm);
 $html .= \sprintf('<tr><td>in</td><td>%.3f</td><td>%.3f</td></tr>', $widthIn, $heightIn);
 $html .= \sprintf('<tr><td>pt</td><td>%.3f</td><td>%.3f</td></tr>', $widthPt, $heightPt);
 $html .= '</table>';
 }

 $pdf->page->addContent($bfont['out']);
 $pdf->page->addContent($pdf->getHTMLCell($html, $x, $y, $w));
}

// =============================================================

$rawpdf = $pdf->getOutPDFString();

$pdf->renderPDF(rawpdf: $rawpdf);

Example E005 : header footer

Sun, 26 Apr 2026 00:00:00 +0000

Page headers, footers, and default page content applied across a multi-page document.

Rendered PDF: E005_header_footer.pdf
PHP source: E005_header_footer.phps
All examples: /examples/
Category: Pages and Layout

PDF

Source Code

<?php

declare(strict_types=1);

/**
 * E005_header_footer.php
 *
 * @since 2026-04-19
 * @category Library
 * @package Pdf
 * @author Nicola Asuni <info@tecnick.com>
 * @copyright 2002-2026 Nicola Asuni - Tecnick.com LTD
 * @license https://www.gnu.org/copyleft/lesser.html GNU-LGPL v3 (see LICENSE)
 * @link https://github.com/tecnickcom/tc-lib-pdf
 *
 * This file is part of tc-lib-pdf software library.
 */

// NOTE: local file reads (images, fonts, attachments) are restricted to an allowlist of
// trusted paths that covers this package tree, so run the examples in place. To read assets
// from other locations, list them in the 'allowedPaths' entry of the fileOptions constructor
// parameter (see E047_remote_resources_security.php).

// NOTE: run make fonts in the project root to generate the dependencies and example fonts.

// autoloader when using Composer
require __DIR__ . '/../vendor/autoload.php';

// define fonts directory
\define('K_PATH_FONTS', \realpath(__DIR__ . '/../vendor/tecnickcom/tc-lib-pdf-font/target/fonts'));

// autoloader when using RPM or DEB package installation
//require ('/usr/share/php/Com/Tecnick/Pdf/autoload.php');

// ----------

/**
 * Custom PDF class with a repeating page header and footer.
 *
 * Extends Tcpdf and overrides defaultPageContent() so that every
 * new page automatically receives a branded header and a numbered footer.
 * The mechanism is activated by calling enableDefaultPageContent(true).
 */
class PdfWithHeaderFooter extends \Com\Tecnick\Pdf\Tcpdf
{
 /** Horizontal margin used by the header and footer bands (mm). */
 private const HF_MARGIN = 10.0;

 /** Height of the header band (mm). */
 private const HEADER_H = 12.0;

 /** Height of the footer band (mm). */
 private const FOOTER_H = 10.0;

 /** Document title shown left-aligned in the header. */
 private string $headerTitle = '';

 /** Subtitle / date shown right-aligned in the header. */
 private string $headerSubtitle = '';

 /**
 * Set the text displayed in the page header.
 *
 * @param string $title Left-aligned title.
 * @param string $subtitle Right-aligned subtitle (e.g. date or company name).
 */
 public function setHeaderText(string $title, string $subtitle): void
 {
 $this->headerTitle = $title;
 $this->headerSubtitle = $subtitle;
 }

 /**
 * Generates the repeating header and footer for every page.
 *
 * This method is called automatically by setPageContext() whenever a new
 * page is added, provided enableDefaultPageContent(true) has been called.
 *
 * @param int $pid Page index (0-based).
 *
 * @return string Raw PDF stream prepended to the page content.
 */
 public function defaultPageContent(int $pid = -1): string
 {
 if ($pid < 0) {
 $pid = $this->page->getPageId();
 }

 // Insert the default font once and cache it for subsequent pages.
 if ($this->defaultfont === null) {
 $this->defaultfont = $this->font->insert($this->pon, 'helvetica', '', 9);
 }

 $page = $this->page->getPage($pid);
 $pw = $page['width'];
 $ph = $page['height'];

 $lm = self::HF_MARGIN; // left margin x
 $rm = $pw - self::HF_MARGIN; // right margin x
 $tw = $pw - (2 * self::HF_MARGIN); // usable band width

 $lineStyle = [
 'lineWidth' => 0.25,
 'lineCap' => 'butt',
 'lineJoin' => 'miter',
 'dashArray' => [],
 'dashPhase' => 0,
 'lineColor' => '#555555',
 ];

 $out = '';

 // ---- HEADER ------------------------------------------------

 $headerY = self::HF_MARGIN;
 $headerOut = $this->graph->getStartTransform();
 $headerOut .= $this->defaultfont['out'];

 // Title – left-aligned, bold
 if ($this->headerTitle !== '') {
 $bfontBold = $this->font->insert($this->pon, 'helvetica', 'B', 10);
 $headerOut .= $bfontBold['out'];
 $headerOut .= $this->color->getPdfColor('#1a3a6b');
 $headerOut .= $this->getTextCell(
 txt: $this->headerTitle,
 posx: $lm,
 posy: $headerY,
 width: $tw * 0.65,
 height: self::HEADER_H,
 offset: 0,
 linespace: 0,
 valign: \Com\Tecnick\Pdf\TextVAlign::Center,
 halign: \Com\Tecnick\Pdf\TextHAlign::Left,
 );
 $headerOut .= $this->defaultfont['out'];
 }

 // Subtitle – right-aligned
 if ($this->headerSubtitle !== '') {
 $headerOut .= $this->color->getPdfColor('#555555');
 $headerOut .= $this->getTextCell(
 txt: $this->headerSubtitle,
 posx: $lm + ($tw * 0.65),
 posy: $headerY,
 width: $tw * 0.35,
 height: self::HEADER_H,
 offset: 0,
 linespace: 0,
 valign: \Com\Tecnick\Pdf\TextVAlign::Center,
 halign: \Com\Tecnick\Pdf\TextHAlign::Right,
 );
 }

 // Separator line below the header
 $headerLineY = $headerY + self::HEADER_H;
 $headerOut .= $this->graph->getLine($lm, $headerLineY, $rm, $headerLineY, $lineStyle);
 $headerOut .= $this->graph->getStopTransform();

 $out .= $this->beginArtifact('Pagination', 'Header');
 $out .= $headerOut;
 $out .= $this->endArtifact();

 // ---- FOOTER ------------------------------------------------

 $footerLineY = $ph - self::HF_MARGIN - self::FOOTER_H;
 $footerOut = $this->graph->getStartTransform();
 $footerOut .= $this->defaultfont['out'];

 // Separator line above the footer
 $footerOut .= $this->graph->getLine($lm, $footerLineY, $rm, $footerLineY, $lineStyle);

 // Page number – centred
 $footerOut .= $this->color->getPdfColor('#555555');
 $footerOut .= $this->getTextCell(
 txt: 'Page ' . ($pid + 1),
 posx: $lm,
 posy: $footerLineY,
 width: $tw,
 height: self::FOOTER_H,
 offset: 0,
 linespace: 0,
 valign: \Com\Tecnick\Pdf\TextVAlign::Center,
 halign: \Com\Tecnick\Pdf\TextHAlign::Center,
 );
 $footerOut .= $this->graph->getStopTransform();

 $out .= $this->beginArtifact('Pagination', 'Footer');
 $out .= $footerOut;
 $out .= $this->endArtifact();

 return $out;
 }
}

// ----------

// main PDF object using the custom subclass
$pdf = new PdfWithHeaderFooter(
 'mm', // string $unit = 'mm',
 true, // bool $isunicode = true,
 false, // bool $subsetfont = false,
 true, // bool $compress = true,
 'pdfua1', // string $mode = 'pdfua1',
 null, // ?ObjEncrypt $objEncrypt = null,
);

// ----------

$pdf->setCreator('tc-lib-pdf');
$pdf->setAuthor('Nicola Asuni');
$pdf->setSubject('tc-lib-pdf example: 005');
$pdf->setTitle('Header & Footer Example');
$pdf->setKeywords('TCPDF tc-lib-pdf example header footer');
$pdf->setPDFFilename('005_header_footer.pdf');

$pdf->setViewerPreferences(['DisplayDocTitle' => true]);
$pdf->setLanguageArray(['a_meta_language' => 'en-US']);

// Set the text that will appear in the header on every page.
$pdf->setHeaderText('My Document Title', \date('Y-m-d'));

// Enable automatic header/footer: calls defaultPageContent() for every new page.
$pdf->enableDefaultPageContent();

// ----------
// Insert fonts

$bfont = $pdf->font->insert($pdf->pon, 'helvetica', '', 11);
$bfontB = $pdf->font->insert($pdf->pon, 'helvetica', 'B', 13);

// ----------
// Add first page

$page01 = $pdf->addPage();
$pdf->setBookmark(name: 'Page 1', link: '', level: 0, page: -1, posx: 0, posy: 0, fstyle: 'B', color: 'blue');

// Page content starts below the header band (HF_MARGIN + HEADER_H + separator ≈ 25 mm).
$contentY = 28.0;

$pdf->page->addContent($bfontB['out']);

$title1 = $pdf->getTextCell(
 txt: 'Page 1 — Custom Repeating Header & Footer',
 posx: 10,
 posy: $contentY,
 width: 190,
 height: 0,
 offset: 0,
 linespace: 0,
 valign: \Com\Tecnick\Pdf\TextVAlign::Top,
 halign: \Com\Tecnick\Pdf\TextHAlign::Left,
);
$pdf->page->addContent($title1);

$pdf->page->addContent($bfont['out']);

$body1 = 'This is the first page of a document that demonstrates how to add a custom page header and footer that automatically repeats on every new page using tc-lib-pdf.

The header displays the document title (left) and the date (right), separated from the page content by a thin horizontal rule. The footer shows the page number centred at the bottom, also separated by a horizontal rule.

This is achieved by subclassing \Com\Tecnick\Pdf\Tcpdf and overriding the public defaultPageContent() method, then activating the mechanism once with enableDefaultPageContent(true) before adding any pages.

Because setPageContext() calls defaultPageContent() automatically every time addPage() is used, the header and footer appear on every page without any additional code in the page-building section.';

$txt1 = $pdf->getTextCell(
 txt: $body1,
 posx: 10,
 posy: $contentY + 10,
 width: 190,
 height: 0,
 offset: 15,
 linespace: 2,
 valign: \Com\Tecnick\Pdf\TextVAlign::Top,
 halign: \Com\Tecnick\Pdf\TextHAlign::Justify,
);
$pdf->page->addContent($txt1);

// ----------
// Add second page

$page02 = $pdf->addPage();
$pdf->setBookmark(name: 'Page 2', link: '', level: 0, page: -1, posx: 0, posy: 0, fstyle: 'B', color: 'green');

$pdf->page->addContent($bfontB['out']);

$title2 = $pdf->getTextCell(
 txt: 'Page 2 — Continued Content',
 posx: 10,
 posy: $contentY,
 width: 190,
 height: 0,
 offset: 0,
 linespace: 0,
 valign: \Com\Tecnick\Pdf\TextVAlign::Top,
 halign: \Com\Tecnick\Pdf\TextHAlign::Left,
);
$pdf->page->addContent($title2);

$pdf->page->addContent($bfont['out']);

$body2 = 'This is the second page. The header and footer are present here too without any manual intervention — the overridden defaultPageContent() method takes care of them automatically.

Any further pages added with addPage() would also receive the same header and footer, making the approach suitable for multi-page reports, invoices, or any document type that requires consistent page decoration.';

$txt2 = $pdf->getTextCell(
 txt: $body2,
 posx: 10,
 posy: $contentY + 10,
 width: 190,
 height: 0,
 offset: 15,
 linespace: 2,
 valign: \Com\Tecnick\Pdf\TextVAlign::Top,
 halign: \Com\Tecnick\Pdf\TextHAlign::Justify,
);
$pdf->page->addContent($txt2);

// ----------
// Output the PDF

$rawpdf = $pdf->getOutPDFString();

$pdf->renderPDF(rawpdf: $rawpdf);

Example E006 : minimal

Sun, 26 Apr 2026 00:00:00 +0000

The shortest script that produces a PDF: insert a font, add a page, render an HTML cell, output the bytes.

Rendered PDF: E006_minimal.pdf
PHP source: E006_minimal.phps
All examples: /examples/
Category: Start Here

PDF

Source Code

<?php

declare(strict_types=1);

/**
 * E006_minimal.php
 *
 * @since 2026-04-19
 * @category Library
 * @package Pdf
 * @author Nicola Asuni <info@tecnick.com>
 * @copyright 2002-2026 Nicola Asuni - Tecnick.com LTD
 * @license https://www.gnu.org/copyleft/lesser.html GNU-LGPL v3 (see LICENSE)
 * @link https://github.com/tecnickcom/tc-lib-pdf
 *
 * This file is part of tc-lib-pdf software library.
 */

// NOTE: local file reads (images, fonts, attachments) are restricted to an allowlist of
// trusted paths that covers this package tree, so run the examples in place. To read assets
// from other locations, list them in the 'allowedPaths' entry of the fileOptions constructor
// parameter (see E047_remote_resources_security.php).

// NOTE: run make fonts in the project root to generate the dependencies and example fonts.

// autoloader when using Composer
require __DIR__ . '/../vendor/autoload.php';

// define fonts directory
\define('K_PATH_FONTS', \realpath(__DIR__ . '/../vendor/tecnickcom/tc-lib-pdf-font/target/fonts'));

// main TCPDF object
$pdf = new \Com\Tecnick\Pdf\Tcpdf();

$pdf->setCreator('tc-lib-pdf');
$pdf->setAuthor('Nicola Asuni');
$pdf->setSubject('tc-lib-pdf example: 006');
$pdf->setTitle('Minimal Example');
$pdf->setKeywords('TCPDF tc-lib-pdf minimal hello world basic');
$pdf->setPDFFilename('006_minimal.pdf');

// Insert font
$bfont = $pdf->font->insert($pdf->pon, 'helvetica', '', 12);

// Add first page
$page = $pdf->addPage();

// Add font to the page
$pdf->page->addContent($bfont['out']);

// some HTML content
$html = '<h1>Hello, PDF!</h1><p>Generated with tc-lib-pdf.</p>';

// render the HTML content
$pdf->addHTMLCell(html: $html, posx: 15, posy: 15, width: 180);

// Get the PDF content
$rawpdf = $pdf->getOutPDFString();

// Render the PDF content
$pdf->renderPDF(rawpdf: $rawpdf);

Example E007 : signature basic

Sun, 26 Apr 2026 00:00:00 +0000

A PAdES B-B signature: a detached CMS signature embedded in the signed revision.

Rendered PDF: E007_signature_basic.pdf
PHP source: E007_signature_basic.phps
All examples: /examples/
Category: Digital Signatures
Guide: Digital Signatures

PDF

Source Code

<?php

declare(strict_types=1);

/**
 * E007_signature_basic.php
 *
 * @since 2026-04-21
 * @category Library
 * @package Pdf
 * @author Nicola Asuni <info@tecnick.com>
 * @copyright 2002-2026 Nicola Asuni - Tecnick.com LTD
 * @license https://www.gnu.org/copyleft/lesser.html GNU-LGPL v3 (see LICENSE)
 * @link https://github.com/tecnickcom/tc-lib-pdf
 *
 * This file is part of tc-lib-pdf software library.
 */

// NOTE: local file reads (images, fonts, attachments) are restricted to an allowlist of
// trusted paths that covers this package tree, so run the examples in place. To read assets
// from other locations, list them in the 'allowedPaths' entry of the fileOptions constructor
// parameter (see E047_remote_resources_security.php).

// NOTE: run make fonts in the project root to generate the dependencies and example fonts.

// autoloader when using Composer
require __DIR__ . '/../vendor/autoload.php';

// define fonts directory
\define('K_PATH_FONTS', \realpath(__DIR__ . '/../vendor/tecnickcom/tc-lib-pdf-font/target/fonts'));

// main TCPDF object
$pdf = new \Com\Tecnick\Pdf\Tcpdf();

$pdf->setCreator('tc-lib-pdf');
$pdf->setAuthor('Nicola Asuni');
$pdf->setSubject('tc-lib-pdf example: 007');
$pdf->setTitle('PAdES B-B Digital Signature Example');
$pdf->setKeywords('TCPDF tc-lib-pdf example signature pades pades-b-b');
$pdf->setPDFFilename('007_signature_basic.pdf');

// Insert font before adding the first page.
$bfont = $pdf->font->insert($pdf->pon, 'helvetica', '', 11);

// Add a page and a simple signed-content block.
$page = $pdf->addPage();
$pdf->page->addContent($bfont['out']);

$text = 'This document is signed with a PAdES-BASELINE-B signature (/ETSI.CAdES.detached).';
$textCell = $pdf->getTextCell(
 txt: $text,
 posx: 15,
 posy: 20,
 width: 180,
 height: 0,
 offset: 0,
 linespace: 1,
 valign: \Com\Tecnick\Pdf\TextVAlign::Top,
 halign: \Com\Tecnick\Pdf\TextHAlign::Left,
);
$pdf->page->addContent($textCell);

$text2 = 'The CMS carries the ESS signing-certificate-v2 attribute required by ETSI EN 319 142-1.';
$textCell2 = $pdf->getTextCell(
 txt: $text2,
 posx: 15,
 posy: 27,
 width: 180,
 height: 0,
 offset: 0,
 linespace: 1,
 valign: \Com\Tecnick\Pdf\TextVAlign::Top,
 halign: \Com\Tecnick\Pdf\TextHAlign::Left,
);
$pdf->page->addContent($textCell2);

$certPath = \realpath(__DIR__ . '/data/cert/tcpdf.crt');
if ($certPath === false) {
 throw new \RuntimeException('Missing signing certificate: examples/data/cert/tcpdf.crt');
}

$cert = 'file://' . $certPath;

// Preferred fluent API: $pdf->signature()->configure(...). The 'profile' option
// selects the PAdES baseline level, one of the Sign\Config::PROFILE_* constants;
// the digest is one of the Sign\DigestAlgorithm cases. The pre-facade
// $pdf->setSignature([...]) method still works and takes the same array. The signing
// process and this demo's limitations are rendered into the document itself (see the
// explanatory block added below).
$pdf->signature()->configure([
 'profile' => \Com\Tecnick\Pdf\Sign\Config::PROFILE_PADES_B_B,
 'digest_algorithm' => \Com\Tecnick\Pdf\Sign\DigestAlgorithm::Sha256->value,
 'cert_type' => 2,
 'info' => [
 'ContactInfo' => 'https://github.com/tecnickcom/tc-lib-pdf',
 'Location' => 'Demo Office',
 'Name' => 'tc-lib-pdf',
 'Reason' => 'PAdES-BASELINE-B signature example',
 ],
 'password' => '',
 'privkey' => $cert,
 'signcert' => $cert,
]);

// Visible signature field plus one extra empty approval signature field.
$pdf->signature()->appearance()->place(posx: 15, posy: 35, width: 75, height: 20, page: -1, name: 'PrimarySignature');

// Optional custom appearance stream for the signature widget (/AP /N).
// Coordinate system starts from the lower-left corner of the widget rectangle.
$sigW = 75.0;
$sigH = 20.0;
$sigTopY = $page['height'] - $sigH;

// styles controls cell fill/border; set font and text color explicitly for AP text.
$sigAppearance = $bfont['out'];
$sigAppearance .= $pdf->color->getPdfColor('rgb(15%,15%,15%)');
$sigAppearance .= $pdf->getTextCell(
 txt: 'Digitally signed by tc-lib-pdf',
 posx: 0,
 posy: $sigTopY,
 width: $sigW,
 height: $sigH,
 offset: 2.5,
 linespace: 0,
 valign: \Com\Tecnick\Pdf\TextVAlign::Center,
 halign: \Com\Tecnick\Pdf\TextHAlign::Left,
 cell: null,
 styles: [
 'all' => [
 'fillColor' => 'rgb(92%,96%,100%)',
 'lineColor' => 'rgb(20%,32%,60%)',
 'lineWidth' => 1.2,
 ],
 ],
 strokewidth: 0,
 wordspacing: 0,
 leading: 0,
 rise: 0,
 jlast: true,
 fill: true,
 stroke: false,
 underline: false,
 linethrough: false,
 overline: false,
 clip: false,
 drawcell: true,
);

$pdf->signature()->appearance()->stream(stream: $sigAppearance);

// Exposed object ID of the signature widget annotation.
// This can be useful for low-level workflows or custom QA checks.
$signatureWidgetObjId = $pdf->signature()->widgetObjectId();
$text3 = 'Primary signature widget object ID: ' . $signatureWidgetObjId;
$textCell3 = $pdf->getTextCell(
 txt: $text3,
 posx: 95,
 posy: 35,
 width: 100,
 height: 0,
 offset: 0,
 linespace: 1,
 valign: \Com\Tecnick\Pdf\TextVAlign::Top,
 halign: \Com\Tecnick\Pdf\TextHAlign::Left,
);
$pdf->page->addContent($textCell3);

// A second, empty signature field. It is a valid unsigned placeholder (no CMS is
// written to it) that a later party can sign in an approval workflow. Only the
// PrimarySignature field above carries a signature in this example's output.
$pdf->signature()->emptyField(posx: 15, posy: 60, width: 75, height: 20, page: -1, name: 'ApprovalSignature');

// Render the signing process and the demo's limitations into the document so the
// output PDF is self-documenting (this text is page content, not part of the
// signed appearance stream).
$explainHtml = <<<HTML
 <h2 style="font-size:11pt;color:#1f2a33;">How this PAdES-BASELINE-B signature is produced</h2>
 <p style="font-size:9pt;color:#1f2a33;">The library reserves a <code>/Contents</code> placeholder inside a
 <code>/SubFilter /ETSI.CAdES.detached</code> signature field, hashes the document over the two
 <code>/ByteRange</code> spans that surround the placeholder, and embeds a detached CMS (PKCS#7). The
 CAdES SignerInfo carries the mandatory content-type and message-digest attributes plus the ESS
 signing-certificate-v2 attribute required by ETSI EN 319 142-1. Per the baseline the CMS signing-time
 attribute is intentionally omitted; the claimed time is carried by the <code>/M</code> dictionary entry
 instead. The produced CMS verifies cryptographically against the <code>/ByteRange</code> bytes.</p>
 <h2 style="font-size:11pt;color:#7a1f1f;">Limitations of this demo</h2>
 <ul style="font-size:9pt;color:#1f2a33;">
 <li>B-B has no timestamp, so the <code>/M</code> signing time is a self-asserted claim and is not
 cryptographically protected. Use <code>pades-b-t</code> (example E008) for a trusted signing time
 backed by an RFC 3161 TSA.</li>
 <li>The bundled certificate <code>examples/data/cert/tcpdf.crt</code> is self-signed. The CMS is
 cryptographically valid, but the signer identity does not chain to a trusted root, so viewers report
 the signature as valid with an unknown or untrusted signer. Sign with a CA-issued certificate for a
 trusted identity verdict.</li>
 </ul>
 HTML;
$pdf->addHTMLCell(html: $explainHtml, posx: 15, posy: 85, width: 180);

$rawpdf = $pdf->getOutPDFString();
$pdf->renderPDF(rawpdf: $rawpdf);

Example E008 : signature timestamp

Sun, 26 Apr 2026 00:00:00 +0000

A PAdES B-T signature, adding an RFC 3161 timestamp obtained from a Timestamp Authority and verified before it is embedded.

Rendered PDF: E008_signature_timestamp.pdf
PHP source: E008_signature_timestamp.phps
All examples: /examples/
Category: Digital Signatures
Guide: Digital Signatures

PDF

Source Code

<?php

declare(strict_types=1);

/**
 * E008_signature_timestamp.php
 *
 * @since 2026-04-21
 * @category Library
 * @package Pdf
 * @author Nicola Asuni <info@tecnick.com>
 * @copyright 2002-2026 Nicola Asuni - Tecnick.com LTD
 * @license https://www.gnu.org/copyleft/lesser.html GNU-LGPL v3 (see LICENSE)
 * @link https://github.com/tecnickcom/tc-lib-pdf
 *
 * This file is part of tc-lib-pdf software library.
 */

// NOTE: local file reads (images, fonts, attachments) are restricted to an allowlist of
// trusted paths that covers this package tree, so run the examples in place. To read assets
// from other locations, list them in the 'allowedPaths' entry of the fileOptions constructor
// parameter (see E047_remote_resources_security.php).

// NOTE: run make fonts in the project root to generate the dependencies and example fonts.

// autoloader when using Composer
require __DIR__ . '/../vendor/autoload.php';

// define fonts directory
\define('K_PATH_FONTS', \realpath(__DIR__ . '/../vendor/tecnickcom/tc-lib-pdf-font/target/fonts'));

// main TCPDF object
// The TSA host must be listed in allowedHosts to be reachable.
$pdf = new \Com\Tecnick\Pdf\Tcpdf(fileOptions: [
 'allowedHosts' => ['freetsa.org'],
]);

$pdf->setCreator('tc-lib-pdf');
$pdf->setAuthor('Nicola Asuni');
$pdf->setSubject('tc-lib-pdf example: 008');
$pdf->setTitle('PAdES B-T Signature Timestamp Example');
$pdf->setKeywords('TCPDF tc-lib-pdf example signature timestamp tsa pades pades-b-t');
$pdf->setPDFFilename('008_signature_timestamp.pdf');

// Insert font before adding the first page.
$bfont = $pdf->font->insert($pdf->pon, 'helvetica', '', 11);

$page = $pdf->addPage();
$pdf->page->addContent($bfont['out']);

$text = 'This document is a PAdES-BASELINE-T signature: B-B plus an RFC 3161 signature timestamp.';
$textCell = $pdf->getTextCell(
 txt: $text,
 posx: 15,
 posy: 20,
 width: 180,
 height: 0,
 offset: 0,
 linespace: 1,
 valign: \Com\Tecnick\Pdf\TextVAlign::Top,
 halign: \Com\Tecnick\Pdf\TextHAlign::Left,
);
$pdf->page->addContent($textCell);

$text2 = 'Timestamping requires outbound HTTPS connectivity to the configured TSA endpoint.';
$textCell2 = $pdf->getTextCell(
 txt: $text2,
 posx: 15,
 posy: 27,
 width: 180,
 height: 0,
 offset: 0,
 linespace: 1,
 valign: \Com\Tecnick\Pdf\TextVAlign::Top,
 halign: \Com\Tecnick\Pdf\TextHAlign::Left,
);
$pdf->page->addContent($textCell2);

$certPath = \realpath(__DIR__ . '/data/cert/tcpdf.crt');
if ($certPath === false) {
 throw new \RuntimeException('Missing signing certificate: examples/data/cert/tcpdf.crt');
}

$cert = 'file://' . $certPath;

// PAdES-BASELINE-T: configure() selects the profile, timestamp() adds the TSA;
// both calls are chainable. The signing process and this demo's limitations are
// rendered into the document itself (see the explanatory block added below).
$pdf
 ->signature()
 ->configure([
 'profile' => \Com\Tecnick\Pdf\Sign\Config::PROFILE_PADES_B_T,
 'digest_algorithm' => \Com\Tecnick\Pdf\Sign\DigestAlgorithm::Sha256->value,
 'cert_type' => 2,
 'info' => [
 'ContactInfo' => 'https://github.com/tecnickcom/tc-lib-pdf',
 'Location' => 'Demo Office',
 'Name' => 'tc-lib-pdf',
 'Reason' => 'PAdES-BASELINE-T timestamped signature example',
 ],
 'password' => '',
 'privkey' => $cert,
 'signcert' => $cert,
 ])
 ->timestamp([
 'enabled' => true,
 // Public demo endpoint. For production use your trusted TSA service.
 'host' => 'https://freetsa.org/tsr',
 'username' => '',
 'password' => '',
 'cert' => '',
 'hash_algorithm' => \Com\Tecnick\Pdf\Sign\DigestAlgorithm::Sha256->value,
 'policy_oid' => '',
 'nonce_enabled' => true,
 'timeout' => 30,
 'verify_peer' => true,
 // freetsa.org names its certificate with the RFC 2634 signing-certificate (v1)
 // attribute, which is SHA-1 by definition, so the token is only accepted with
 // this opt-in. A TSA emitting ESSCertIDv2 (SHA-256) needs no such setting.
 'allow_sha1' => true,
 ]);

$pdf
 ->signature()
 ->appearance()
 ->place(posx: 15, posy: 35, width: 90, height: 20, page: -1, name: 'TimestampedSignature');

// Optional appearance stream to clearly indicate timestamped signature intent.
$sigW = 90.0;
$sigH = 20.0;
$sigTopY = $page['height'] - $sigH;

$sigAppearance = $bfont['out'];
$sigAppearance .= $pdf->color->getPdfColor('rgb(20%,20%,20%)');
$sigAppearance .= $pdf->getTextCell(
 txt: 'PAdES B-T Timestamped Signature',
 posx: 0,
 posy: $sigTopY,
 width: $sigW,
 height: $sigH,
 offset: 3.0,
 linespace: 0,
 valign: \Com\Tecnick\Pdf\TextVAlign::Center,
 halign: \Com\Tecnick\Pdf\TextHAlign::Left,
 cell: null,
 styles: [
 'all' => [
 'fillColor' => 'rgb(96%,96%,90%)',
 'lineColor' => 'rgb(35%,35%,10%)',
 'lineWidth' => 1.0,
 ],
 ],
 strokewidth: 0,
 wordspacing: 0,
 leading: 0,
 rise: 0,
 jlast: true,
 fill: true,
 stroke: false,
 underline: false,
 linethrough: false,
 overline: false,
 clip: false,
 drawcell: true,
);

$pdf->signature()->appearance()->stream(stream: $sigAppearance);

// Render the signing process and the demo's limitations into the document so the
// output PDF is self-documenting (this text is page content, not part of the
// signed appearance stream).
$explainHtml = <<<HTML
 <h2 style="font-size:11pt;color:#1f2a33;">How this PAdES-BASELINE-T signature is produced</h2>
 <p style="font-size:9pt;color:#1f2a33;">A B-T signature is a B-B signature (example E007) plus a signature
 timestamp. The library first builds the CAdES CMS, then sends the SignerInfo signature bytes to the TSA
 and embeds the returned RFC 3161 token in the CMS as the <code>id-aa-signatureTimeStampToken</code>
 unsigned attribute. The output CMS verifies over the <code>/ByteRange</code> bytes and carries a genuine
 TSA token that binds a trusted time to the signature.</p>
 <h2 style="font-size:11pt;color:#7a1f1f;">Limitations of this demo</h2>
 <ul style="font-size:9pt;color:#1f2a33;">
 <li>Timestamping performs a live RFC 3161 request to the TSA over HTTPS. The endpoint used here is the
 public freetsa.org demo service; use your own trusted TSA in production. The timestamp is mandatory
 for <code>pades-b-t</code> and above, so if the TSA is unreachable or rejects the request the signing
 step throws a signing exception and no PDF is produced.</li>
 <li>The bundled certificate is self-signed, so (as in E007) the signature is cryptographically valid
 but the signer identity is not trusted by viewers. The embedded timestamp itself is a real
 freetsa.org token and validates.</li>
 </ul>
 HTML;
$pdf->addHTMLCell(html: $explainHtml, posx: 15, posy: 65, width: 180);

$rawpdf = $pdf->getOutPDFString();
$pdf->renderPDF(rawpdf: $rawpdf);

Example E009 : signature ltv

Sun, 26 Apr 2026 00:00:00 +0000

A PAdES B-LT signature, with OCSP responses and CRLs fetched from the certificate extensions and written into the /DSS and /VRI structures.

Rendered PDF: E009_signature_ltv.pdf
PHP source: E009_signature_ltv.phps
All examples: /examples/
Category: Digital Signatures
Guide: Digital Signatures

PDF

Source Code

<?php

declare(strict_types=1);

/**
 * E009_signature_ltv.php
 *
 * @since 2026-04-21
 * @category Library
 * @package Pdf
 * @author Nicola Asuni <info@tecnick.com>
 * @copyright 2002-2026 Nicola Asuni - Tecnick.com LTD
 * @license https://www.gnu.org/copyleft/lesser.html GNU-LGPL v3 (see LICENSE)
 * @link https://github.com/tecnickcom/tc-lib-pdf
 *
 * This file is part of tc-lib-pdf software library.
 */

// NOTE: local file reads (images, fonts, attachments) are restricted to an allowlist of
// trusted paths that covers this package tree, so run the examples in place. To read assets
// from other locations, list them in the 'allowedPaths' entry of the fileOptions constructor
// parameter (see E047_remote_resources_security.php).

// NOTE: run make fonts in the project root to generate the dependencies and example fonts.

// autoloader when using Composer
require __DIR__ . '/../vendor/autoload.php';

// define fonts directory
\define('K_PATH_FONTS', \realpath(__DIR__ . '/../vendor/tecnickcom/tc-lib-pdf-font/target/fonts'));

// main TCPDF object
// The TSA host must be listed in allowedHosts to be reachable.
$pdf = new \Com\Tecnick\Pdf\Tcpdf(fileOptions: [
 'allowedHosts' => ['freetsa.org'],
]);

$pdf->setCreator('tc-lib-pdf');
$pdf->setAuthor('Nicola Asuni');
$pdf->setSubject('tc-lib-pdf example: 009');
$pdf->setTitle('PAdES B-LT Long-Term Validation Signature Example');
$pdf->setKeywords('TCPDF tc-lib-pdf example signature ltv dss vri pades pades-b-lt');
$pdf->setPDFFilename('009_signature_ltv.pdf');

// Insert font before adding the first page.
$bfont = $pdf->font->insert($pdf->pon, 'helvetica', '', 11);

$page = $pdf->addPage();
$pdf->page->addContent($bfont['out']);

$text = 'This document is a PAdES-BASELINE-LT signature: B-T plus a Document Security Store (DSS).';
$textCell = $pdf->getTextCell(
 txt: $text,
 posx: 15,
 posy: 20,
 width: 180,
 height: 0,
 offset: 0,
 linespace: 1,
 valign: \Com\Tecnick\Pdf\TextVAlign::Top,
 halign: \Com\Tecnick\Pdf\TextHAlign::Left,
);
$pdf->page->addContent($textCell);

$text2 =
 'The DSS/VRI embed the certificate and, when its CA exposes reachable OCSP/CRL responders, '
 . 'the revocation data needed to verify offline long after expiry.';
$textCell2 = $pdf->getTextCell(
 txt: $text2,
 posx: 15,
 posy: 27,
 width: 180,
 height: 0,
 offset: 0,
 linespace: 1,
 valign: \Com\Tecnick\Pdf\TextVAlign::Top,
 halign: \Com\Tecnick\Pdf\TextHAlign::Left,
);
$pdf->page->addContent($textCell2);

$certPath = \realpath(__DIR__ . '/data/cert/tcpdf.crt');
if ($certPath === false) {
 throw new \RuntimeException('Missing signing certificate: examples/data/cert/tcpdf.crt');
}

$cert = 'file://' . $certPath;

// PAdES-BASELINE-LT: a B-T signature (so a TSA timestamp is required) plus the
// LTV material (DSS/VRI). The signing process and this demo's limitations are
// rendered into the document itself (see the explanatory block added below).
$pdf
 ->signature()
 ->configure([
 'profile' => \Com\Tecnick\Pdf\Sign\Config::PROFILE_PADES_B_LT,
 'digest_algorithm' => \Com\Tecnick\Pdf\Sign\DigestAlgorithm::Sha256->value,
 'cert_type' => 2,
 'info' => [
 'ContactInfo' => 'https://github.com/tecnickcom/tc-lib-pdf',
 'Location' => 'Demo Office',
 'Name' => 'tc-lib-pdf',
 'Reason' => 'PAdES-BASELINE-LT (DSS/VRI) signature example',
 ],
 'password' => '',
 'privkey' => $cert,
 'signcert' => $cert,
 'ltv' => [
 'enabled' => true,
 'embed_ocsp' => true,
 'embed_crl' => true,
 'embed_certs' => true,
 'include_dss' => true,
 'include_vri' => true,
 ],
 ])
 ->timestamp([
 'enabled' => true,
 // Public demo endpoint. For production use your trusted TSA service.
 'host' => 'https://freetsa.org/tsr',
 'username' => '',
 'password' => '',
 'cert' => '',
 'hash_algorithm' => \Com\Tecnick\Pdf\Sign\DigestAlgorithm::Sha256->value,
 'policy_oid' => '',
 'nonce_enabled' => true,
 'timeout' => 30,
 'verify_peer' => true,
 // freetsa.org names its certificate with the RFC 2634 signing-certificate (v1)
 // attribute, which is SHA-1 by definition, so the token is only accepted with
 // this opt-in. A TSA emitting ESSCertIDv2 (SHA-256) needs no such setting.
 'allow_sha1' => true,
 ]);

$pdf->signature()->appearance()->place(posx: 15, posy: 40, width: 90, height: 20, page: -1, name: 'LTVSignature');

// Attach a reusable Form XObject as signature appearance using the official API.
// Any imported page can be used as a visual signature stamp.
$stampSource = __DIR__ . '/data/pdf/E006_example_minimal.pdf';
if (\is_readable($stampSource)) {
 $sourceId = $pdf->setImportSourceFile($stampSource);
 $tpl = $pdf->importPage(sourceId: $sourceId, pageNum: 1);
 $pdf->signature()->appearance()->xobject($tpl->getXobjId());
} else {
 // Fallback appearance stream when the optional stamp source is unavailable.
 $sigW = 90.0;
 $sigH = 20.0;
 $sigTopY = $page['height'] - $sigH;

 $sigAppearance = $bfont['out'];
 $sigAppearance .= $pdf->color->getPdfColor('rgb(15%,15%,15%)');
 $sigAppearance .= $pdf->getTextCell(
 txt: 'PAdES B-LT signature (DSS/VRI)',
 posx: 0,
 posy: $sigTopY,
 width: $sigW,
 height: $sigH,
 offset: 3.0,
 linespace: 0,
 valign: \Com\Tecnick\Pdf\TextVAlign::Center,
 halign: \Com\Tecnick\Pdf\TextHAlign::Left,
 cell: null,
 styles: [
 'all' => [
 'fillColor' => 'rgb(94%,97%,92%)',
 'lineColor' => 'rgb(20%,40%,20%)',
 'lineWidth' => 1.0,
 ],
 ],
 strokewidth: 0,
 wordspacing: 0,
 leading: 0,
 rise: 0,
 jlast: true,
 fill: true,
 stroke: false,
 underline: false,
 linethrough: false,
 overline: false,
 clip: false,
 drawcell: true,
 );
 $pdf->signature()->appearance()->stream(stream: $sigAppearance);
}

$widgetObjId = $pdf->signature()->widgetObjectId();
$text3 = 'LTV signature widget object ID: ' . $widgetObjId;
$textCell3 = $pdf->getTextCell(
 txt: $text3,
 posx: 15,
 posy: 63,
 width: 180,
 height: 0,
 offset: 0,
 linespace: 1,
 valign: \Com\Tecnick\Pdf\TextVAlign::Top,
 halign: \Com\Tecnick\Pdf\TextHAlign::Left,
);
$pdf->page->addContent($textCell3);

// Render the signing process and the demo's limitations into the document so the
// output PDF is self-documenting (this text is page content, not part of the
// signed appearance stream).
$explainHtml = <<<HTML
 <h2 style="font-size:11pt;color:#1f2a33;">How this PAdES-BASELINE-LT signature is produced</h2>
 <p style="font-size:9pt;color:#1f2a33;">A B-LT signature is a B-T signature (a TSA timestamp is required)
 plus long-term validation material. The signing process writes two incremental revisions: first the
 CAdES signature with its embedded RFC 3161 signature timestamp (B-T), then a Document Security Store
 (<code>/DSS</code> with a <code>/VRI</code> map keyed by the uppercase SHA-1 of the final signature
 <code>/Contents</code>) carrying the validation material. OCSP/CRL retrieval follows the certificate's
 AIA and CRL-DP extensions so a validator can check the chain offline long after the certificate
 expires.</p>
 <h2 style="font-size:11pt;color:#7a1f1f;">Limitations of this demo</h2>
 <ul style="font-size:9pt;color:#1f2a33;">
 <li>A reachable TSA is required (live HTTPS request); if it is unreachable or rejects the request the
 signing step throws a signing exception and no PDF is produced.</li>
 <li>The bundled self-signed demo certificate exposes neither an OCSP responder nor a CRL distribution
 point, so the DSS embeds only the certificate bytes (no revocation data) and a validator reports B-T
 with a DSS present rather than a full B-LT. Missing responders are tolerated and do not abort signing.
 Sign with a CA-issued certificate whose OCSP/CRL responders are reachable at signing time to obtain a
 full B-LT verdict.</li>
 </ul>
 HTML;
$pdf->addHTMLCell(html: $explainHtml, posx: 15, posy: 73, width: 180);

$rawpdf = $pdf->getOutPDFString();
$pdf->renderPDF(rawpdf: $rawpdf);

Example E010 : pdfx

Sun, 26 Apr 2026 00:00:00 +0000

The PDF/X conformance mode and what selecting it changes in the emitted document.

Rendered PDF: E010_pdfx.pdf
PHP source: E010_pdfx.phps
All examples: /examples/
Category: Standards and Conformance
Guide: Standards and Conformance

PDF

Source Code

<?php

declare(strict_types=1);

/**
 * E010_pdfx.php
 *
 * @since 2026-04-25
 * @category Library
 * @package Pdf
 * @author Nicola Asuni <info@tecnick.com>
 * @copyright 2002-2026 Nicola Asuni - Tecnick.com LTD
 * @license https://www.gnu.org/copyleft/lesser.html GNU-LGPL v3 (see LICENSE)
 * @link https://github.com/tecnickcom/tc-lib-pdf
 *
 * This file is part of tc-lib-pdf software library.
 */

// NOTE: local file reads (images, fonts, attachments) are restricted to an allowlist of
// trusted paths that covers this package tree, so run the examples in place. To read assets
// from other locations, list them in the 'allowedPaths' entry of the fileOptions constructor
// parameter (see E047_remote_resources_security.php).

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

\define('K_PATH_FONTS', \realpath(__DIR__ . '/../vendor/tecnickcom/tc-lib-pdf-font/target/fonts'));

$pdf = new \Com\Tecnick\Pdf\Tcpdf(
 unit: \Com\Tecnick\Pdf\Page\Unit::Millimeter,
 isunicode: true,
 subsetfont: false,
 compress: true,
 mode: \Com\Tecnick\Pdf\PdfConformance::Pdfx,
);

$pdf->setCreator('tc-lib-pdf');
$pdf->setAuthor('Nicola Asuni');
$pdf->setSubject('tc-lib-pdf example: 010');
$pdf->setTitle('PDF/X Example');
$pdf->setKeywords('TCPDF tc-lib-pdf example pdfx');
$pdf->setPDFFilename('010_pdfx.pdf');

$font = $pdf->font->insert($pdf->pon, 'helvetica', '', 12);
$page = $pdf->addPage();
$pdf->page->addContent($font['out']);

$html =
 '<h1>PDF/X</h1>'
 . '<p>Mode: pdfx</p>'
 . '<p>This generic alias currently maps to the library\'s baseline PDF/X print workflow.</p>'
 . '<p>Highlights: PDF/X identification metadata, print-oriented output intent handling, '
 . 'CMYK-oriented process colors, and suppression of interactive actions that are not allowed '
 . 'in a print-exchange profile.</p>';

$pdf->addHTMLCell(html: $html, posx: 15, posy: 20, width: 180);

$rawpdf = $pdf->getOutPDFString();
$pdf->renderPDF(rawpdf: $rawpdf);

Example E011 : pdfx1a

Sun, 26 Apr 2026 00:00:00 +0000

PDF/X-1a output, where colour is forced to CMYK and live transparency is not allowed.

Rendered PDF: E011_pdfx1a.pdf
PHP source: E011_pdfx1a.phps
All examples: /examples/
Category: Standards and Conformance
Guide: Standards and Conformance

PDF

Source Code

<?php

declare(strict_types=1);

/**
 * E011_pdfx1a.php
 *
 * PDF/X-1a conformance example with CMYK/spot print restrictions.
 *
 * @since 2026-04-25
 * @category Library
 * @package Pdf
 * @author Nicola Asuni <info@tecnick.com>
 * @copyright 2002-2026 Nicola Asuni - Tecnick.com LTD
 * @license https://www.gnu.org/copyleft/lesser.html GNU-LGPL v3 (see LICENSE)
 * @link https://github.com/tecnickcom/tc-lib-pdf
 *
 * This file is part of tc-lib-pdf software library.
 */

// NOTE: local file reads (images, fonts, attachments) are restricted to an allowlist of
// trusted paths that covers this package tree, so run the examples in place. To read assets
// from other locations, list them in the 'allowedPaths' entry of the fileOptions constructor
// parameter (see E047_remote_resources_security.php).

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

\define('K_PATH_FONTS', \realpath(__DIR__ . '/../vendor/tecnickcom/tc-lib-pdf-font/target/fonts'));

$pdf = new \Com\Tecnick\Pdf\Tcpdf(
 unit: \Com\Tecnick\Pdf\Page\Unit::Millimeter,
 isunicode: true,
 subsetfont: false,
 compress: true,
 mode: \Com\Tecnick\Pdf\PdfConformance::Pdfx1a,
);

$pdf->setCreator('tc-lib-pdf');
$pdf->setAuthor('Nicola Asuni');
$pdf->setSubject('tc-lib-pdf example: 011');
$pdf->setTitle('PDF/X-1a Example');
$pdf->setKeywords('TCPDF tc-lib-pdf example pdfx1a');
$pdf->setPDFFilename('011_pdfx1a.pdf');

$font = $pdf->font->insert($pdf->pon, 'helvetica', '', 12);
$pdf->addPage();
$pdf->page->addContent($font['out']);

$html =
 '<h1>PDF/X-1a</h1>'
 . '<p>Mode: pdfx1a</p>'
 . '<p>PDF/X-1a targets an older, press-safe workflow centered on CMYK and spot colors.</p>'
 . '<p>Highlights: minimum PDF 1.3 output, transparency disabled, encryption disabled, '
 . 'and interactive annotations/actions suppressed for a classic print handoff.</p>';

$pdf->addHTMLCell(html: $html, posx: 15, posy: 20, width: 180);

$rawpdf = $pdf->getOutPDFString();
$pdf->renderPDF(rawpdf: $rawpdf);

Example E012 : pdfx3

Sun, 26 Apr 2026 00:00:00 +0000

PDF/X-3 output, which allows device-independent colour alongside an output intent.

Rendered PDF: E012_pdfx3.pdf
PHP source: E012_pdfx3.phps
All examples: /examples/
Category: Standards and Conformance
Guide: Standards and Conformance

PDF

Source Code

<?php

declare(strict_types=1);

/**
 * E012_pdfx3.php
 *
 * PDF/X-3 conformance example for color-managed print workflows.
 *
 * @since 2026-04-25
 * @category Library
 * @package Pdf
 * @author Nicola Asuni <info@tecnick.com>
 * @copyright 2002-2026 Nicola Asuni - Tecnick.com LTD
 * @license https://www.gnu.org/copyleft/lesser.html GNU-LGPL v3 (see LICENSE)
 * @link https://github.com/tecnickcom/tc-lib-pdf
 *
 * This file is part of tc-lib-pdf software library.
 */

// NOTE: local file reads (images, fonts, attachments) are restricted to an allowlist of
// trusted paths that covers this package tree, so run the examples in place. To read assets
// from other locations, list them in the 'allowedPaths' entry of the fileOptions constructor
// parameter (see E047_remote_resources_security.php).

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

\define('K_PATH_FONTS', \realpath(__DIR__ . '/../vendor/tecnickcom/tc-lib-pdf-font/target/fonts'));

$pdf = new \Com\Tecnick\Pdf\Tcpdf(
 unit: \Com\Tecnick\Pdf\Page\Unit::Millimeter,
 isunicode: true,
 subsetfont: false,
 compress: true,
 mode: \Com\Tecnick\Pdf\PdfConformance::Pdfx3,
);

$pdf->setCreator('tc-lib-pdf');
$pdf->setAuthor('Nicola Asuni');
$pdf->setSubject('tc-lib-pdf example: 012');
$pdf->setTitle('PDF/X-3 Example');
$pdf->setKeywords('TCPDF tc-lib-pdf example pdfx3');
$pdf->setPDFFilename('012_pdfx3.pdf');

$font = $pdf->font->insert($pdf->pon, 'helvetica', '', 12);
$pdf->addPage();
$pdf->page->addContent($font['out']);

$html =
 '<h1>PDF/X-3</h1>'
 . '<p>Mode: pdfx3</p>'
 . '<p>PDF/X-3 keeps the print-exchange restrictions of early PDF/X while allowing '
 . 'color-managed workflows beyond device CMYK.</p>'
 . '<p>Highlights: minimum PDF 1.3 output, output-intent identification, no transparency, '
 . 'and no interactive actions that would conflict with print-only delivery.</p>';

$pdf->addHTMLCell(html: $html, posx: 15, posy: 20, width: 180);

$rawpdf = $pdf->getOutPDFString();
$pdf->renderPDF(rawpdf: $rawpdf);

Example E013 : pdfx4

Sun, 26 Apr 2026 00:00:00 +0000

PDF/X-4 output, which allows live transparency and optional content groups.

Rendered PDF: E013_pdfx4.pdf
PHP source: E013_pdfx4.phps
All examples: /examples/
Category: Standards and Conformance
Guide: Standards and Conformance

PDF

Source Code

<?php

declare(strict_types=1);

/**
 * E013_pdfx4.php
 *
 * PDF/X-4 conformance example with transparency-capable print output.
 *
 * Also shows the colour space the SVG paints are emitted in: ISO 15930-7 admits
 * a device colour space only when the output intent defines the same space, so
 * the operators follow the printing condition passed to setOutputIntent().
 *
 * @since 2026-04-25
 * @category Library
 * @package Pdf
 * @author Nicola Asuni <info@tecnick.com>
 * @copyright 2002-2026 Nicola Asuni - Tecnick.com LTD
 * @license https://www.gnu.org/copyleft/lesser.html GNU-LGPL v3 (see LICENSE)
 * @link https://github.com/tecnickcom/tc-lib-pdf
 *
 * This file is part of tc-lib-pdf software library.
 */

// NOTE: local file reads (images, fonts, attachments) are restricted to an allowlist of
// trusted paths that covers this package tree, so run the examples in place. To read assets
// from other locations, list them in the 'allowedPaths' entry of the fileOptions constructor
// parameter (see E047_remote_resources_security.php).

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

\define('K_PATH_FONTS', \realpath(__DIR__ . '/../vendor/tecnickcom/tc-lib-pdf-font/target/fonts'));

$pdf = new \Com\Tecnick\Pdf\Tcpdf(
 unit: \Com\Tecnick\Pdf\Page\Unit::Millimeter,
 isunicode: true,
 subsetfont: false,
 compress: true,
 mode: \Com\Tecnick\Pdf\PdfConformance::Pdfx4,
);

$pdf->setCreator('tc-lib-pdf');
$pdf->setAuthor('Nicola Asuni');
$pdf->setSubject('tc-lib-pdf example: 013');
$pdf->setTitle('PDF/X-4 Example');
$pdf->setKeywords('TCPDF tc-lib-pdf example pdfx4');
$pdf->setPDFFilename('013_pdfx4.pdf');

// ISO 15930-7 and ISO 15930-8 require the destination profile to be embedded.
// A real print job supplies its own condition (for example 'FOGRA39' with the
// matching CMYK profile); the bundled sRGB profile keeps this example self-contained.
$pdf->setSRGB(true);
$pdf->setOutputIntent(identifier: 'sRGB IEC61966-2.1', info: 'sRGB IEC61966-2.1', condition: 'sRGB display condition');

$font = $pdf->font->insert($pdf->pon, 'helvetica', '', 12);
$pdf->addPage();
$pdf->page->addContent($font['out']);

$html =
 '<h1>PDF/X-4</h1>'
 . '<p>Mode: pdfx4</p>'
 . '<p>PDF/X-4 modernizes print exchange by allowing live transparency in a color-managed workflow.</p>'
 . '<p>Highlights: minimum PDF 1.6 output, PDF/X-4 identification metadata, transparency retained, '
 . 'encryption disabled, and interactive actions still suppressed for print conformance.</p>';

$pdf->addHTMLCell(html: $html, posx: 15, posy: 20, width: 180);

// The output intent above is the 3-component sRGB profile, an RGB printing
// condition, so the DeviceRGB paints of this SVG are conformant and emitted as
// 'rg' operators. Passing a 4-component profile to setOutputIntent() instead
// makes the same SVG emit DeviceCMYK, and the explicit cmyk() paint is emitted
// as 'k' either way.
$svg =
 '@<svg xmlns="http://www.w3.org/2000/svg" width="100" height="40" viewBox="0 0 100 40">'
 . '<rect x="0" y="0" width="30" height="40" fill="cmyk(0%,0%,0%,100%)"/>'
 . '<rect x="35" y="0" width="30" height="40" fill="#d6457b"/>'
 . '<path d="M 70 0 H 100 V 40 H 70 Z"/>'
 . '</svg>';

$page = $pdf->page->getPage();
$soid = $pdf->addSVG(img: $svg, posx: 15, posy: 70, width: 90, height: 36, pageheight: $page['height']);
$pdf->page->addContent($pdf->getSetSVG(soid: $soid));

$rawpdf = $pdf->getOutPDFString();
$pdf->renderPDF(rawpdf: $rawpdf);

Example E014 : pdfx5

Sun, 26 Apr 2026 00:00:00 +0000

PDF/X-5 output, with references to external graphical content.

Rendered PDF: E014_pdfx5.pdf
PHP source: E014_pdfx5.phps
All examples: /examples/
Category: Standards and Conformance
Guide: Standards and Conformance

PDF

Source Code

<?php

declare(strict_types=1);

/**
 * E014_pdfx5.php
 *
 * PDF/X-5 conformance example.
 *
 * @since 2026-04-25
 * @category Library
 * @package Pdf
 * @author Nicola Asuni <info@tecnick.com>
 * @copyright 2002-2026 Nicola Asuni - Tecnick.com LTD
 * @license https://www.gnu.org/copyleft/lesser.html GNU-LGPL v3 (see LICENSE)
 * @link https://github.com/tecnickcom/tc-lib-pdf
 *
 * This file is part of tc-lib-pdf software library.
 */

// NOTE: local file reads (images, fonts, attachments) are restricted to an allowlist of
// trusted paths that covers this package tree, so run the examples in place. To read assets
// from other locations, list them in the 'allowedPaths' entry of the fileOptions constructor
// parameter (see E047_remote_resources_security.php).

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

\define('K_PATH_FONTS', \realpath(__DIR__ . '/../vendor/tecnickcom/tc-lib-pdf-font/target/fonts'));

$pdf = new \Com\Tecnick\Pdf\Tcpdf(
 unit: \Com\Tecnick\Pdf\Page\Unit::Millimeter,
 isunicode: true,
 subsetfont: false,
 compress: true,
 mode: \Com\Tecnick\Pdf\PdfConformance::Pdfx5,
);

$pdf->setCreator('tc-lib-pdf');
$pdf->setAuthor('Nicola Asuni');
$pdf->setSubject('tc-lib-pdf example: 014');
$pdf->setTitle('PDF/X-5 Example');
$pdf->setKeywords('TCPDF tc-lib-pdf example pdfx5');
$pdf->setPDFFilename('014_pdfx5.pdf');

// ISO 15930-7 and ISO 15930-8 require the destination profile to be embedded.
// A real print job supplies its own condition (for example 'FOGRA39' with the
// matching CMYK profile); the bundled sRGB profile keeps this example self-contained.
$pdf->setSRGB(true);
$pdf->setOutputIntent(identifier: 'sRGB IEC61966-2.1', info: 'sRGB IEC61966-2.1', condition: 'sRGB display condition');

$font = $pdf->font->insert($pdf->pon, 'helvetica', '', 12);
$pdf->addPage();
$pdf->page->addContent($font['out']);

$html =
 '<h1>PDF/X-5</h1>'
 . '<p>Mode: pdfx5</p>'
 . '<p>PDF/X-5 builds on the PDF/X-4 family for more advanced print workflows and external references.</p>'
 . '<p>Highlights: minimum PDF 1.6 output, transparency retained, modern PDF/X identification, '
 . 'and the same print-safe suppression of unsupported interactive actions.</p>';

$pdf->addHTMLCell(html: $html, posx: 15, posy: 20, width: 180);

$rawpdf = $pdf->getOutPDFString();
$pdf->renderPDF(rawpdf: $rawpdf);

Example E015 : pdfua

Sun, 26 Apr 2026 00:00:00 +0000

PDF/UA output tagged automatically from the HTML source, with the structure tree and parent tree generated for you.

Rendered PDF: E015_pdfua.pdf
PHP source: E015_pdfua.phps
All examples: /examples/
Category: Standards and Conformance
Guide: Standards and Conformance

PDF

Source Code

<?php

declare(strict_types=1);

/**
 * E015_pdfua.php
 *
 * Demonstrates HTML auto-tagging in 'pdfua' (generic alias) mode.
 *
 * Every HTML element rendered by addHTMLCell() is automatically mapped to the
 * corresponding PDF structure role - no beginStructElem() calls required.
 * Compare with E063 which builds the same structure tree manually via the
 * lower-level addTextCell() / beginStructElem() API.
 *
 * Auto-tagged roles exercised here:
 * h1-h3 → H1-H3 (heading hierarchy)
 * p → P (paragraph)
 * blockquote → BlockQuote
 * pre → Code
 * ul / ol → L (list; li → LI > Lbl + LBody auto-generated)
 * figure → Figure
 * img[alt] → Figure + /Alt (alt text written to struct-elem dictionary)
 * figcaption → Caption
 * table → Table (tr → TR, th → TH, td → TD, caption → Caption)
 * a → Link
 *
 * @since 2026-04-25
 * @category Library
 * @package Pdf
 * @author Nicola Asuni <info@tecnick.com>
 * @copyright 2002-2026 Nicola Asuni - Tecnick.com LTD
 * @license https://www.gnu.org/copyleft/lesser.html GNU-LGPL v3 (see LICENSE)
 * @link https://github.com/tecnickcom/tc-lib-pdf
 *
 * This file is part of tc-lib-pdf software library.
 */

// NOTE: local file reads (images, fonts, attachments) are restricted to an allowlist of
// trusted paths that covers this package tree, so run the examples in place. To read assets
// from other locations, list them in the 'allowedPaths' entry of the fileOptions constructor
// parameter (see E047_remote_resources_security.php).

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

\define('K_PATH_FONTS', \realpath(__DIR__ . '/../vendor/tecnickcom/tc-lib-pdf-font/target/fonts'));

$pdf = new \Com\Tecnick\Pdf\Tcpdf(
 unit: \Com\Tecnick\Pdf\Page\Unit::Millimeter,
 isunicode: true,
 subsetfont: false,
 compress: true,
 mode: \Com\Tecnick\Pdf\PdfConformance::Pdfua,
);
$pdf->setCreator('tc-lib-pdf');
$pdf->setAuthor('Nicola Asuni');
$pdf->setTitle('PDF/UA Auto-Tagged HTML');
$pdf->setSubject('tc-lib-pdf example: 015 — pdfua mode HTML tagging showcase');
$pdf->setKeywords('TCPDF tc-lib-pdf pdfua tagged PDF accessibility HTML auto-tag structure');
$pdf->setPDFFilename('E015_pdfua.pdf');
$pdf->setLanguage(code: 'en-US');

$font = $pdf->font->insert($pdf->pon, 'dejavusans', '', 10);

// PDF/UA requires every font to be embedded. <code>/<pre> default to the
// non-embedded standard-14 Courier, so register an embedded monospace font and
// select it for those elements.
$pdf->font->insert($pdf->pon, 'dejavusansmono', '', 10);
$pdf->setHTMLMonospaceFont('dejavusansmono');

$pdf->addPage();
$pdf->page->addContent($font['out']);

$imgPath = __DIR__ . '/images/tcpdf_logo.jpg';

$html =
 '<h1>PDF/UA — Auto-Tagged HTML Showcase</h1>'
 . '<p>Mode: <strong>pdfua</strong> (generic alias). This document demonstrates every HTML'
 . ' element that <code>addHTMLCell()</code> auto-tags with a PDF structure role.'
 . ' No <code>beginStructElem()</code> calls are required: the library maps each HTML tag'
 . ' to its PDF role automatically when a PDF/UA mode is active. The generic'
 . ' <em>pdfua</em> alias behaves identically to <em>pdfua1</em> for structure-tree'
 . ' output and defaults to PDF 1.7.</p>'
 . '<h2>1 — Heading and Paragraph Roles</h2>'
 . '<h3>H3 Sub-heading</h3>'
 . '<p>The <code>h1</code>-<code>h6</code> tags map to PDF roles <strong>H1-H6</strong>.'
 . ' The <code>p</code> tag maps to <strong>P</strong>.'
 . ' Heading levels are clamped to prevent skipped levels in the structure tree,'
 . ' satisfying the PDF/UA requirement that no heading level may be skipped.</p>'
 . '<h2>2 — Block Roles</h2>'
 . '<blockquote>&ldquo;Tagged PDF is the foundation of accessible PDF. Without a'
 . ' well-formed structure tree, automated tools and assistive technologies cannot'
 . ' reliably interpret document content.&rdquo; &mdash; ISO&#160;14289-1 rationale</blockquote>'
 . '<p>The <code>blockquote</code> tag maps to <strong>BlockQuote</strong>.</p>'
 . '<h2>3 — List Structure (L &gt; LI &gt; Lbl + LBody)</h2>'
 . '<p>Both <code>ul</code> and <code>ol</code> map to the <strong>L</strong> role.'
 . ' Each <code>li</code> auto-generates <strong>LI &gt; {Lbl, LBody}</strong> children:</p>'
 . '<ul>'
 . '<li>Unordered item &mdash; <code>ul</code>/<code>li</code> tags produce L/LI structure</li>'
 . '<li>The bullet character is placed in a <strong>Lbl</strong> child element</li>'
 . '<li>Body text is wrapped in a <strong>LBody</strong> child element</li>'
 . '</ul>'
 . '<ol>'
 . '<li>Ordered item &mdash; the number is auto-generated as the <strong>Lbl</strong></li>'
 . '<li>Body text is again auto-wrapped in <strong>LBody</strong></li>'
 . '<li>Nesting: L &gt; LI &gt; {Lbl, LBody}</li>'
 . '</ol>'
 . '<h2>4 — Figure, Image Alt-Text, and Caption</h2>'
 . '<figure>'
 . '<img src="'
 . $imgPath
 . '" alt="TCPDF logo: blue text on white background" width="89" height="30" />'
 . '<figcaption>Figure 1 &mdash; TCPDF logo. The <code>alt</code> attribute is written as'
 . ' <strong>/Alt</strong> in the Figure structure-element dictionary so screen readers'
 . ' can describe the image. The <code>figcaption</code> tag maps to'
 . ' <strong>Caption</strong>.</figcaption>'
 . '</figure>'
 . '<h2>5 — Table Structure (Table &gt; TR &gt; TH/TD)</h2>'
 . '<table border="1" cellspacing="0" cellpadding="3">'
 . '<caption>Table 1 &mdash; HTML tags and their PDF/UA structure roles (auto-tagged by addHTMLCell)</caption>'
 . '<tr><th>HTML tag</th><th>PDF structure role</th><th>Category</th></tr>'
 . '<tr><td>h1&ndash;h6</td><td>H1&ndash;H6</td><td>Heading</td></tr>'
 . '<tr><td>p</td><td>P</td><td>Body</td></tr>'
 . '<tr><td>blockquote</td><td>BlockQuote</td><td>Body</td></tr>'
 . '<tr><td>pre</td><td>Code</td><td>Body</td></tr>'
 . '<tr><td>ul, ol</td><td>L</td><td>List</td></tr>'
 . '<tr><td>li</td><td>LI + Lbl + LBody</td><td>List</td></tr>'
 . '<tr><td>figure</td><td>Figure</td><td>Illustration</td></tr>'
 . '<tr><td>img (with alt)</td><td>Figure + /Alt</td><td>Illustration</td></tr>'
 . '<tr><td>figcaption, caption</td><td>Caption</td><td>Illustration</td></tr>'
 . '<tr><td>table</td><td>Table</td><td>Table</td></tr>'
 . '<tr><td>tr</td><td>TR</td><td>Table</td></tr>'
 . '<tr><td>td</td><td>TD</td><td>Table</td></tr>'
 . '<tr><td>th</td><td>TH</td><td>Table</td></tr>'
 . '<tr><td>a</td><td>Link</td><td>Inline</td></tr>'
 . '</table>'
 . '<h2>6 — Hyperlink (Link Role)</h2>'
 . '<p>This sentence contains a'
 . ' <a href="https://github.com/tecnickcom/tc-lib-pdf" style="text-decoration:none;">hyperlink to the tc-lib-pdf repository</a>;'
 . ' the <code>a</code> element is tagged with the <strong>Link</strong> structure role'
 . ' automatically. The link text is accessible to screen readers via the structure tree.</p>';

$pdf->addHTMLCell(html: $html, posx: 15, posy: 20, width: 180);

$rawpdf = $pdf->getOutPDFString();
$pdf->renderPDF(rawpdf: $rawpdf);

Example E016 : pdfua1

Sun, 26 Apr 2026 00:00:00 +0000

PDF/UA-1 output (ISO 14289-1) tagged automatically from HTML.

Rendered PDF: E016_pdfua1.pdf
PHP source: E016_pdfua1.phps
All examples: /examples/
Category: Standards and Conformance
Guide: Standards and Conformance

PDF

Source Code

<?php

declare(strict_types=1);

/**
 * E016_pdfua1.php
 *
 * Demonstrates HTML auto-tagging in 'pdfua1' (PDF/UA-1, ISO 14289-1) mode.
 *
 * PDF/UA-1 is the original accessible-PDF profile, standardised as ISO 14289-1:2012
 * and built on PDF 1.7. When this mode is active, tc-lib-pdf:
 * - Writes StructTreeRoot, ParentTree, and MarkInfo /Marked true
 * - Forces ViewerPreferences /DisplayDocTitle true
 * - Sets /Lang from the document language (default en-US)
 * - Clamps heading levels to prevent skipped H1-H6 levels
 * - Emits ActualText for ligatures and special glyphs
 *
 * Every HTML element rendered by addHTMLCell() is automatically mapped to the
 * corresponding PDF structure role - no beginStructElem() calls required.
 * Compare with E063 which builds the same structure tree manually.
 *
 * Auto-tagged roles exercised here:
 * h1-h3 → H1-H3 (heading hierarchy)
 * p → P (paragraph)
 * blockquote → BlockQuote
 * pre → Code
 * ul / ol → L (list; li → LI > Lbl + LBody auto-generated)
 * figure → Figure
 * img[alt] → Figure + /Alt (alt text written to struct-elem dictionary)
 * figcaption → Caption
 * table → Table (tr → TR, th → TH, td → TD, caption → Caption)
 * a → Link
 *
 * @since 2026-04-25
 * @category Library
 * @package Pdf
 * @author Nicola Asuni <info@tecnick.com>
 * @copyright 2002-2026 Nicola Asuni - Tecnick.com LTD
 * @license https://www.gnu.org/copyleft/lesser.html GNU-LGPL v3 (see LICENSE)
 * @link https://github.com/tecnickcom/tc-lib-pdf
 *
 * This file is part of tc-lib-pdf software library.
 */

// NOTE: local file reads (images, fonts, attachments) are restricted to an allowlist of
// trusted paths that covers this package tree, so run the examples in place. To read assets
// from other locations, list them in the 'allowedPaths' entry of the fileOptions constructor
// parameter (see E047_remote_resources_security.php).

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

\define('K_PATH_FONTS', \realpath(__DIR__ . '/../vendor/tecnickcom/tc-lib-pdf-font/target/fonts'));

$pdf = new \Com\Tecnick\Pdf\Tcpdf(
 unit: \Com\Tecnick\Pdf\Page\Unit::Millimeter,
 isunicode: true,
 subsetfont: false,
 compress: true,
 mode: \Com\Tecnick\Pdf\PdfConformance::Pdfua1,
);
$pdf->setCreator('tc-lib-pdf');
$pdf->setAuthor('Nicola Asuni');
$pdf->setTitle('PDF/UA-1 Auto-Tagged HTML');
$pdf->setSubject('tc-lib-pdf example: 016 — pdfua1 mode HTML tagging showcase');
$pdf->setKeywords('TCPDF tc-lib-pdf pdfua1 PDF/UA-1 ISO14289 tagged PDF accessibility HTML auto-tag');
$pdf->setPDFFilename('E016_pdfua1.pdf');
$pdf->setLanguage(code: 'en-US');

$font = $pdf->font->insert($pdf->pon, 'dejavusans', '', 10);

// PDF/UA requires every font to be embedded. <code>/<pre> default to the
// non-embedded standard-14 Courier, so register an embedded monospace font and
// select it for those elements.
$pdf->font->insert($pdf->pon, 'dejavusansmono', '', 10);
$pdf->setHTMLMonospaceFont('dejavusansmono');

$pdf->addPage();
$pdf->page->addContent($font['out']);

$imgPath = __DIR__ . '/images/tcpdf_logo.jpg';

$html =
 '<h1>PDF/UA-1 — Auto-Tagged HTML Showcase</h1>'
 . '<p>Mode: <strong>pdfua1</strong> (ISO&#160;14289-1, PDF&#160;1.7). This document'
 . ' demonstrates every HTML element that <code>addHTMLCell()</code> auto-tags with a'
 . ' PDF/UA-1 structure role. PDF/UA-1 is the original accessible-PDF standard: it mandates'
 . ' a tagged structure tree, document language, <code>MarkInfo /Marked true</code>,'
 . ' and <code>ViewerPreferences /DisplayDocTitle true</code>. All of these are written'
 . ' automatically when the <em>pdfua1</em> mode is active.</p>'
 . '<h2>1 — Heading and Paragraph Roles</h2>'
 . '<h3>H3 Sub-heading</h3>'
 . '<p>The <code>h1</code>-<code>h6</code> tags map to PDF roles <strong>H1-H6</strong>.'
 . ' The <code>p</code> tag maps to <strong>P</strong>.'
 . ' PDF/UA-1 requires that heading levels are not skipped: the library clamps each'
 . ' heading to at most one level deeper than the previous heading to maintain a'
 . ' well-formed outline that screen readers can navigate.</p>'
 . '<h2>2 — Block Roles</h2>'
 . '<blockquote>&ldquo;Tagged PDF is the foundation of accessible PDF. Without a'
 . ' well-formed structure tree, automated tools and assistive technologies cannot'
 . ' reliably interpret document content.&rdquo; &mdash; ISO&#160;14289-1 rationale</blockquote>'
 . '<p>The <code>blockquote</code> tag maps to <strong>BlockQuote</strong>.</p>'
 . '<h2>3 — List Structure (L &gt; LI &gt; Lbl + LBody)</h2>'
 . '<p>Both <code>ul</code> and <code>ol</code> map to the <strong>L</strong> role.'
 . ' Each <code>li</code> auto-generates <strong>LI &gt; {Lbl, LBody}</strong> children:</p>'
 . '<ul>'
 . '<li>Unordered item &mdash; <code>ul</code>/<code>li</code> tags produce L/LI structure</li>'
 . '<li>The bullet character is placed in a <strong>Lbl</strong> child element</li>'
 . '<li>Body text is wrapped in a <strong>LBody</strong> child element</li>'
 . '</ul>'
 . '<ol>'
 . '<li>Ordered item &mdash; the number is auto-generated as the <strong>Lbl</strong></li>'
 . '<li>Body text is again auto-wrapped in <strong>LBody</strong></li>'
 . '<li>Nesting: L &gt; LI &gt; {Lbl, LBody}</li>'
 . '</ol>'
 . '<h2>4 — Figure, Image Alt-Text, and Caption</h2>'
 . '<figure>'
 . '<img src="'
 . $imgPath
 . '" alt="TCPDF logo: blue text on white background" width="89" height="30" />'
 . '<figcaption>Figure 1 &mdash; TCPDF logo. The <code>alt</code> attribute becomes'
 . ' <strong>/Alt</strong> in the Figure structure-element dictionary.'
 . ' PDF/UA-1 requires every Figure to carry an /Alt or /ActualText entry so'
 . ' screen readers can describe non-text content. The <code>figcaption</code> tag'
 . ' maps to <strong>Caption</strong>.</figcaption>'
 . '</figure>'
 . '<p>A decorative image has an empty <code>alt</code> attribute: it is emitted as an'
 . ' <strong>Artifact</strong>, not as a Figure, so assistive technology skips it:</p>'
 . '<img src="'
 . $imgPath
 . '" alt="" width="45" height="15" />'
 . '<h2>5 — Table Structure (Table &gt; TR &gt; TH/TD)</h2>'
 . '<table border="1" cellspacing="0" cellpadding="3">'
 . '<caption>Table 1 &mdash; HTML tags and their PDF/UA-1 structure roles</caption>'
 . '<tr><th>HTML tag</th><th>PDF structure role</th><th>Category</th></tr>'
 . '<tr><td>h1&ndash;h6</td><td>H1&ndash;H6</td><td>Heading</td></tr>'
 . '<tr><td>p</td><td>P</td><td>Body</td></tr>'
 . '<tr><td>blockquote</td><td>BlockQuote</td><td>Body</td></tr>'
 . '<tr><td>pre</td><td>Code</td><td>Body</td></tr>'
 . '<tr><td>ul, ol</td><td>L</td><td>List</td></tr>'
 . '<tr><td>li</td><td>LI + Lbl + LBody</td><td>List</td></tr>'
 . '<tr><td>figure</td><td>Figure</td><td>Illustration</td></tr>'
 . '<tr><td>img (with alt)</td><td>Figure + /Alt</td><td>Illustration</td></tr>'
 . '<tr><td>img (alt="")</td><td>Artifact</td><td>Decoration</td></tr>'
 . '<tr><td>figcaption, caption</td><td>Caption</td><td>Illustration</td></tr>'
 . '<tr><td>table</td><td>Table</td><td>Table</td></tr>'
 . '<tr><td>tr</td><td>TR</td><td>Table</td></tr>'
 . '<tr><td>td</td><td>TD</td><td>Table</td></tr>'
 . '<tr><td>th</td><td>TH</td><td>Table</td></tr>'
 . '<tr><td>a</td><td>Link</td><td>Inline</td></tr>'
 . '</table>'
 . '<h2>6 — Hyperlink (Link Role)</h2>'
 . '<p>This sentence contains a'
 . ' <a href="https://github.com/tecnickcom/tc-lib-pdf" style="text-decoration:none;">hyperlink to the tc-lib-pdf repository</a>;'
 . ' the <code>a</code> element is tagged with the <strong>Link</strong> structure role'
 . ' automatically. PDF/UA-1 requires that link annotations have an accessible name,'
 . ' which the library derives from the link text in the structure tree.</p>'
 . '<h2>7 — Rules, Spans and Empty Cells</h2>'
 . '<p>A horizontal rule carries no semantics, so it is emitted as an <strong>Artifact</strong>'
 . ' rather than left as untagged content (PDF/UA-1 7.1):</p>'
 . '<hr>'
 . '<p>Cell <code>colspan</code>/<code>rowspan</code> are recorded on the cell structure'
 . ' element as integer <strong>/ColSpan</strong> and <strong>/RowSpan</strong> attributes,'
 . ' and an empty cell is kept in the tree so the row keeps its full column count (7.2):</p>'
 . '<table border="1" cellspacing="0" cellpadding="3">'
 . '<tr><th>Col A</th><th>Col B</th><th>Col C</th></tr>'
 . '<tr><td colspan="2">Spans columns A and B</td><td>C</td></tr>'
 . '<tr><td rowspan="2">Spans rows</td><td>B2</td><td>C2</td></tr>'
 . '<tr><td>B3</td><td></td></tr>'
 . '</table>';

// A long table that breaks across pages: the repeated header on each continuation
// page is an Artifact, while the single Table structure element keeps all its rows.
$html .=
 '<h2>8 — Page-Spanning Table</h2>'
 . '<table border="1" cellspacing="0" cellpadding="2">'
 . '<thead><tr><th>#</th><th>Description</th></tr></thead>';
for ($row = 1; $row <= 60; ++$row) {
 $html .= '<tr><td>' . $row . '</td><td>Continuation row ' . $row . '</td></tr>';
}

$html .= '</table>';

$html .=
 ''
 . '<h2>9 &ndash; Language Changes (/Lang)</h2>'
 . '<p>The <code>lang</code> attribute sets <strong>/Lang</strong> on the structure element whose'
 . ' language differs from the language in effect. An inline element gets a <strong>Span</strong>,'
 . ' a block without a role of its own a <strong>Div</strong>:</p>'
 . '<p>English text with a Spanish phrase: <span lang="es">Trabajo revisado</span>, then English again.</p>'
 . '<p lang="de">Ein deutscher Absatz: the P element has /Lang (de).</p>'
 . '<div lang="fr"><p>Un paragraphe dans une division fran&ccedil;aise.</p><p>Les deux paragraphes'
 . ' prennent la langue de la Div.</p></div>'
 . '<p>A run in an undetermined language: <span lang="und">xyzzy</span>; a run with an empty'
 . ' attribute, which declares an unknown language and is also written as /Lang (und):'
 . ' <span lang="">plugh</span>.</p>';

// A table row taller than a page continues on the next page: the TD structure element
// holds the content of both pages.
$tallcell = [];
for ($row = 1; $row <= 110; ++$row) {
 $tallcell[] = 'Line ' . $row . ' of a cell taller than a page';
}

$html .=
 '<h2>10 &ndash; Row Taller Than a Page</h2>'
 . '<table border="1" cellspacing="0" cellpadding="2">'
 . '<thead><tr><th>Lines</th></tr></thead>'
 . '<tr><td>'
 . \implode('<br />', $tallcell)
 . '</td></tr></table>';

$pdf->addHTMLCell(html: $html, posx: 15, posy: 20, width: 180);

$rawpdf = $pdf->getOutPDFString();
$pdf->renderPDF(rawpdf: $rawpdf);

Example E017 : pdfua2

Sun, 26 Apr 2026 00:00:00 +0000

PDF/UA-2 output (ISO 14289-2, on PDF 2.0) tagged automatically from HTML.

Rendered PDF: E017_pdfua2.pdf
PHP source: E017_pdfua2.phps
All examples: /examples/
Category: Standards and Conformance
Guide: Standards and Conformance

PDF

Source Code

<?php

declare(strict_types=1);

/**
 * E017_pdfua2.php
 *
 * Demonstrates HTML auto-tagging in 'pdfua2' (PDF/UA-2, ISO 14289-2) mode.
 *
 * PDF/UA-2 is the second generation of the accessible-PDF standard, standardised
 * as ISO 14289-2 and built on PDF 2.0. Key differences from PDF/UA-1:
 * - Targets PDF version 2.0 (pdfver 2.0 in catalog)
 * - Uses the PDF/UA-2 XMP identification schema
 * - The same structure-tree, MarkInfo, /Lang, and heading-clamping rules apply
 *
 * Every HTML element rendered by addHTMLCell() is automatically mapped to the
 * corresponding PDF structure role - no beginStructElem() calls required.
 * Compare with E063 which builds the same structure tree manually.
 *
 * Auto-tagged roles exercised here:
 * h1-h3 → H1-H3 (heading hierarchy)
 * p → P (paragraph)
 * blockquote → BlockQuote
 * pre → Code
 * ul / ol → L (list; li → LI > Lbl + LBody auto-generated)
 * figure → Figure
 * img[alt] → Figure + /Alt (alt text written to struct-elem dictionary)
 * figcaption → Caption
 * table → Table (tr → TR, th → TH, td → TD, caption → Caption)
 * a → Link
 *
 * @since 2026-04-25
 * @category Library
 * @package Pdf
 * @author Nicola Asuni <info@tecnick.com>
 * @copyright 2002-2026 Nicola Asuni - Tecnick.com LTD
 * @license https://www.gnu.org/copyleft/lesser.html GNU-LGPL v3 (see LICENSE)
 * @link https://github.com/tecnickcom/tc-lib-pdf
 *
 * This file is part of tc-lib-pdf software library.
 */

// NOTE: local file reads (images, fonts, attachments) are restricted to an allowlist of
// trusted paths that covers this package tree, so run the examples in place. To read assets
// from other locations, list them in the 'allowedPaths' entry of the fileOptions constructor
// parameter (see E047_remote_resources_security.php).

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

\define('K_PATH_FONTS', \realpath(__DIR__ . '/../vendor/tecnickcom/tc-lib-pdf-font/target/fonts'));

$pdf = new \Com\Tecnick\Pdf\Tcpdf(
 unit: \Com\Tecnick\Pdf\Page\Unit::Millimeter,
 isunicode: true,
 subsetfont: false,
 compress: true,
 mode: \Com\Tecnick\Pdf\PdfConformance::Pdfua2,
);
$pdf->setCreator('tc-lib-pdf');
$pdf->setAuthor('Nicola Asuni');
$pdf->setTitle('PDF/UA-2 Auto-Tagged HTML');
$pdf->setSubject('tc-lib-pdf example: 017 — pdfua2 mode HTML tagging showcase');
$pdf->setKeywords('TCPDF tc-lib-pdf pdfua2 PDF/UA-2 ISO14289-2 PDF2.0 tagged PDF accessibility HTML auto-tag');
$pdf->setPDFFilename('E017_pdfua2.pdf');
$pdf->setLanguage(code: 'en-US');

$font = $pdf->font->insert($pdf->pon, 'dejavusans', '', 10);

// PDF/UA requires every font to be embedded. <code>/<pre> default to the
// non-embedded standard-14 Courier, so register an embedded monospace font and
// select it for those elements.
$pdf->font->insert($pdf->pon, 'dejavusansmono', '', 10);
$pdf->setHTMLMonospaceFont('dejavusansmono');

$pdf->addPage();
$pdf->page->addContent($font['out']);

$imgPath = __DIR__ . '/images/tcpdf_logo.jpg';

$html =
 '<h1>PDF/UA-2 — Auto-Tagged HTML Showcase</h1>'
 . '<p>Mode: <strong>pdfua2</strong> (ISO&#160;14289-2, PDF&#160;2.0). This document'
 . ' demonstrates every HTML element that <code>addHTMLCell()</code> auto-tags with a'
 . ' PDF/UA-2 structure role. PDF/UA-2 advances the accessible-PDF standard onto the'
 . ' PDF&#160;2.0 generation: it uses the updated PDF/UA-2 XMP identification schema'
 . ' and targets PDF version 2.0 while applying the same structure-tree, MarkInfo,'
 . ' /Lang, and heading-clamping rules as PDF/UA-1. The document infrastructure'
 . ' difference is transparent to the HTML tagging layer — all roles map identically.</p>'
 . '<h2>1 — Heading and Paragraph Roles</h2>'
 . '<h3>H3 Sub-heading</h3>'
 . '<p>The <code>h1</code>-<code>h6</code> tags map to PDF roles <strong>H1-H6</strong>.'
 . ' The <code>p</code> tag maps to <strong>P</strong>.'
 . ' Heading levels are clamped to prevent skipped levels: if an <code>h3</code>'
 . ' follows an <code>h1</code> without an intervening <code>h2</code>, the library'
 . ' silently promotes it to H2 so the PDF/UA heading-nesting rule is not violated.</p>'
 . '<h2>2 — Block Roles</h2>'
 . '<blockquote>&ldquo;Tagged PDF is the foundation of accessible PDF. Without a'
 . ' well-formed structure tree, automated tools and assistive technologies cannot'
 . ' reliably interpret document content.&rdquo; &mdash; ISO&#160;14289 rationale</blockquote>'
 . '<p>The <code>blockquote</code> tag maps to <strong>BlockQuote</strong>.</p>'
 . '<h2>3 — List Structure (L &gt; LI &gt; Lbl + LBody)</h2>'
 . '<p>Both <code>ul</code> and <code>ol</code> map to the <strong>L</strong> role.'
 . ' Each <code>li</code> auto-generates <strong>LI &gt; {Lbl, LBody}</strong> children:</p>'
 . '<ul>'
 . '<li>Unordered item &mdash; <code>ul</code>/<code>li</code> tags produce L/LI structure</li>'
 . '<li>The bullet character is placed in a <strong>Lbl</strong> child element</li>'
 . '<li>Body text is wrapped in a <strong>LBody</strong> child element</li>'
 . '</ul>'
 . '<ol>'
 . '<li>Ordered item &mdash; the number is auto-generated as the <strong>Lbl</strong></li>'
 . '<li>Body text is again auto-wrapped in <strong>LBody</strong></li>'
 . '<li>Nesting: L &gt; LI &gt; {Lbl, LBody}</li>'
 . '</ol>'
 . '<h2>4 — Figure, Image Alt-Text, and Caption</h2>'
 . '<figure>'
 . '<img src="'
 . $imgPath
 . '" alt="TCPDF logo: blue text on white background" width="89" height="30" />'
 . '<figcaption>Figure 1 &mdash; TCPDF logo. The <code>alt</code> attribute becomes'
 . ' <strong>/Alt</strong> in the Figure structure-element dictionary.'
 . ' PDF/UA-2 (like PDF/UA-1) requires every Figure to carry an /Alt or'
 . ' /ActualText entry. The <code>figcaption</code> tag maps to'
 . ' <strong>Caption</strong>.</figcaption>'
 . '</figure>'
 . '<p>A decorative image has an empty <code>alt</code> attribute: it is emitted as an'
 . ' <strong>Artifact</strong>, not as a Figure, so assistive technology skips it:</p>'
 . '<img src="'
 . $imgPath
 . '" alt="" width="45" height="15" />'
 . '<h2>5 — Table Structure (Table &gt; TR &gt; TH/TD)</h2>'
 . '<table border="1" cellspacing="0" cellpadding="3">'
 . '<caption>Table 1 &mdash; HTML tags and their PDF/UA-2 structure roles</caption>'
 . '<tr><th>HTML tag</th><th>PDF structure role</th><th>Category</th></tr>'
 . '<tr><td>h1&ndash;h6</td><td>H1&ndash;H6</td><td>Heading</td></tr>'
 . '<tr><td>p</td><td>P</td><td>Body</td></tr>'
 . '<tr><td>blockquote</td><td>BlockQuote</td><td>Body</td></tr>'
 . '<tr><td>pre</td><td>Code</td><td>Body</td></tr>'
 . '<tr><td>ul, ol</td><td>L</td><td>List</td></tr>'
 . '<tr><td>li</td><td>LI + Lbl + LBody</td><td>List</td></tr>'
 . '<tr><td>figure</td><td>Figure</td><td>Illustration</td></tr>'
 . '<tr><td>img (with alt)</td><td>Figure + /Alt</td><td>Illustration</td></tr>'
 . '<tr><td>img (alt="")</td><td>Artifact</td><td>Decoration</td></tr>'
 . '<tr><td>figcaption, caption</td><td>Caption</td><td>Illustration</td></tr>'
 . '<tr><td>table</td><td>Table</td><td>Table</td></tr>'
 . '<tr><td>tr</td><td>TR</td><td>Table</td></tr>'
 . '<tr><td>td</td><td>TD</td><td>Table</td></tr>'
 . '<tr><td>th</td><td>TH</td><td>Table</td></tr>'
 . '<tr><td>a</td><td>Link</td><td>Inline</td></tr>'
 . '</table>'
 . '<h2>6 — Hyperlink (Link Role)</h2>'
 . '<p>This sentence contains a'
 . ' <a href="https://github.com/tecnickcom/tc-lib-pdf" style="text-decoration:none;">hyperlink to the tc-lib-pdf repository</a>;'
 . ' the <code>a</code> element is tagged with the <strong>Link</strong> structure role'
 . ' automatically. In PDF/UA-2 (as in PDF/UA-1), link annotations must be accessible;'
 . ' the library derives the accessible name from the link text in the structure tree.</p>'
 . '<h2>7 &ndash; Language Changes (/Lang)</h2>'
 . '<p>The <code>lang</code> attribute sets <strong>/Lang</strong> on the structure element whose'
 . ' language differs from the language in effect. An inline element gets a <strong>Span</strong>,'
 . ' a block without a role of its own a <strong>Div</strong>:</p>'
 . '<p>English text with a Spanish phrase: <span lang="es">Trabajo revisado</span>, then English again.</p>'
 . '<p lang="de">Ein deutscher Absatz: the P element has /Lang (de).</p>'
 . '<div lang="fr"><p>Un paragraphe dans une division fran&ccedil;aise.</p><p>Les deux paragraphes'
 . ' prennent la langue de la Div.</p></div>'
 . '<p>A run in an undetermined language: <span lang="und">xyzzy</span>; a run with an empty'
 . ' attribute, which declares an unknown language and is also written as /Lang (und):'
 . ' <span lang="">plugh</span>.</p>';

$pdf->addHTMLCell(html: $html, posx: 15, posy: 20, width: 180);

$rawpdf = $pdf->getOutPDFString();
$pdf->renderPDF(rawpdf: $rawpdf);

Example E018 : html page span

Sun, 26 Apr 2026 00:00:00 +0000

An HTML block long enough to span page breaks, showing how the flow continues onto the following pages.

Rendered PDF: E018_html_page_span.pdf
PHP source: E018_html_page_span.phps
All examples: /examples/
Category: HTML and CSS
Guide: HTML and CSS

PDF

Source Code

<?php

declare(strict_types=1);

/**
 * E018_html_page_span.php
 *
 * @since 2026-04-25
 * @category Library
 * @package Pdf
 * @author Nicola Asuni <info@tecnick.com>
 * @copyright 2002-2026 Nicola Asuni - Tecnick.com LTD
 * @license https://www.gnu.org/copyleft/lesser.html GNU-LGPL v3 (see LICENSE)
 * @link https://github.com/tecnickcom/tc-lib-pdf
 *
 * This file is part of tc-lib-pdf software library.
 */

// NOTE: local file reads (images, fonts, attachments) are restricted to an allowlist of
// trusted paths that covers this package tree, so run the examples in place. To read assets
// from other locations, list them in the 'allowedPaths' entry of the fileOptions constructor
// parameter (see E047_remote_resources_security.php).

// NOTE: run make fonts in the project root to generate the dependencies and example fonts.

// autoloader when using Composer
require __DIR__ . '/../vendor/autoload.php';

\define('OUTPUT_FILE', \realpath(__DIR__ . '/../target') . '/example.pdf');

// define fonts directory
\define('K_PATH_FONTS', \realpath(__DIR__ . '/../vendor/tecnickcom/tc-lib-pdf-font/target/fonts'));

// autoloader when using RPM or DEB package installation
//require ('/usr/share/php/Com/Tecnick/Pdf/autoload.php');

// main TCPDF object
$pdf = new \Com\Tecnick\Pdf\Tcpdf(
 unit: \Com\Tecnick\Pdf\Page\Unit::Millimeter,
 isunicode: true,
 subsetfont: false,
 compress: true,
 mode: \Com\Tecnick\Pdf\PdfConformance::None,
 objEncrypt: null,
);

// ----------

$pdf->setCreator('tc-lib-pdf');
$pdf->setAuthor('Nicola Asuni');
$pdf->setSubject('tc-lib-pdf example: 018');
$pdf->setTitle('HTML Page Span Handling');
$pdf->setKeywords('TCPDF tc-lib-pdf html page span pagination flow layout');
$pdf->setPDFFilename('018_html_page_span.pdf');

$pdf->setViewerPreferences(['DisplayDocTitle' => true]);

$pdf->enableDefaultPageContent();

// ----------
// Insert fonts

$bfont1 = $pdf->font->insert($pdf->pon, 'helvetica', '', 12);

$pageV01 = $pdf->addPage();

$bfont6 = $pdf->font->insert($pdf->pon, 'dejavusans', '', 10);

$pdf->page->addContent($bfont6['out']);

$html = 'Some special characters: &lt; € &euro; &#8364; &amp; è &egrave; &copy; &gt; \\slash \\\\double-slash \\\\\\triple-slash
<h2>List</h2>
List example:
<ol>
	<li><b>bold text</b></li>
	<li><i>italic text</i></li>
	<li><u>underlined text</u></li>
	<li><b>b<i>bi<u>biu</u>bi</i>b</b></li>
	<li><a href="https://tcpdf.org" dir="ltr">link to https://tcpdf.org</a></li>
	<li>Sed ut perspiciatis unde omnis iste natus error sit voluptatem accusantium doloremque laudantium, totam rem aperiam, eaque ipsa quae ab illo inventore veritatis et quasi architecto beatae vitae dicta sunt explicabo.<br />Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed quia consequuntur magni dolores eos qui ratione voluptatem sequi nesciunt.</li>
	<li>SUBLIST
		<ol>
			<li>row one
				<ul>
					<li>sublist</li>
				</ul>
			</li>
			<li>row two</li>
		</ol>
	</li>
	<li><b>T</b>E<i>S</i><u>T</u> <del>line through</del></li>
	<li><font size="+3">font + 3</font></li>
	<li><small>small text</small> normal <small>small text</small> normal <sub>subscript</sub> normal <sup>superscript</sup> normal</li>
</ol>
<dl>
	<dt>Coffee</dt>
	<dd>Black hot drink</dd>
	<dt>Milk</dt>
	<dd>White cold drink</dd>
</dl>

<div style="text-align:center">The words &#8220;<span dir="rtl">&#1502;&#1494;&#1500; [mazel] &#1496;&#1493;&#1489; [tov]</span>&#8221; mean &#8220;Congratulations!&#8221;</div>

<p>This is just an example of html code to demonstrate some supported CSS inline styles.
<span style="font-weight: bold;">bold text</span>
<span style="text-decoration: line-through;">line-trough</span>
<span style="text-decoration: underline line-through;">underline and line-trough</span>
<span style="color: rgb(0, 128, 64);">color</span>
<span style="background-color: rgb(255, 0, 0); color: rgb(255, 255, 255);">background color</span>
<span style="font-weight: bold;">bold</span>
<span style="font-size: xx-small;">xx-small</span>
<span style="font-size: x-small;">x-small</span>
<span style="font-size: small;">small</span>
<span style="font-size: medium;">medium</span>
<span style="font-size: large;">large</span>
<span style="font-size: x-large;">x-large</span>
<span style="font-size: xx-large;">xx-large</span>
</p>';

$pdf->addHTMLCell(
 html: '<h1>HTML page break example</h1>' . $html . $html . $html . $html,
 posx: 20,
 posy: 10,
 width: 150,
);

// =============================================================
// Styled block (background + border) spanning multiple pages.

$blockchunk =
 '<p>'
 . 'Sed ut perspiciatis unde omnis iste natus error sit voluptatem accusantium '
 . 'doloremque laudantium, totam rem aperiam, eaque ipsa quae ab illo inventore '
 . 'veritatis et quasi architecto beatae vitae dicta sunt explicabo.'
 . '</p>';

$blockhtml =
 '<h2>Styled block across pages</h2>'
 . '<div style="background-color:#ffeeaa;border:1px solid #888;padding:4px">'
 . '<p><b>Block-level container</b> &mdash; the background and border continue '
 . 'on each page until the content ends.</p>'
 . \str_repeat($blockchunk, 30)
 . '</div>';

$pdf->addHTMLCell(html: $blockhtml, posx: 20, posy: 100, width: 150);

// =============================================================
// Table spanning multiple pages with header row replay.

$tableRows = '';
for ($i = 1; $i <= 20; ++$i) {
 $tableRows .=
 '<tr>'
 . '<td>'
 . $i
 . '</td>'
 . '<td>Lorem ipsum dolor sit amet, consectetur adipiscing elit.</td>'
 . '<td style="text-align:right">'
 . \number_format($i * 12.34, 2)
 . '</td>'
 . '</tr>';
}

$tablehtml =
 '<h2>Table across pages</h2>'
 . '<table border="1" cellpadding="3" cellspacing="0">'
 . '<thead>'
 . '<tr style="background-color:#cccccc">'
 . '<th>#</th><th>Description</th><th>Amount</th>'
 . '</tr>'
 . '</thead>'
 . $tableRows
 . '</table>';

$pdf->addHTMLCell(html: $tablehtml, posx: 20, posy: 220, width: 150);

// =============================================================
// Table rows containing DIV blocks with an explicit CSS height.
// Odd rows use a styled DIV (text color + background color), even rows
// use a bare DIV with only the height set: both must produce the same
// row height, and no row may be split across pages.

$tableRowsB = '';
for ($i = 1; $i <= 8; ++$i) {
 $divstyleB = ($i % 2) === 1 ? 'color:blue; background-color:yellow; height:100px;' : 'color:#007700; height:100px;';
 $tableRowsB .=
 '<tr>'
 . '<td>'
 . $i
 . '</td>'
 . '<td><div style="'
 . $divstyleB
 . '">DIV block #'
 . $i
 . ' (100px high)</div></td>'
 . '<td style="text-align:right">'
 . \number_format($i * 12.34, 2)
 . '</td>'
 . '</tr>';
}

$tablehtmlB =
 '<h2>Fixed-height DIV blocks inside table cells</h2>'
 . '<table border="1" cellpadding="3" cellspacing="0">'
 . '<thead>'
 . '<tr style="background-color:#cccccc">'
 . '<th>#</th><th>Description</th><th>Amount</th>'
 . '</tr>'
 . '</thead>'
 . $tableRowsB
 . '</table>';

$pdf->addHTMLCell(html: $tablehtmlB, posx: 20, posy: 170, width: 150);

// =============================================================

// get PDF document as raw string
$rawpdf = $pdf->getOutPDFString();

// Various output modes:

//$pdf->savePDF(\dirname(__DIR__).'/target', $rawpdf);
$pdf->renderPDF(rawpdf: $rawpdf);

//$pdf->downloadPDF($rawpdf);
//echo $pdf->getMIMEAttachmentPDF($rawpdf);

Example E019 : page regions

Sun, 26 Apr 2026 00:00:00 +0000

Text regions computed as equal columns from the content area, with text flowing from one into the next.

Rendered PDF: E019_page_regions.pdf
PHP source: E019_page_regions.phps
All examples: /examples/
Category: Pages and Layout
Guide: HTML and CSS

PDF

Source Code

<?php

declare(strict_types=1);

/**
 * E019_page_regions.php
 *
 * @since 2026-04-26
 * @category Library
 * @package Pdf
 * @author Nicola Asuni <info@tecnick.com>
 * @copyright 2002-2026 Nicola Asuni - Tecnick.com LTD
 * @license https://www.gnu.org/copyleft/lesser.html GNU-LGPL v3 (see LICENSE)
 * @link https://github.com/tecnickcom/tc-lib-pdf
 *
 * This file is part of tc-lib-pdf software library.
 */

// NOTE: local file reads (images, fonts, attachments) are restricted to an allowlist of
// trusted paths that covers this package tree, so run the examples in place. To read assets
// from other locations, list them in the 'allowedPaths' entry of the fileOptions constructor
// parameter (see E047_remote_resources_security.php).

// NOTE: run make fonts in the project root to generate the dependencies and example fonts.

// autoloader when using Composer
require __DIR__ . '/../vendor/autoload.php';

// define fonts directory
\define('K_PATH_FONTS', \realpath(__DIR__ . '/../vendor/tecnickcom/tc-lib-pdf-font/target/fonts'));

// autoloader when using RPM or DEB package installation
//require ('/usr/share/php/Com/Tecnick/Pdf/autoload.php');

// main TCPDF object
$pdf = new \Com\Tecnick\Pdf\Tcpdf(
 unit: \Com\Tecnick\Pdf\Page\Unit::Millimeter,
 isunicode: true,
 subsetfont: false,
 compress: true,
 mode: \Com\Tecnick\Pdf\PdfConformance::None,
 objEncrypt: null,
);

// ----------

$pdf->setCreator('tc-lib-pdf');
$pdf->setAuthor('Nicola Asuni');
$pdf->setSubject('tc-lib-pdf example: 019');
$pdf->setTitle('Page regions example');
$pdf->setKeywords('TCPDF tc-lib-pdf example page regions columns');
$pdf->setPDFFilename('019_page_regions.pdf');

$pdf->setViewerPreferences(['DisplayDocTitle' => true]);

$pdf->enableDefaultPageContent();

// ----------
// Insert fonts

$titlefont = $pdf->font->insert($pdf->pon, 'helvetica', 'B', 12);
$textfont = $pdf->font->insert($pdf->pon, 'times', '', 11);

// ----------
// Two text regions (columns) generated from the content area.

$leftMargin = 15.0;
$rightMargin = 15.0;
$topMargin = 20.0;
$bottomMargin = 20.0;
$columnGap = 8.0;

$contentWidth = 210.0 - $leftMargin - $rightMargin;
$contentHeight = 297.0 - $topMargin - $bottomMargin;
$columnWidth = ($contentWidth - $columnGap) / 2.0;

$page = $pdf->addPage([
 'margin' => [
 'PL' => $leftMargin,
 'PR' => $rightMargin,
 'CT' => $topMargin,
 'CB' => $bottomMargin,
 ],
 'region' => [
 [
 'RX' => $leftMargin,
 'RY' => $topMargin,
 'RW' => $columnWidth,
 'RH' => $contentHeight,
 ],
 [
 'RX' => $leftMargin + $columnWidth + $columnGap,
 'RY' => $topMargin,
 'RW' => $columnWidth,
 'RH' => $contentHeight,
 ],
 ],
]);

$pdf->page->addContent($titlefont['out']);
$pdf->addTextCell(
 txt: 'Page Regions: two flowing columns across pages',
 pid: $page['pid'],
 posx: 0, // NOTE: addTextCell() coordinates are relative to the current page region
 posy: 0,
 width: 0,
 height: 0,
 offset: 0,
 linespace: 0,
 valign: \Com\Tecnick\Pdf\TextVAlign::Top,
 halign: \Com\Tecnick\Pdf\TextHAlign::Left,
 cell: null,
 styles: [],
 strokewidth: 0,
 wordspacing: 0,
 leading: 0,
 rise: 0,
 jlast: true,
 fill: true,
 stroke: false,
 underline: false,
 linethrough: false,
 overline: false,
 clip: false,
 drawcell: false,
);

$pdf->page->addContent($textfont['out']);

$leftPrefix =
 'LEFT/RIGHT REGION FLOW. This paragraph is rendered using page regions. '
 . 'When the first region is full, writing continues in the next region, '
 . 'then on the next page with the same two-region layout. ';

$baseParagraph =
 'Sed ut perspiciatis unde omnis iste natus error sit voluptatem accusantium doloremque '
 . 'laudantium, totam rem aperiam, eaque ipsa quae ab illo inventore veritatis et quasi architecto '
 . 'beatae vitae dicta sunt explicabo. Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut '
 . 'odit aut fugit, sed quia consequuntur magni dolores eos qui ratione voluptatem sequi nesciunt. '
 . 'Neque porro quisquam est, qui dolorem ipsum quia dolor sit amet, consectetur, adipisci velit.';

$chunks = [];
for ($idx = 1; $idx <= 20; ++$idx) {
 $chunks[] = 'Section ' . $idx . '. ' . $leftPrefix . $baseParagraph;
}

$content = "Two columns with automatic region/page breaks\n\n" . \implode("\n\n", $chunks);

$region = $pdf->page->getRegion($page['pid']);
$regionWidth = (float) $region['RW'];

$pdf->addTextCell(
 txt: $content,
 pid: $page['pid'],
 posx: 0,
 posy: 12,
 width: $regionWidth,
 height: 0,
 offset: 0,
 linespace: 1,
 valign: \Com\Tecnick\Pdf\TextVAlign::Top,
 halign: \Com\Tecnick\Pdf\TextHAlign::Justify,
 cell: null,
 styles: [],
 strokewidth: 0,
 wordspacing: 0,
 leading: 0,
 rise: 0,
 jlast: true,
 fill: true,
 stroke: false,
 underline: false,
 linethrough: false,
 overline: false,
 clip: false,
 drawcell: false,
);

// --- Same example using HTML ---

$pageH = $pdf->addPage([
 'margin' => [
 'PL' => $leftMargin,
 'PR' => $rightMargin,
 'CT' => $topMargin,
 'CB' => $bottomMargin,
 ],
 'region' => [
 [
 'RX' => $leftMargin,
 'RY' => $topMargin,
 'RW' => $columnWidth,
 'RH' => $contentHeight,
 ],
 [
 'RX' => $leftMargin + $columnWidth + $columnGap,
 'RY' => $topMargin,
 'RW' => $columnWidth,
 'RH' => $contentHeight,
 ],
 ],
]);

$contentHtml =
 '<p>'
 . \str_replace("\n\n", '</p><p>', \htmlspecialchars($content, \ENT_QUOTES | \ENT_SUBSTITUTE, 'UTF-8'))
 . '</p>';

$pdf->page->selectRegion(0, $pageH['pid']);
$regionH = $pdf->page->getRegion($pageH['pid']);

$pdf->addHTMLCell(
 html: $contentHtml,
 posx: (float) $regionH['RX'],
 posy: (float) $regionH['RY'],
 width: (float) $regionH['RW'],
);

// --- Test add addTextCellXY() for absolute page coordinates ---

$page = $pdf->addPage([
 'margin' => [
 'PL' => 15.0,
 'PR' => 15.0,
 'CT' => 15.0,
 'CB' => 15.0,
 ],
]);

$pdf->addTextCellXY(
 txt: 'addTextCellXY() uses absolute page coordinates [X=0, Y=0].',
 posx: 0,
 posy: 0,
 drawcell: false,
);

$pdf->addTextCell(
 txt: 'addTextCell() uses relative page region coordinates [x=0, y=0] => [X=15, Y=15].',
 posx: 0,
 posy: 0,
 drawcell: false,
);

// =============================================================

$rawpdf = $pdf->getOutPDFString();

$pdf->renderPDF(rawpdf: $rawpdf);

Example E020 : barcodes

Sun, 26 Apr 2026 00:00:00 +0000

Every supported barcode symbology drawn into a single document, linear, postal, GS1, and two-dimensional.

Rendered PDF: E020_barcodes.pdf
PHP source: E020_barcodes.phps
All examples: /examples/
Category: Barcodes
Guide: tc-lib-barcode
One page per symbology, with input ranges and SVG output: Linear, 2D, Postal

PDF

Source Code

<?php

declare(strict_types=1);

/**
 * E020_barcodes.php
 *
 * @since 2026-04-26
 * @category Library
 * @package Pdf
 * @author Nicola Asuni <info@tecnick.com>
 * @copyright 2002-2026 Nicola Asuni - Tecnick.com LTD
 * @license https://www.gnu.org/copyleft/lesser.html GNU-LGPL v3 (see LICENSE)
 * @link https://github.com/tecnickcom/tc-lib-pdf
 *
 * This file is part of tc-lib-pdf software library.
 */

// NOTE: local file reads (images, fonts, attachments) are restricted to an allowlist of
// trusted paths that covers this package tree, so run the examples in place. To read assets
// from other locations, list them in the 'allowedPaths' entry of the fileOptions constructor
// parameter (see E047_remote_resources_security.php).

// NOTE: run make fonts in the project root to generate the dependencies and example fonts.

// NOTE: this library encodes the data it is given. Several formats carry a number that only
// its registration body can issue, so a symbol is valid in its scheme only once that number
// has been obtained: GS1 member organisations issue the company prefix used by EAN, UPC,
// ITF-14, GS1-128, SSCC-18, GS1-14 and GS1 DataBar; HIBCC assigns the Labeler Identification
// Code used by HIBC39, HIBC128, HIBCDM, HIBCQR and HIBCAZ; Royal Mail issues the Supply Chain
// ID carried by MAILMARK; IFA GmbH allocates the PZN Pharmazentralnummer; Deutsche Post DHL
// assigns the customer number and street codes of IDENTCODE and LEITCODE; AIFA assigns the
// Italian AIC number encoded by C32.

// NOTE: the symbology names below identify the encoded formats and belong to their respective
// owners: QR Code (DENSO WAVE INCORPORATED); GS1, GS1-128 and GS1 DataBar (GS1 AISBL);
// Mailmark (Royal Mail Group Ltd); Intelligent Mail (United States Postal Service);
// PHARMA-CODE (Laetus GmbH); Telepen (S.B. Electronic Systems Ltd); HIBC and HIBCC (Health
// Industry Business Communications Council); KIX (PostNL); Identcode and Leitcode (Deutsche
// Post DHL). They are used descriptively; no affiliation with or endorsement by their owners
// is claimed or implied. GS1 licenses the claims necessary to implement its standards under
// its IP Policy (https://www.gs1.org/standards/ip) to GS1 members and to the participants of
// the work group that developed the standard, rather than to the public at large.

// autoloader when using Composer
require __DIR__ . '/../vendor/autoload.php';

// define fonts directory
\define('K_PATH_FONTS', \realpath(__DIR__ . '/../vendor/tecnickcom/tc-lib-pdf-font/target/fonts'));

// main TCPDF object
$pdf = new \Com\Tecnick\Pdf\Tcpdf(
 unit: \Com\Tecnick\Pdf\Page\Unit::Millimeter,
 isunicode: true,
 subsetfont: false,
 compress: true,
 mode: \Com\Tecnick\Pdf\PdfConformance::None,
 objEncrypt: null,
);

$pdf->setCreator('tc-lib-pdf');
$pdf->setAuthor('Nicola Asuni');
$pdf->setSubject('tc-lib-pdf example: 020');
$pdf->setTitle('All Barcode Types Example');
$pdf->setKeywords('TCPDF tc-lib-pdf example barcodes 1D 2D');
$pdf->setPDFFilename('020_barcodes.pdf');
$pdf->setViewerPreferences(['DisplayDocTitle' => true]);
$pdf->enableDefaultPageContent();

$titlefont = $pdf->font->insert($pdf->pon, 'helvetica', 'B', 12);
$textfont = $pdf->font->insert($pdf->pon, 'helvetica', '', 9);
$smallfont = $pdf->font->insert($pdf->pon, 'helvetica', '', 8);

$style = [
 'lineWidth' => 0,
 'lineCap' => 'butt',
 'lineJoin' => 'miter',
 'dashArray' => [],
 'dashPhase' => 0,
 'lineColor' => 'black',
 'fillColor' => 'black',
];

$linear = [
 [
 'type' => 'AUSPOST',
 'code' => '6254516251ABC123',
 'name' => 'Australia Post 4-State Customer Barcode',
 'standard' => 'Australia Post 4-State Customer Code',
 'use' => 'Australian postal sorting and customer routing barcode.',
 ],
 [
 'type' => 'C128A',
 'code' => '0123456789',
 'name' => 'Code 128 Set A',
 'standard' => 'ISO/IEC 15417',
 'use' => 'High-density linear code for control characters, logistics, and internal labeling.',
 ],
 [
 'type' => 'C128B',
 'code' => '0123456789',
 'name' => 'Code 128 Set B',
 'standard' => 'ISO/IEC 15417',
 'use' => 'High-density linear code for mixed upper/lower-case text in shipping and warehousing.',
 ],
 [
 'type' => 'C128C',
 'code' => '0123456789',
 'name' => 'Code 128 Set C',
 'standard' => 'ISO/IEC 15417',
 'use' => 'Numeric-optimized Code 128 variant for compact encoded numbers and IDs.',
 ],
 [
 'type' => 'C128',
 'code' => '0123456789',
 'name' => 'Code 128 (Auto)',
 'standard' => 'ISO/IEC 15417',
 'use' => 'General-purpose high-density linear symbology with automatic charset selection.',
 ],
 [
 'type' => 'C16K',
 'code' => 'ab0123456789',
 'name' => 'Code 16K',
 'standard' => 'Uniform Symbology Specification Code 16K',
 'use' => 'Stacked Code 128 symbology for small items requiring multi-row data.',
 ],
 [
 'type' => 'C32',
 'code' => '012345676',
 'name' => 'Code 32',
 'standard' => 'Italian Pharmacode (IMH, radix 32)',
 'use' => 'Italian pharmaceutical product coding derived from Code 39.',
 ],
 [
 'type' => 'C49',
 'code' => 'MULTIPLE ROWS IN CODE 49',
 'name' => 'Code 49',
 'standard' => 'ANSI/AIM BC6',
 'use' => 'Multi-row stacked symbology for compact alphanumeric data.',
 ],
 [
 'type' => 'C39E+',
 'code' => '0123456789',
 'name' => 'Code 39 Extended + checksum',
 'standard' => 'ANSI MH10.8M / USS Code 39',
 'use' => 'Extended Code 39 character support with checksum for asset tags and internal IDs.',
 ],
 [
 'type' => 'C39E',
 'code' => '0123456789',
 'name' => 'Code 39 Extended',
 'standard' => 'ANSI MH10.8M / USS Code 39',
 'use' => 'Expanded Code 39 set used for industrial and inventory labels.',
 ],
 [
 'type' => 'C39+',
 'code' => '0123456789',
 'name' => 'Code 39 + checksum',
 'standard' => 'ANSI MH10.8M / USS Code 39',
 'use' => 'Code 39 with checksum to improve scan reliability in production environments.',
 ],
 [
 'type' => 'C39',
 'code' => '0123456789',
 'name' => 'Code 39',
 'standard' => 'ANSI MH10.8M-1983 (USD-3 / 3 of 9)',
 'use' => 'Classic alphanumeric barcode used for parts, equipment, and non-retail logistics.',
 ],
 [
 'type' => 'C93',
 'code' => '0123456789',
 'name' => 'Code 93',
 'standard' => 'USS-93',
 'use' => 'Compact linear code often used where Code 39 would be too wide.',
 ],
 [
 'type' => 'CODABAR',
 'code' => '0123456789',
 'name' => 'Codabar',
 'standard' => 'NW-7 (legacy)',
 'use' => 'Legacy symbology used in libraries, blood banks, and some healthcare systems.',
 ],
 [
 'type' => 'CODE11',
 'code' => '0123456789',
 'name' => 'Code 11',
 'standard' => 'USD-8 (legacy)',
 'use' => 'Numeric code widely used in telecommunications and labeling of equipment.',
 ],
 [
 'type' => 'DATABAR',
 'code' => '09501101530010',
 'name' => 'GS1 DataBar Omnidirectional',
 'standard' => 'ISO/IEC 24724',
 'use' => 'GS1 item identification scannable from any orientation at retail point of sale.',
 ],
 [
 'type' => 'DATABAREXP',
 'code' => '(01)90614141000015(3202)000150',
 'name' => 'GS1 DataBar Expanded',
 'standard' => 'ISO/IEC 24724',
 'use' => 'Encodes GS1 Application Identifiers such as weight, price, and dates.',
 ],
 [
 'type' => 'DATABAREXPSTACK',
 'code' => '(01)90614141000015(3202)000150',
 'name' => 'GS1 DataBar Expanded Stacked',
 'standard' => 'ISO/IEC 24724',
 'use' => 'Stacked form of DataBar Expanded for narrow label areas.',
 ],
 [
 'type' => 'DATABARLIMITED',
 'code' => '15012345678907',
 'name' => 'GS1 DataBar Limited',
 'standard' => 'ISO/IEC 24724',
 'use' => 'Item identification for small retail packages not scanned omnidirectionally.',
 ],
 [
 'type' => 'DATABARSTACK',
 'code' => '00012345678905',
 'name' => 'GS1 DataBar Stacked',
 'standard' => 'ISO/IEC 24724',
 'use' => 'Two-row DataBar for very small items such as loose produce.',
 ],
 [
 'type' => 'DATABARSTACKOMNI',
 'code' => '00034567890125',
 'name' => 'GS1 DataBar Stacked Omnidirectional',
 'standard' => 'ISO/IEC 24724',
 'use' => 'Two-row omnidirectional DataBar for point-of-sale scanning of small items.',
 ],
 [
 'type' => 'DATABARTRUNC',
 'code' => '00012345678905',
 'name' => 'GS1 DataBar Truncated',
 'standard' => 'ISO/IEC 24724',
 'use' => 'Reduced-height DataBar for non-retail item marking.',
 ],
 [
 'type' => 'EAN13',
 'code' => '0123456789',
 'name' => 'EAN-13',
 'standard' => 'GS1 EAN/UPC',
 'use' => 'Global retail product identification barcode used on consumer goods.',
 ],
 [
 'type' => 'EAN2',
 'code' => '12',
 'name' => 'EAN 2-digit add-on',
 'standard' => 'GS1 EAN/UPC add-on',
 'use' => 'Supplementary add-on commonly used to encode issue numbers for periodicals.',
 ],
 [
 'type' => 'EAN5',
 'code' => '12345',
 'name' => 'EAN 5-digit add-on',
 'standard' => 'GS1 EAN/UPC add-on',
 'use' => 'Supplementary add-on often used for suggested retail pricing on books/magazines.',
 ],
 [
 'type' => 'EAN8',
 'code' => '1234567',
 'name' => 'EAN-8',
 'standard' => 'GS1 EAN/UPC',
 'use' => 'Compact retail barcode for very small consumer packages.',
 ],
 [
 'type' => 'GS114',
 'code' => '9501101020917',
 'name' => 'GS1-14 / EAN-14 / SCC-14',
 'standard' => 'GS1 General Specifications (GS1-128 with AI 01)',
 'use' => 'Trade item grouping identifier (GTIN-14) for cases and pallets.',
 ],
 [
 'type' => 'GS1128',
 'code' => '(01)09501101020917(10)AB-123',
 'name' => 'GS1-128',
 'standard' => 'ISO/IEC 15417 with GS1 Application Identifiers',
 'use' => 'Supply-chain data carrier for batch, expiry, and logistics attributes.',
 ],
 [
 'type' => 'HIBC128',
 'code' => '+A123BJC5D6E71',
 'name' => 'HIBC in Code 128',
 'standard' => 'ANSI/HIBC 2.6 and ANSI/HIBC 1.3',
 'use' => 'Health industry supplier labeling of medical products in Code 128.',
 ],
 [
 'type' => 'HIBC39',
 'code' => '+A123BJC5D6E71',
 'name' => 'HIBC in Code 39',
 'standard' => 'ANSI/HIBC 2.6 and ANSI/HIBC 1.3',
 'use' => 'Health industry supplier labeling of medical products in Code 39.',
 ],
 [
 'type' => 'I25+',
 'code' => '0123456789',
 'name' => 'Interleaved 2 of 5 + checksum',
 'standard' => 'ITF / Interleaved 2 of 5',
 'use' => 'Numeric shipping and carton labels with checksum for improved integrity.',
 ],
 [
 'type' => 'I25',
 'code' => '0123456789',
 'name' => 'Interleaved 2 of 5',
 'standard' => 'ITF / Interleaved 2 of 5',
 'use' => 'Numeric-only barcode frequently used on corrugated packaging.',
 ],
 [
 'type' => 'IDENTCODE',
 'code' => '563102430313',
 'name' => 'Deutsche Post Identcode',
 'standard' => 'Deutsche Post Identcode (Interleaved 2 of 5 based)',
 'use' => 'German parcel identification for Deutsche Post shipments.',
 ],
 [
 'type' => 'IMB',
 'code' => '01234567094987654321-01234567891',
 'name' => 'Intelligent Mail Barcode',
 'standard' => 'USPS-B-3200',
 'use' => 'USPS mail sorting and tracking barcode for letters and flats.',
 ],
 [
 'type' => 'IMBPRE',
 'code' => 'AADTFFDFTDADTAADAATFDTDDAAADDTDTTDAFADADDDTFFFDDTTTADFAAADFTDAADA',
 'name' => 'IMB pre-processed',
 'standard' => 'USPS Intelligent Mail (pre-encoded pattern)',
 'use' => 'Feeds a precomputed IMB state pattern when encoding is prepared upstream.',
 ],
 [
 'type' => 'ITF14',
 'code' => '09312345678907',
 'name' => 'ITF-14',
 'standard' => 'GS1 General Specifications (ITF-14)',
 'use' => 'GTIN-14 marking on corrugated cartons and outer packaging, with bearer bars.',
 ],
 [
 'type' => 'JPPOST',
 'code' => '910-00673-80-25J1-2B',
 'name' => 'Japan Post Customer Barcode',
 'standard' => 'Japan Post Customer Barcode (4-state)',
 'use' => 'Japanese postal address and routing barcode.',
 ],
 [
 'type' => 'KIX',
 'code' => '0123456789',
 'name' => 'KIX',
 'standard' => 'PostNL KIX (4-state)',
 'use' => 'Dutch postal customer indexing and routing barcode.',
 ],
 [
 'type' => 'LEITCODE',
 'code' => '21348075016401',
 'name' => 'Deutsche Post Leitcode',
 'standard' => 'Deutsche Post Leitcode (Interleaved 2 of 5 based)',
 'use' => 'German postal routing code for destination sorting.',
 ],
 [
 'type' => 'LOGMARS',
 'code' => '12345/ABCDE',
 'name' => 'LOGMARS',
 'standard' => 'MIL-STD-1189B (Code 39 profile)',
 'use' => 'US military logistics marking and asset labeling.',
 ],
 [
 'type' => 'MAILMARK',
 'code' => '41038422416563762EF61AH8T ',
 'name' => 'Royal Mail Mailmark',
 'standard' => 'Royal Mail Mailmark 4-state (types C and L)',
 'use' => 'UK mail tracking and reporting barcode.',
 ],
 [
 'type' => 'MSI+',
 'code' => '0123456789',
 'name' => 'MSI + checksum',
 'standard' => 'MSI Plessey (variant)',
 'use' => 'Inventory-oriented numeric coding with checksum for warehouse workflows.',
 ],
 [
 'type' => 'MSI',
 'code' => '0123456789',
 'name' => 'MSI',
 'standard' => 'MSI Plessey (variant)',
 'use' => 'Numeric barcode used in stock control and shelf labeling.',
 ],
 [
 'type' => 'PHARMA2T',
 // the two-track Pharmacode encodes an integer between 4 and 64570080
 'code' => '12345678',
 'name' => 'Pharmacode two-track',
 'standard' => 'Pharmacode (2-track variant)',
 'use' => 'Pharmaceutical package line verification using two-track bar patterns.',
 ],
 [
 'type' => 'PHARMA',
 // the Pharmacode encodes an integer between 3 and 131070
 'code' => '123456',
 'name' => 'Pharmacode',
 'standard' => 'Laetus Pharmacode',
 'use' => 'Pharmaceutical packaging control on production lines.',
 ],
 [
 'type' => 'PLANET',
 'code' => '0123456789',
 'name' => 'PLANET',
 'standard' => 'USPS PLANET (legacy)',
 'use' => 'Legacy USPS mail tracking and routing barcode.',
 ],
 [
 'type' => 'PLESSEY',
 'code' => '0123456789ABCDEF',
 'name' => 'Plessey Code',
 'standard' => 'Plessey (legacy)',
 'use' => 'Legacy hexadecimal symbology used for retail shelf labeling.',
 ],
 [
 'type' => 'POSTNET',
 'code' => '0123456789',
 'name' => 'POSTNET',
 'standard' => 'USPS POSTNET (legacy)',
 'use' => 'Legacy USPS ZIP and delivery-point encoding for mail sorting.',
 ],
 [
 'type' => 'PZN',
 'code' => '2758089',
 'name' => 'PZN',
 'standard' => 'IFA Pharmazentralnummer (Code 39 based)',
 'use' => 'German pharmaceutical central product number for medicines.',
 ],
 [
 'type' => 'RMS4CC',
 'code' => '0123456789',
 'name' => 'RMS4CC',
 'standard' => 'Royal Mail 4-State Customer Code',
 'use' => 'UK postal addressing and sorting barcode.',
 ],
 [
 'type' => 'S25+',
 'code' => '0123456789',
 'name' => 'Standard 2 of 5 + checksum',
 'standard' => 'Standard 2 of 5 (industrial)',
 'use' => 'Numeric industrial barcode with checksum for improved reliability.',
 ],
 [
 'type' => 'S25',
 'code' => '0123456789',
 'name' => 'Standard 2 of 5',
 'standard' => 'Standard 2 of 5 (industrial)',
 'use' => 'Legacy numeric industrial labeling barcode.',
 ],
 [
 'type' => 'S25DATALOGIC',
 'code' => '0123456789',
 'name' => '2 of 5 Datalogic',
 'standard' => '2 of 5 Datalogic (China Post Code)',
 'use' => 'Numeric variant used by China Post and legacy Datalogic systems.',
 ],
 [
 'type' => 'S25IATA',
 'code' => '0123456789',
 'name' => '2 of 5 IATA',
 'standard' => '2 of 5 IATA (Computer Identics 2 of 5)',
 'use' => 'Air cargo and baggage handling numeric barcode.',
 ],
 [
 'type' => 'S25MATRIX',
 'code' => '0123456789',
 'name' => '2 of 5 Matrix',
 'standard' => '2 of 5 Matrix',
 'use' => 'Numeric symbology denser than Standard 2 of 5 for industrial labels.',
 ],
 [
 'type' => 'SSCC18',
 'code' => '39501101020917171',
 'name' => 'SSCC-18',
 'standard' => 'GS1 General Specifications (GS1-128 with AI 00)',
 'use' => 'Serial Shipping Container Code identifying logistic units.',
 ],
 [
 'type' => 'TELEPEN',
 'code' => 'ABC123',
 'name' => 'Telepen',
 'standard' => 'Telepen (full ASCII)',
 'use' => 'Library and academic sector symbology encoding the full ASCII set.',
 ],
 [
 'type' => 'UPCA',
 'code' => '72527273070',
 'name' => 'UPC-A',
 'standard' => 'GS1 EAN/UPC',
 'use' => 'Retail barcode primarily used in North America.',
 ],
 [
 'type' => 'UPCE',
 'code' => '725277',
 'name' => 'UPC-E',
 'standard' => 'GS1 EAN/UPC',
 'use' => 'Compressed UPC format for small retail packages.',
 ],
];

$square = [
 [
 'type' => 'LRAW',
 'code' => '0101010101',
 'name' => '1D raw mode',
 'standard' => 'Library raw mode (non-standard)',
 'use' => 'Debug/test mode that directly renders provided 1D bit patterns.',
 ],
 [
 'type' => 'SRAW',
 'code' => '0101,1010',
 'name' => '2D raw mode',
 'standard' => 'Library raw mode (non-standard)',
 'use' => 'Debug/test mode that directly renders provided 2D bit grids.',
 ],
 [
 'type' => 'AZTEC',
 'code' => 'ABCDabcd01234',
 'name' => 'Aztec Code',
 'standard' => 'ISO/IEC 24778:2008',
 'use' => 'Compact 2D code used for tickets, transport passes, and mobile scans.',
 ],
 [
 'type' => 'AZTEC,50,A,A',
 'code' => 'ABCDabcd01234',
 'name' => 'Aztec Code (with parameters)',
 'standard' => 'ISO/IEC 24778:2008',
 'use' => 'Aztec variant with explicit encoder parameters for size/error tuning.',
 ],
 [
 'type' => 'AZTECRUNE',
 'code' => '125',
 'name' => 'Aztec Rune',
 'standard' => 'ISO/IEC 24778:2008 Annex A',
 'use' => 'Minimal Aztec symbol encoding a single value from 0 to 255.',
 ],
 [
 'type' => 'PDF417',
 'code' => '0123456789',
 'name' => 'PDF417',
 'standard' => 'ISO/IEC 15438:2006',
 'use' => 'Stacked 2D barcode used in transport, identity, and archival workflows.',
 ],
 [
 'type' => 'PDF417C',
 'code' => '0123456789',
 'name' => 'Compact PDF417',
 'standard' => 'ISO/IEC 15438:2006 (compact/truncated)',
 'use' => 'Truncated PDF417 without right row indicators for narrow print areas.',
 ],
 [
 'type' => 'QRCODE',
 'code' => '0123456789',
 'name' => 'QR Code',
 'standard' => 'ISO/IEC 18004',
 'use' => 'Widely used 2D code for URLs, mobile interactions, and consumer scanning.',
 ],
 [
 'type' => 'QRCODE,H,ST,0,0',
 'code' => 'abcdefghijklmnopqrstuvwxy0123456789',
 'name' => 'QR Code (with parameters)',
 'standard' => 'ISO/IEC 18004',
 'use' => 'QR variant with explicit error correction and encoding parameters.',
 ],
 [
 'type' => 'MICROQR',
 'code' => '0123456789',
 'name' => 'Micro QR Code',
 'standard' => 'ISO/IEC 18004',
 'use' => 'Reduced-size QR variant for small marking areas and short payloads.',
 ],
 [
 'type' => 'MICROQR,M,4,AN',
 'code' => 'ABCDEFGHIJKLMNOPQR',
 'name' => 'Micro QR Code (with parameters)',
 'standard' => 'ISO/IEC 18004',
 'use' => 'Micro QR variant with explicit error correction, version, and encoding mode.',
 ],
 [
 'type' => 'HANXIN',
 'code' => '0123456789',
 'name' => 'Han Xin Code',
 'standard' => 'GB/T 21049, ISO/IEC 20830',
 'use' => 'Chinese national 2D code for logistics, product identification, and Chinese text.',
 ],
 [
 'type' => 'HANXIN,L3,10,2',
 'code' => '1234567890ABCDEFGabcdefg,Han Xin Code',
 'name' => 'Han Xin Code (with parameters)',
 'standard' => 'GB/T 21049, ISO/IEC 20830',
 'use' => 'Han Xin variant with explicit error correction level, symbol version, and mask pattern.',
 ],
 [
 'type' => 'HIBCAZ',
 'code' => '+A123BJC5D6E71',
 'name' => 'HIBC in Aztec Code',
 'standard' => 'ANSI/HIBC 2.6 and ANSI/HIBC 1.3',
 'use' => 'Health industry supplier labeling of medical products in Aztec Code.',
 ],
 [
 'type' => 'HIBCDM',
 'code' => '+A123BJC5D6E71',
 'name' => 'HIBC in Data Matrix',
 'standard' => 'ANSI/HIBC 2.6 and ANSI/HIBC 1.3',
 'use' => 'Health industry supplier labeling of medical products in Data Matrix.',
 ],
 [
 'type' => 'HIBCQR',
 'code' => '+A123BJC5D6E71',
 'name' => 'HIBC in QR Code',
 'standard' => 'ANSI/HIBC 2.6 and ANSI/HIBC 1.3',
 'use' => 'Health industry supplier labeling of medical products in QR Code.',
 ],
 [
 'type' => 'DATAMATRIX',
 'code' => '0123456789',
 'name' => 'Data Matrix (square)',
 'standard' => 'ISO/IEC 16022',
 'use' => 'Compact 2D marking used in electronics, medical devices, and manufacturing.',
 ],
 [
 'type' => 'DATAMATRIX,R',
 'code' => '0123456789012345678901234567890123456789',
 'name' => 'Data Matrix (rectangular)',
 'standard' => 'ISO/IEC 16022',
 'use' => 'Rectangular Data Matrix for narrow labels and constrained print areas.',
 ],
 [
 'type' => 'DATAMATRIX,S,GS1',
 'code' => \chr(232) . '01095011010209171719050810ABCD1234' . \chr(232) . '2110',
 'name' => 'GS1 Data Matrix (square)',
 'standard' => 'ISO/IEC 16022 with GS1 AIs',
 'use' => 'GS1-compliant 2D code for regulated product IDs and traceability.',
 ],
 [
 'type' => 'DATAMATRIX,R,GS1',
 'code' => \chr(232) . '01095011010209171719050810ABCD1234' . \chr(232) . '2110',
 'name' => 'GS1 Data Matrix (rectangular)',
 'standard' => 'ISO/IEC 16022 with GS1 AIs',
 'use' => 'Rectangular GS1 Data Matrix for compact traceability labels.',
 ],
 [
 'type' => 'DMRE',
 'code' => 'A1B2C3D4E5F6G7H8I9J0K1L2',
 'name' => 'Data Matrix Rectangular Extension',
 'standard' => 'ISO/IEC 21471',
 'use' => 'Extra rectangular symbol sizes for marking thin parts and narrow labels.',
 ],
 [
 'type' => 'DMRE,GS1',
 'code' => \chr(232) . '01095011010209171719050810ABCD1234' . \chr(232) . '2110',
 'name' => 'GS1 Data Matrix Rectangular Extension',
 'standard' => 'ISO/IEC 21471 with GS1 AIs',
 'use' => 'GS1-compliant rectangular extension for traceability on narrow labels.',
 ],
 [
 'type' => 'DMRE,N,ASCII,8x144',
 'code' => 'A1B2C3D4E5F6G7H8I9J0K1L2',
 'name' => 'Data Matrix Rectangular Extension 8x144',
 'standard' => 'ISO/IEC 21471',
 'use' => 'Rectangular extension with an explicit symbol size and encoding mode.',
 ],
];

// notices from tc-lib-barcode README.md
$notices = <<<'EOD'
 <style>
 h1 { font-size: 12pt; }
 h2 { font-size: 10pt; }
 p { font-size: 8pt; }
 table { font-size: 8pt; }
 th { text-align: left; }
 </style>
 <h1>Barcode Types Catalog (3/3): Registration Bodies and Trademarks</h1>
 <p>Source: tc-lib-barcode README.md</p>
 <h2>Identifiers issued by a registration body</h2>
 <p>The library encodes the data it is given. Several formats carry a number that only its
 registration body can issue, so a symbol is valid in its scheme only once that number has been
 obtained.</p>
 <table border="1" cellpadding="3" cellspacing="0" width="100%">
 <tr>
 <th width="35%" bgcolor="#eeeeee">Format</th>
 <th width="65%" bgcolor="#eeeeee">Issued by</th>
 </tr>
 <tr>
 <td>EAN, UPC, ITF-14, GS1-128, SSCC-18, GS1-14, GS1 DataBar</td>
 <td>a GS1 member organisation, which issues the company prefix</td>
 </tr>
 <tr>
 <td>HIBC39, HIBC128, HIBCDM, HIBCQR, HIBCAZ</td>
 <td>HIBCC, which assigns the Labeler Identification Code</td>
 </tr>
 <tr>
 <td>MAILMARK</td>
 <td>Royal Mail, which issues the Supply Chain ID carried in the barcode</td>
 </tr>
 <tr>
 <td>PZN</td>
 <td>IFA GmbH, which allocates the Pharmazentralnummer</td>
 </tr>
 <tr>
 <td>IDENTCODE, LEITCODE</td>
 <td>Deutsche Post DHL, which assigns the customer number and the street codes</td>
 </tr>
 <tr>
 <td>C32</td>
 <td>AIFA, which assigns the Italian AIC number</td>
 </tr>
 </table>
 <h2>Trademarks</h2>
 <p>The names below identify the symbologies this library encodes and belong to their respective
 owners. They are used descriptively; no affiliation with or endorsement by their owners is
 claimed or implied.</p>
 <table border="1" cellpadding="3" cellspacing="0" width="100%">
 <tr>
 <th width="35%" bgcolor="#eeeeee">Name</th>
 <th width="65%" bgcolor="#eeeeee">Owner</th>
 </tr>
 <tr>
 <td>QR Code</td>
 <td>DENSO WAVE INCORPORATED</td>
 </tr>
 <tr>
 <td>GS1, GS1-128, GS1 DataBar</td>
 <td>GS1 AISBL</td>
 </tr>
 <tr>
 <td>Mailmark</td>
 <td>Royal Mail Group Ltd</td>
 </tr>
 <tr>
 <td>Intelligent Mail</td>
 <td>United States Postal Service</td>
 </tr>
 <tr>
 <td>PHARMA-CODE</td>
 <td>Laetus GmbH</td>
 </tr>
 <tr>
 <td>Telepen</td>
 <td>S.B. Electronic Systems Ltd</td>
 </tr>
 <tr>
 <td>HIBC, HIBCC</td>
 <td>Health Industry Business Communications Council</td>
 </tr>
 <tr>
 <td>KIX</td>
 <td>PostNL</td>
 </tr>
 <tr>
 <td>Identcode, Leitcode</td>
 <td>Deutsche Post DHL</td>
 </tr>
 </table>
 <p>GS1 licenses the claims necessary to implement its standards under its IP Policy
 (https://www.gs1.org/standards/ip), to GS1 members and to the participants of the work group
 that developed the standard, rather than to the public at large.</p>
 EOD;

function formatSampleDataForText(string $sample): string
{
 $out = '';
 $bytes = \unpack('C*', $sample);
 if ($bytes === false) {
 return '';
 }

 foreach ($bytes as $byte) {
 if ($byte === 232) {
 $out .= '<FNC1>';
 continue;
 }

 if ($byte >= 32 && $byte <= 126) {
 $out .= \chr($byte);
 continue;
 }

 $out .= '\\x' . \strtoupper(\str_pad((string) \dechex($byte), 2, '0', STR_PAD_LEFT));
 }

 return $out;
}

function renderBarcodeSection(
 \Com\Tecnick\Pdf\Tcpdf $pdf,
 array $items,
 string $title,
 int $sectionIndex,
 int $sectionCount,
 array $titlefont,
 array $textfont,
 array $smallfont,
 array $style,
 bool $square = false,
): void {
 $marginLeft = 12.0;
 $marginRight = 12.0;
 $marginTop = 15.0;
 $marginBottom = 12.0;

 $page = $pdf->addPage([
 'margin' => [
 'PL' => $marginLeft,
 'PR' => $marginRight,
 'CT' => $marginTop,
 'CB' => $marginBottom,
 ],
 ]);

 $pageWidth = (float) $page['width'];
 $pageHeight = (float) $page['height'];
 $contentWidth = $pageWidth - $marginLeft - $marginRight;
 $maxY = $pageHeight - $marginBottom;

 $drawHeader = static function () use (
 $pdf,
 $titlefont,
 $smallfont,
 $title,
 $sectionIndex,
 $sectionCount,
 $marginLeft,
 $contentWidth,
 ): float {
 $pdf->page->addContent($titlefont['out']);
 $pdf->page->addContent($pdf->getTextCell(
 txt: 'Barcode Types Catalog (' . $sectionIndex . '/' . $sectionCount . '): ' . $title,
 posx: $marginLeft,
 posy: 10,
 width: $contentWidth,
 height: 0,
 offset: 0,
 linespace: 1,
 valign: \Com\Tecnick\Pdf\TextVAlign::Top,
 halign: \Com\Tecnick\Pdf\TextHAlign::Left,
 ));

 $pdf->page->addContent($smallfont['out']);
 $pdf->page->addContent($pdf->getTextCell(
 txt: 'Source type list: tc-lib-barcode example/index.php',
 posx: $marginLeft,
 posy: 16,
 width: $contentWidth,
 height: 0,
 offset: 0,
 linespace: 1,
 valign: \Com\Tecnick\Pdf\TextVAlign::Top,
 halign: \Com\Tecnick\Pdf\TextHAlign::Left,
 ));

 return 22.0;
 };

 $cursorY = $drawHeader();
 foreach ($items as $item) {
 $sampleText = formatSampleDataForText($item['code']);
 $desc = 'Standard: ' . $item['standard'] . "\n" . 'Use: ' . $item['use'] . "\n" . 'Sample data: ' . $sampleText;

 $descTopOffset = 4.5;
 $descLineSpace = 1.0;
 $barcodeGap = 4.0;
 $barcodeBlockGap = 8.0;

 while (true) {
 $descTopY = $cursorY + $descTopOffset;
 $descOut = $pdf->getTextCell(
 txt: $desc,
 posx: $marginLeft,
 posy: $descTopY,
 width: $contentWidth,
 height: 0,
 offset: 0,
 linespace: $descLineSpace,
 valign: \Com\Tecnick\Pdf\TextVAlign::Top,
 halign: \Com\Tecnick\Pdf\TextHAlign::Left,
 );
 $descBBox = $pdf->getLastBBox();
 $barcodePosY = (float) $descBBox['y'] + (float) $descBBox['h'] + $barcodeGap;
 $barcodeWidth = -1;
 $barcodeHeight = -1;

 if (!$square) {
 $metrics = $pdf->barcode->getBarcodeObj($item['type'], $item['code'])->getArray();
 $ncols = (int) $metrics['ncols'];
 $nrows = (int) $metrics['nrows'];
 $targetMinBarWidth = 0.65;
 $barcodeWidth = (int) \max(1, \min($contentWidth, \round($ncols * $targetMinBarWidth)));
 // stacked symbologies keep the module aspect ratio, the other ones use a fixed bar height
 $barcodeHeight = $nrows > 4 ? (int) \max(1, \round(($barcodeWidth * $nrows) / $ncols)) : 10;
 }

 $barcodeModel = $pdf->barcode->getBarcodeObj(
 $item['type'],
 $item['code'],
 $barcodeWidth,
 $barcodeHeight,
 'black',
 [0, 0, 0, 0],
 );
 $barcodeData = $barcodeModel->getArray();
 $itemBottomY = $barcodePosY + (float) $barcodeData['full_height'];
 $nextCursorY = $itemBottomY + $barcodeBlockGap;

 if ($nextCursorY <= $maxY) {
 break;
 }

 $page = $pdf->addPage([
 'margin' => [
 'PL' => $marginLeft,
 'PR' => $marginRight,
 'CT' => $marginTop,
 'CB' => $marginBottom,
 ],
 ]);

 $cursorY = $drawHeader();
 }

 $pdf->page->addContent($textfont['out']);
 $head = '[' . $item['type'] . '] ' . $item['name'];
 $pdf->page->addContent($pdf->getTextCell(
 txt: $head,
 posx: $marginLeft,
 posy: $cursorY,
 width: $contentWidth,
 height: 0,
 offset: 0,
 linespace: 1,
 valign: \Com\Tecnick\Pdf\TextVAlign::Top,
 halign: \Com\Tecnick\Pdf\TextHAlign::Left,
 ));

 $pdf->page->addContent($smallfont['out']);
 $pdf->page->addContent($descOut);

 $pdf->page->addContent($pdf->getBarcode(
 type: $item['type'],
 code: $item['code'],
 posx: $marginLeft,
 posy: $barcodePosY,
 width: $barcodeWidth,
 height: $barcodeHeight,
 padding: [0, 0, 0, 0],
 style: $style,
 ));

 $cursorY = $nextCursorY;
 }
}

function renderNoticePage(\Com\Tecnick\Pdf\Tcpdf $pdf, string $html, array $textfont): void
{
 $marginLeft = 12.0;
 $marginRight = 12.0;

 $page = $pdf->addPage([
 'margin' => [
 'PL' => $marginLeft,
 'PR' => $marginRight,
 'CT' => 15.0,
 'CB' => 12.0,
 ],
 ]);

 $pdf->page->addContent($textfont['out']);
 $pdf->addHTMLCell(
 html: $html,
 posx: $marginLeft,
 posy: 10,
 width: (float) $page['width'] - $marginLeft - $marginRight,
 );
}

renderBarcodeSection($pdf, $linear, 'Linear', 1, 3, $titlefont, $textfont, $smallfont, $style, false);
renderBarcodeSection($pdf, $square, 'Square / 2D', 2, 3, $titlefont, $textfont, $smallfont, $style, true);
renderNoticePage($pdf, $notices, $textfont);

$rawpdf = $pdf->getOutPDFString();
$pdf->renderPDF(rawpdf: $rawpdf);

Example E021 : font stretch spacing

Sun, 26 Apr 2026 00:00:00 +0000

Horizontal font stretching and character spacing applied to text cells.

Rendered PDF: E021_font_stretch_spacing.pdf
PHP source: E021_font_stretch_spacing.phps
All examples: /examples/
Category: Text and Typography

PDF

Source Code

<?php

declare(strict_types=1);

/**
 * E021_font_stretch_spacing.php
 *
 * @since 2026-04-26
 * @category Library
 * @package Pdf
 * @author Nicola Asuni <info@tecnick.com>
 * @copyright 2002-2026 Nicola Asuni - Tecnick.com LTD
 * @license https://www.gnu.org/copyleft/lesser.html GNU-LGPL v3 (see LICENSE)
 * @link https://github.com/tecnickcom/tc-lib-pdf
 *
 * This file is part of tc-lib-pdf software library.
 */

// NOTE: local file reads (images, fonts, attachments) are restricted to an allowlist of
// trusted paths that covers this package tree, so run the examples in place. To read assets
// from other locations, list them in the 'allowedPaths' entry of the fileOptions constructor
// parameter (see E047_remote_resources_security.php).

// NOTE: run make fonts in the project root to generate the dependencies and example fonts.

// autoloader when using Composer
require __DIR__ . '/../vendor/autoload.php';

// define fonts directory
\define('K_PATH_FONTS', \realpath(__DIR__ . '/../vendor/tecnickcom/tc-lib-pdf-font/target/fonts'));

$pdf = new \Com\Tecnick\Pdf\Tcpdf(
 unit: \Com\Tecnick\Pdf\Page\Unit::Millimeter,
 isunicode: true,
 subsetfont: false,
 compress: true,
 mode: \Com\Tecnick\Pdf\PdfConformance::None,
 objEncrypt: null,
);

$pdf->setCreator('tc-lib-pdf');
$pdf->setAuthor('Nicola Asuni');
$pdf->setSubject('tc-lib-pdf example: 021');
$pdf->setTitle('Font stretching, scaling and spacing');
$pdf->setKeywords('TCPDF tc-lib-pdf example font stretching scaling spacing');
$pdf->setPDFFilename('021_font_stretch_spacing.pdf');
$pdf->setViewerPreferences(['DisplayDocTitle' => true]);
$pdf->enableDefaultPageContent();

$style = [
 'all' => [
 'lineWidth' => 0.2,
 'lineCap' => 'butt',
 'lineJoin' => 'miter',
 'dashArray' => [],
 'dashPhase' => 0,
 'lineColor' => 'black',
 'fillColor' => '',
 ],
];

$applyFont = static function (\Com\Tecnick\Pdf\Tcpdf $pdf, float $spacing, float $stretching, int $size = 11): array {
 // $stretching is a font-stack ratio (1.0 = 100%); the percent-valued modes
 // below divide by 100 before calling this helper.
 $font = $pdf->font->insert($pdf->pon, 'times', '', $size, $spacing, $stretching);
 $pdf->page->addContent($font['out']);
 return $font;
};

$measureText = static function (\Com\Tecnick\Pdf\Tcpdf $pdf, string $text): array {
 $ordarr = $pdf->uniconv->strToOrdArr($text);
 $width = $pdf->font->getOrdArrWidth($ordarr);
 return [$ordarr, $width];
};

$drawBoxedLine = static function (
 \Com\Tecnick\Pdf\Tcpdf $pdf,
 array $style,
 string $text,
 float $x,
 float $y,
 float $w,
 float $h,
 float $spacing,
 float $stretching,
) use ($applyFont): void {
 $font = $applyFont($pdf, $spacing, $stretching, 11);
 $pdf->page->addContent($pdf->graph->getRect($x, $y, $w, $h, 'D', $style));
 $baseline = $y + 1.5 + $pdf->toUnit($font['ascent']);
 $pdf->page->addContent($pdf->getTextLine(txt: $text, posx: $x + 1.5, posy: $baseline));
};

$setNeutralTitleFont = static function (\Com\Tecnick\Pdf\Tcpdf $pdf): void {
 $font = $pdf->font->insert($pdf->pon, 'helvetica', 'B', 13, 0.0, 1.0);
 $pdf->page->addContent($font['out']);
};

$setNeutralTextFont = static function (\Com\Tecnick\Pdf\Tcpdf $pdf): void {
 $font = $pdf->font->insert($pdf->pon, 'helvetica', '', 9, 0.0, 1.0);
 $pdf->page->addContent($font['out']);
};

// Insert one neutral font before addPage() so page context has a valid current font.
$pdf->font->insert($pdf->pon, 'helvetica', '', 10, 0.0, 1.0);

$pdf->addPage();

$setNeutralTitleFont($pdf);
$pdf->page->addContent($pdf->getTextCell(
 txt: 'Example 021 - Font stretching, scaling and spacing',
 posx: 15,
 posy: 15,
 width: 180,
 height: 0,
 offset: 0,
 linespace: 1,
 valign: \Com\Tecnick\Pdf\TextVAlign::Top,
 halign: \Com\Tecnick\Pdf\TextHAlign::Left,
));

$setNeutralTextFont($pdf);
$pdf->page->addContent($pdf->getTextCell(
 txt: 'This mirrors the legacy cell stretch sample using tc-lib-pdf font spacing/stretching controls.',
 posx: 15,
 posy: 23,
 width: 180,
 height: 0,
 offset: 0,
 linespace: 1,
 valign: \Com\Tecnick\Pdf\TextVAlign::Top,
 halign: \Com\Tecnick\Pdf\TextHAlign::Left,
));

$sample = 'TEST CELL STRETCH: scaling and spacing';
$left = 15;
$top = 32;
$cellw = 85;
$cellh = 8;
$labelw = 95;

$applyFont($pdf, 0.0, 1.0, 11);
[$ordarr, $baseWidthPoints] = $measureText($pdf, $sample);
$textChars = \count($ordarr);
$targetWidthPoints = $pdf->toPoints($cellw - 3);

$scaleFitRatio = $baseWidthPoints > $targetWidthPoints ? $targetWidthPoints / $baseWidthPoints : 1.0;
$scaleForceRatio = $targetWidthPoints / $baseWidthPoints;
$scaleFit = 100.0 * $scaleFitRatio;
$scaleForce = 100.0 * $scaleForceRatio;

$spacingFit = 0.0;
if ($baseWidthPoints > $targetWidthPoints && $textChars > 1) {
 $spacingFit = ($targetWidthPoints - $baseWidthPoints) / ($textChars - 1);
}

$spacingForce = 0.0;
if ($textChars > 1) {
 $spacingForce = ($targetWidthPoints - $baseWidthPoints) / ($textChars - 1);
}

$modes = [
 ['no stretch', 0.0, 100.0],
 ['scaling (fit)', 0.0, $scaleFit],
 ['force scaling', 0.0, $scaleForce],
 ['spacing (fit)', $spacingFit, 100.0],
 ['force spacing', $spacingForce, 100.0],
];

$firstBlockEndY = $top;
$row = 0;
foreach ($modes as $mode) {
 $y = $top + ($row * ($cellh + 1.5));
 $label = \sprintf('%s [stretch=%.1f%%, spacing=%.3fpt]', $mode[0], $mode[2], $mode[1]);
 $setNeutralTextFont($pdf);
 $pdf->page->addContent($pdf->getTextLine(txt: $label, posx: $left, posy: $y + 5.5));
 $drawBoxedLine($pdf, $style, $sample, $left + $labelw, $y, $cellw, $cellh, $mode[1], $mode[2] / 100.0);
 $firstBlockEndY = \max($firstBlockEndY, $y + $cellh, $y + 6.5);
 ++$row;
}

$secondIntroY = $firstBlockEndY + 10.0;
$secondTitleY = $secondIntroY + 8.0;
$secondRowsStartY = $secondTitleY + 9.0;

$setNeutralTextFont($pdf);
$pdf->page->addContent($pdf->getTextCell(
 txt: 'Second section: global font stretching and spacing combinations (legacy example style).',
 posx: 15,
 posy: $secondIntroY,
 width: 180,
 height: 0,
 offset: 0,
 linespace: 1,
 valign: \Com\Tecnick\Pdf\TextVAlign::Top,
 halign: \Com\Tecnick\Pdf\TextHAlign::Left,
));

$setNeutralTitleFont($pdf);
$pdf->page->addContent($pdf->getTextCell(
 txt: 'Global stretching/spacing matrix',
 posx: 15,
 posy: $secondTitleY,
 width: 180,
 height: 0,
 offset: 0,
 linespace: 1,
 valign: \Com\Tecnick\Pdf\TextVAlign::Top,
 halign: \Com\Tecnick\Pdf\TextHAlign::Left,
));

$stretchVals = [90.0, 100.0, 110.0];
$spacingVals = [-0.72, 0.0, 0.72]; // ~ -0.254, 0, +0.254 mm expressed in points.
$sample2 = 'Stretching and spacing test text';

$y = $secondRowsStartY;
foreach ($stretchVals as $stretching) {
 foreach ($spacingVals as $spacing) {
 $line = \sprintf('Stretching %3.0f%%, Spacing %+.3fpt', $stretching, $spacing);
 $setNeutralTextFont($pdf);
 $pdf->page->addContent($pdf->getTextLine(txt: $line, posx: 15, posy: $y + 5.5));
 $drawBoxedLine($pdf, $style, $sample2, 95, $y, 100, 8, $spacing, $stretching / 100.0);
 $y += 9.5;
 }
 $y += 2;
}

$rawpdf = $pdf->getOutPDFString();
$pdf->renderPDF(rawpdf: $rawpdf);

Example E022 : cell borders

Sun, 26 Apr 2026 00:00:00 +0000

Cell border styles and background fills, side by side.

Rendered PDF: E022_cell_borders.pdf
PHP source: E022_cell_borders.phps
All examples: /examples/
Category: Text and Typography

PDF

Source Code

<?php

declare(strict_types=1);

/**
 * E022_cell_borders.php
 *
 * @since 2026-04-26
 * @category Library
 * @package Pdf
 * @author Nicola Asuni <info@tecnick.com>
 * @copyright 2002-2026 Nicola Asuni - Tecnick.com LTD
 * @license https://www.gnu.org/copyleft/lesser.html GNU-LGPL v3 (see LICENSE)
 * @link https://github.com/tecnickcom/tc-lib-pdf
 *
 * This file is part of tc-lib-pdf software library.
 */

// NOTE: local file reads (images, fonts, attachments) are restricted to an allowlist of
// trusted paths that covers this package tree, so run the examples in place. To read assets
// from other locations, list them in the 'allowedPaths' entry of the fileOptions constructor
// parameter (see E047_remote_resources_security.php).

// NOTE: run make fonts in the project root to generate the dependencies and example fonts.

// autoloader when using Composer
require __DIR__ . '/../vendor/autoload.php';

// define fonts directory
\define('K_PATH_FONTS', \realpath(__DIR__ . '/../vendor/tecnickcom/tc-lib-pdf-font/target/fonts'));

$pdf = new \Com\Tecnick\Pdf\Tcpdf(
 unit: \Com\Tecnick\Pdf\Page\Unit::Millimeter,
 isunicode: true,
 subsetfont: false,
 compress: true,
 mode: \Com\Tecnick\Pdf\PdfConformance::None,
 objEncrypt: null,
);

$pdf->setCreator('tc-lib-pdf');
$pdf->setAuthor('Nicola Asuni');
$pdf->setSubject('tc-lib-pdf example: 022');
$pdf->setTitle('Cell borders');
$pdf->setKeywords('TCPDF tc-lib-pdf example cell borders');
$pdf->setPDFFilename('022_cell_borders.pdf');
$pdf->setViewerPreferences(['DisplayDocTitle' => true]);
$pdf->enableDefaultPageContent();

$setFont = static function (\Com\Tecnick\Pdf\Tcpdf $pdf, string $family, string $style, int $size): array {
 $font = $pdf->font->insert($pdf->pon, $family, $style, $size, 0.0, 1.0);
 $pdf->page->addContent($font['out']);
 return $font;
};

$getLineStyle = static fn(float $width, string $color): array => [
 'lineWidth' => $width,
 'lineCap' => 'butt',
 'lineJoin' => 'miter',
 'dashArray' => [],
 'dashPhase' => 0,
 'lineColor' => $color,
];

$buildCellStyles = static function (array $sideStyles, string $fillColor): array {
 $fillStyle = [
 'lineWidth' => 0,
 'lineCap' => 'butt',
 'lineJoin' => 'miter',
 'dashArray' => [],
 'dashPhase' => 0,
 'lineColor' => '#000000', //$fillColor,
 'fillColor' => $fillColor,
 ];

 $styles = [
 'all' => $fillStyle,
 0 => $fillStyle,
 1 => $fillStyle,
 2 => $fillStyle,
 3 => $fillStyle,
 ];

 foreach ($sideStyles as $side => $style) {
 $styles[$side] = \array_merge($fillStyle, $style, ['fillColor' => $fillColor]);
 }

 return $styles;
};

$drawStyledCell = static function (
 \Com\Tecnick\Pdf\Tcpdf $pdf,
 string $label,
 float $x,
 float $y,
 float $w,
 float $h,
 array $styles,
 float $borderPos,
): void {
 $pdf->setDefaultCellBorderPos(borderpos: $borderPos);

 $pdf->page->addContent($pdf->getTextCell(' ', $x, $y, $w, $h, styles: $styles, drawcell: true));

 $pdf->page->addContent($pdf->color->getPdfColor('black'));
 $pdf->page->addContent($pdf->getTextCell(
 $label,
 $x,
 $y,
 $w,
 $h,
 valign: \Com\Tecnick\Pdf\TextVAlign::Center,
 halign: \Com\Tecnick\Pdf\TextHAlign::Center,
 drawcell: false,
 ));
};

$pdf->font->insert($pdf->pon, 'helvetica', '', 10, 0.0, 1.0);

$pdf->addPage();

$setFont($pdf, 'helvetica', 'B', 20);
$pdf->page->addContent($pdf->getTextCell(
 'Cell Borders',
 15,
 15,
 180,
 8,
 valign: \Com\Tecnick\Pdf\TextVAlign::Center,
 halign: \Com\Tecnick\Pdf\TextHAlign::Left,
 drawcell: false,
));

$setFont($pdf, 'helvetica', '', 11);

$basicLineStyle = $getLineStyle(0.508, '#0080ff');
$fillColor = '#ffff80';
$maskToSide = ['T' => 0, 'R' => 1, 'B' => 2, 'L' => 3];

$masks = ['1', 'LTRB', 'LTR', 'TRB', 'LRB', 'LTB', 'LT', 'TR', 'RB', 'LB', 'LR', 'TB', 'L', 'T', 'R', 'B'];
$x = 15.0;
$y = 32.0;
$w = 30.0;
$h = 8.0;

foreach ($masks as $mask) {
 $active = $mask === '1' ? 'LTRB' : $mask;
 $sideStyles = [];
 foreach ($maskToSide as $side => $idx) {
 if (!\str_contains($active, $side)) {
 continue;
 }

 $sideStyles[$idx] = $basicLineStyle;
 }
 $drawStyledCell($pdf, $mask, $x, $y, $w, $h, $buildCellStyles($sideStyles, $fillColor), $pdf::BORDERPOS_DEFAULT);
 $y += 10.0;
}

$normalBorders = [
 0 => \array_merge($getLineStyle(2.0, '#ff0000'), ['lineCap' => 'square']),
 1 => \array_merge($getLineStyle(2.0, '#ff0000'), ['lineCap' => 'square']),
 2 => \array_merge($getLineStyle(2.0, '#ff0000'), ['lineCap' => 'square']),
 3 => \array_merge($getLineStyle(2.0, '#ff0000'), ['lineCap' => 'square']),
];

$multiBorders = [
 0 => \array_merge($getLineStyle(2.0, '#00ff00'), ['lineCap' => 'square']),
 1 => \array_merge($getLineStyle(2.0, '#ff00ff'), ['lineCap' => 'square']),
 2 => \array_merge($getLineStyle(2.0, '#0000ff'), ['lineCap' => 'square']),
 3 => \array_merge($getLineStyle(2.0, '#ff0000'), ['lineCap' => 'square']),
];

$advX = $x;
$advY = $y + 5.0;
$drawStyledCell(
 $pdf,
 'LTRB',
 $advX,
 $advY,
 30,
 10,
 $buildCellStyles($normalBorders, $fillColor),
 $pdf::BORDERPOS_DEFAULT,
);
$advY += 15.0;

$drawStyledCell(
 $pdf,
 'LTRB',
 $advX,
 $advY,
 30,
 10,
 $buildCellStyles($multiBorders, $fillColor),
 $pdf::BORDERPOS_DEFAULT,
);
$advY += 15.0;

$drawStyledCell(
 $pdf,
 'LTRB EXT',
 $advX,
 $advY,
 30,
 10,
 $buildCellStyles($normalBorders, $fillColor),
 $pdf::BORDERPOS_EXTERNAL,
);
$advY += 15.0;

$drawStyledCell(
 $pdf,
 'LTRB INT',
 $advX,
 $advY,
 30,
 10,
 $buildCellStyles($normalBorders, $fillColor),
 $pdf::BORDERPOS_INTERNAL,
);

$pdf->setDefaultCellBorderPos(borderpos: $pdf::BORDERPOS_DEFAULT);

$rawpdf = $pdf->getOutPDFString();
$pdf->renderPDF(rawpdf: $rawpdf);

Example E023 : cell alignment

Sun, 26 Apr 2026 00:00:00 +0000

Horizontal alignment (left, centre, right, justified) and vertical alignment (top, centre, bottom, ascent, baseline, descent) inside a text cell.

Rendered PDF: E023_cell_alignment.pdf
PHP source: E023_cell_alignment.phps
All examples: /examples/
Category: Text and Typography

PDF

Source Code

<?php

declare(strict_types=1);

/**
 * E023_cell_alignment.php
 *
 * @since 2026-04-26
 * @category Library
 * @package Pdf
 * @author Nicola Asuni <info@tecnick.com>
 * @copyright 2002-2026 Nicola Asuni - Tecnick.com LTD
 * @license https://www.gnu.org/copyleft/lesser.html GNU-LGPL v3 (see LICENSE)
 * @link https://github.com/tecnickcom/tc-lib-pdf
 *
 * This file is part of tc-lib-pdf software library.
 */

// NOTE: local file reads (images, fonts, attachments) are restricted to an allowlist of
// trusted paths that covers this package tree, so run the examples in place. To read assets
// from other locations, list them in the 'allowedPaths' entry of the fileOptions constructor
// parameter (see E047_remote_resources_security.php).

// NOTE: run make fonts in the project root to generate the dependencies and example fonts.

// autoloader when using Composer
require __DIR__ . '/../vendor/autoload.php';

// define fonts directory
\define('K_PATH_FONTS', \realpath(__DIR__ . '/../vendor/tecnickcom/tc-lib-pdf-font/target/fonts'));

$pdf = new \Com\Tecnick\Pdf\Tcpdf(
 unit: \Com\Tecnick\Pdf\Page\Unit::Millimeter,
 isunicode: true,
 subsetfont: false,
 compress: true,
 mode: \Com\Tecnick\Pdf\PdfConformance::None,
 objEncrypt: null,
);

$pdf->setCreator('tc-lib-pdf');
$pdf->setAuthor('Nicola Asuni');
$pdf->setSubject('tc-lib-pdf example: 023');
$pdf->setTitle('Cell alignment');
$pdf->setKeywords('TCPDF tc-lib-pdf example cell alignment');
$pdf->setPDFFilename('023_cell_alignment.pdf');
$pdf->setViewerPreferences(['DisplayDocTitle' => true]);
$pdf->enableDefaultPageContent();

$setFont = static function (\Com\Tecnick\Pdf\Tcpdf $pdf, string $family, string $style, int $size): array {
 $font = $pdf->font->insert($pdf->pon, $family, $style, $size, 0.0, 1.0);
 $pdf->page->addContent($font['out']);
 return $font;
};

$getLineStyle = static fn(float $width, string $color): array => [
 'lineWidth' => $width,
 'lineCap' => 'butt',
 'lineJoin' => 'miter',
 'dashArray' => [],
 'dashPhase' => 0,
 'lineColor' => $color,
];

$pdf->font->insert($pdf->pon, 'helvetica', '', 10, 0.0, 1.0);

$pdf->addPage();

$setFont($pdf, 'helvetica', 'B', 20);
$pdf->page->addContent($pdf->getTextCell(
 'Cell Alignment Example',
 15,
 15,
 180,
 8,
 valign: \Com\Tecnick\Pdf\TextVAlign::Center,
 halign: \Com\Tecnick\Pdf\TextHAlign::Left,
 drawcell: false,
));

$bodyFont = $setFont($pdf, 'helvetica', '', 11);

$borderStyle = ['all' => $getLineStyle(0.7, '#0080ff')];
$lineStyle = $getLineStyle(0.1, '#ff0000');
$cellDef = [
 'margin' => ['T' => 0.0, 'R' => 0.0, 'B' => 0.0, 'L' => 0.0],
 'padding' => ['T' => 0.0, 'R' => 0.0, 'B' => 0.0, 'L' => 0.0],
 'borderpos' => 0.0,
];

$cellW = 30.0;
$cellH = $pdf->toUnit($bodyFont['size']) * 3.0;
$startX = 15.0;
$fontHeight = $pdf->toUnit($bodyFont['height']);
$fontAscent = $pdf->toUnit($bodyFont['ascent']);
$columns = [
 ['prefix' => 'Top', 'cellAlign' => 'T'],
 ['prefix' => 'Center', 'cellAlign' => 'C'],
 ['prefix' => 'Bottom', 'cellAlign' => 'B'],
 ['prefix' => 'Ascent', 'cellAlign' => 'A'],
 ['prefix' => 'Baseline', 'cellAlign' => 'L'],
 ['prefix' => 'Descent', 'cellAlign' => 'D'],
];

$rows = [
 ['lineY' => 60.0, 'suffix' => 'Center', 'textAlign' => 'C'],
 ['lineY' => 90.0, 'suffix' => 'Top', 'textAlign' => 'T'],
 ['lineY' => 120.0, 'suffix' => 'Bottom', 'textAlign' => 'B'],
];

$getCellTopY = static fn(
 float $lineY,
 float $cellH,
 string $cellAlign,
 string $textAlign,
 float $fontHeight,
 float $fontAscent,
): float => match ($cellAlign) {
 'C' => $lineY - ($cellH / 2.0),
 'B' => $lineY - $cellH,
 'A' => match ($textAlign) {
 'T' => $lineY,
 'B' => $lineY - ($cellH - $fontHeight),
 default => $lineY - (($cellH - $fontHeight) / 2.0),
 },
 'L' => match ($textAlign) {
 'T' => $lineY - $fontAscent,
 'B' => $lineY - ($cellH - ($fontHeight - $fontAscent)),
 default => $lineY - ((($cellH - $fontHeight) / 2.0) + $fontAscent),
 },
 'D' => match ($textAlign) {
 'T' => $lineY - $fontHeight,
 'B' => $lineY - $cellH,
 default => $lineY - (($cellH + $fontHeight) / 2.0),
 },
 default => $lineY,
};

$drawCellBorder = static fn(
 \Com\Tecnick\Pdf\Tcpdf $pdf,
 float $x,
 float $y,
 float $w,
 float $h,
 array $style,
): string => (
 $pdf->graph->getLine($x, $y, $x + $w, $y, $style)
 . $pdf->graph->getLine($x + $w, $y, $x + $w, $y + $h, $style)
 . $pdf->graph->getLine($x + $w, $y + $h, $x, $y + $h, $style)
 . $pdf->graph->getLine($x, $y + $h, $x, $y, $style)
);

foreach ($rows as $row) {
 $pdf->page->addContent($pdf->graph->getLine(15, $row['lineY'], 195, $row['lineY'], $lineStyle));
 foreach ($columns as $idx => $col) {
 $x = $startX + ($idx * $cellW);
 $y = $getCellTopY($row['lineY'], $cellH, $col['cellAlign'], $row['textAlign'], $fontHeight, $fontAscent);
 $label = $col['prefix'] . '-' . $row['suffix'];
 $pdf->page->addContent($pdf->color->getPdfColor('black'));
 $pdf->page->addContent($pdf->getTextCell(
 $label,
 $x,
 $y,
 $cellW,
 $cellH,
 valign: $row['textAlign'],
 halign: \Com\Tecnick\Pdf\TextHAlign::Center,
 cell: $cellDef,
 drawcell: false,
 ));
 $pdf->page->addContent($drawCellBorder($pdf, $x, $y, $cellW, $cellH, $borderStyle['all']));
 }
}

$imagePath = __DIR__ . '/images/tcpdf_cell.png';
if (\is_file($imagePath)) {
 $imgId = $pdf->image->add($imagePath);
 $page = $pdf->page->getPage($pdf->page->getPageId());
 $pdf->page->addContent($pdf->image->getSetImage($imgId, 15, 160, 100, 100, $page['height']));
}

$legend =
 "LEGEND:\n\n"
 . "X: cell x top-left origin (top-right for RTL)\n"
 . "Y: cell y top-left origin (top-right for RTL)\n"
 . "CW: cell width\n"
 . "CH: cell height\n"
 . "LW: line width\n"
 . "NRL: normal line position\n"
 . "EXT: external line position\n"
 . "INT: internal line position\n"
 . "ML: margin left\n"
 . "MR: margin right\n"
 . "MT: margin top\n"
 . "MB: margin bottom\n"
 . "PL: padding left\n"
 . "PR: padding right\n"
 . "PT: padding top\n"
 . "PB: padding bottom\n"
 . "TW: text width\n"
 . "FA: font ascent\n"
 . "FB: font baseline\n"
 . 'FD: font descent';

$setFont($pdf, 'helvetica', '', 10);
$pdf->page->addContent($pdf->getTextCell($legend, 125, 160, 70, 100, 0, 1.25, 'T', 'L', drawcell: false));

// ---------------------------------------------------------------------------
// Second page: alignment combined with asymmetric paddings.
// ---------------------------------------------------------------------------

$pdf->addPage();

$setFont($pdf, 'helvetica', 'B', 20);
$pdf->page->addContent($pdf->getTextCell(
 'Cell Padding and Alignment',
 15,
 15,
 180,
 8,
 valign: \Com\Tecnick\Pdf\TextVAlign::Center,
 halign: \Com\Tecnick\Pdf\TextHAlign::Left,
 drawcell: false,
));

$setFont($pdf, 'helvetica', '', 9);
$pdf->page->addContent($pdf->getTextCell(
 'The text is aligned inside the padding box (dashed grey) and not inside the whole cell (solid blue).'
 . ' The margin and padding values of the "cell" parameter are expressed in points,'
 . ' so they are converted here with toPoints(); the padding sizes below are in millimeters.',
 15,
 25,
 180,
 12,
 0,
 0.5,
 valign: \Com\Tecnick\Pdf\TextVAlign::Top,
 halign: \Com\Tecnick\Pdf\TextHAlign::Left,
 drawcell: false,
));

/**
 * Returns a cell definition with the given padding expressed in user units.
 */
$getCellDef = static fn(\Com\Tecnick\Pdf\Tcpdf $pdf, float $top, float $right, float $bottom, float $left): array => [
 'margin' => ['T' => 0.0, 'R' => 0.0, 'B' => 0.0, 'L' => 0.0],
 // the cell definition stores the padding in points
 'padding' => [
 'T' => $pdf->toPoints($top),
 'R' => $pdf->toPoints($right),
 'B' => $pdf->toPoints($bottom),
 'L' => $pdf->toPoints($left),
 ],
 'borderpos' => \Com\Tecnick\Pdf\Base::BORDERPOS_DEFAULT,
];

$padStyle = $getLineStyle(0.1, '#808080');
$padStyle['dashArray'] = [1, 1];

$drawPaddingBox = static fn(
 \Com\Tecnick\Pdf\Tcpdf $pdf,
 float $x,
 float $y,
 float $w,
 float $h,
 array $pad,
 array $style,
): string => $drawCellBorder(
 $pdf,
 $x + $pdf->toUnit($pad['L']),
 $y + $pdf->toUnit($pad['T']),
 $w - $pdf->toUnit($pad['L'] + $pad['R']),
 $h - $pdf->toUnit($pad['T'] + $pad['B']),
 $style,
);

$vcolumns = [
 ['label' => 'Top', 'valign' => \Com\Tecnick\Pdf\TextVAlign::Top],
 ['label' => 'Center', 'valign' => \Com\Tecnick\Pdf\TextVAlign::Center],
 ['label' => 'Bottom', 'valign' => \Com\Tecnick\Pdf\TextVAlign::Bottom],
 ['label' => 'Ascent', 'valign' => \Com\Tecnick\Pdf\TextVAlign::Ascent],
 ['label' => 'Baseline', 'valign' => \Com\Tecnick\Pdf\TextVAlign::Baseline],
 ['label' => 'Descent', 'valign' => \Com\Tecnick\Pdf\TextVAlign::Descent],
];

$vpaddings = [
 ['label' => 'vertical padding: T=0 B=0', 'T' => 0.0, 'B' => 0.0],
 ['label' => 'vertical padding: T=10 B=0', 'T' => 10.0, 'B' => 0.0],
 ['label' => 'vertical padding: T=0 B=10', 'T' => 0.0, 'B' => 10.0],
 ['label' => 'vertical padding: T=12 B=4', 'T' => 12.0, 'B' => 4.0],
];

$vcellW = 180.0 / \count($vcolumns);
$vcellH = 24.0;
$vrowPitch = 32.0;
$vtop = 48.0;

$setFont($pdf, 'helvetica', 'B', 11);
$pdf->page->addContent($pdf->getTextCell(
 'Vertical alignment (valign)',
 15,
 40,
 180,
 5,
 valign: \Com\Tecnick\Pdf\TextVAlign::Top,
 halign: \Com\Tecnick\Pdf\TextHAlign::Left,
 drawcell: false,
));

foreach ($vpaddings as $vrow => $vpad) {
 $rowY = $vtop + ($vrow * $vrowPitch);
 $cellY = $rowY + 6.0;
 $cellDef = $getCellDef($pdf, $vpad['T'], 0.0, $vpad['B'], 0.0);

 $setFont($pdf, 'helvetica', 'I', 8);
 $pdf->page->addContent($pdf->getTextCell(
 $vpad['label'],
 15,
 $rowY,
 180,
 5,
 valign: \Com\Tecnick\Pdf\TextVAlign::Top,
 halign: \Com\Tecnick\Pdf\TextHAlign::Left,
 drawcell: false,
 ));

 foreach ($vcolumns as $idx => $col) {
 $x = $startX + ($idx * $vcellW);
 $setFont($pdf, 'helvetica', '', 9);
 $pdf->page->addContent($pdf->getTextCell(
 $col['label'],
 $x,
 $cellY,
 $vcellW,
 $vcellH,
 valign: $col['valign'],
 halign: \Com\Tecnick\Pdf\TextHAlign::Center,
 cell: $cellDef,
 drawcell: false,
 ));
 $pdf->page->addContent($drawCellBorder($pdf, $x, $cellY, $vcellW, $vcellH, $borderStyle['all']));
 $pdf->page->addContent($drawPaddingBox($pdf, $x, $cellY, $vcellW, $vcellH, $cellDef['padding'], $padStyle));
 }
}

$hcolumns = [
 ['label' => 'Left', 'halign' => \Com\Tecnick\Pdf\TextHAlign::Left],
 ['label' => 'Center', 'halign' => \Com\Tecnick\Pdf\TextHAlign::Center],
 ['label' => 'Right', 'halign' => \Com\Tecnick\Pdf\TextHAlign::Right],
];

$hpaddings = [
 ['label' => 'horizontal padding: L=0 R=0', 'L' => 0.0, 'R' => 0.0],
 ['label' => 'horizontal padding: L=15 R=0', 'L' => 15.0, 'R' => 0.0],
 ['label' => 'horizontal padding: L=0 R=15', 'L' => 0.0, 'R' => 15.0],
];

$hcellW = 180.0 / \count($hcolumns);
$hcellH = 12.0;
$hrowPitch = 20.0;
$htop = 190.0;

$setFont($pdf, 'helvetica', 'B', 11);
$pdf->page->addContent($pdf->getTextCell(
 'Horizontal alignment (halign)',
 15,
 182,
 180,
 5,
 valign: \Com\Tecnick\Pdf\TextVAlign::Top,
 halign: \Com\Tecnick\Pdf\TextHAlign::Left,
 drawcell: false,
));

foreach ($hpaddings as $hrow => $hpad) {
 $rowY = $htop + ($hrow * $hrowPitch);
 $cellY = $rowY + 6.0;
 $cellDef = $getCellDef($pdf, 0.0, $hpad['R'], 0.0, $hpad['L']);

 $setFont($pdf, 'helvetica', 'I', 8);
 $pdf->page->addContent($pdf->getTextCell(
 $hpad['label'],
 15,
 $rowY,
 180,
 5,
 valign: \Com\Tecnick\Pdf\TextVAlign::Top,
 halign: \Com\Tecnick\Pdf\TextHAlign::Left,
 drawcell: false,
 ));

 foreach ($hcolumns as $idx => $col) {
 $x = $startX + ($idx * $hcellW);
 $setFont($pdf, 'helvetica', '', 9);
 $pdf->page->addContent($pdf->getTextCell(
 $col['label'],
 $x,
 $cellY,
 $hcellW,
 $hcellH,
 valign: \Com\Tecnick\Pdf\TextVAlign::Center,
 halign: $col['halign'],
 cell: $cellDef,
 drawcell: false,
 ));
 $pdf->page->addContent($drawCellBorder($pdf, $x, $cellY, $hcellW, $hcellH, $borderStyle['all']));
 $pdf->page->addContent($drawPaddingBox($pdf, $x, $cellY, $hcellW, $hcellH, $cellDef['padding'], $padStyle));
 }
}

$rawpdf = $pdf->getOutPDFString();
$pdf->renderPDF(rawpdf: $rawpdf);

Example E024 : colors

Sun, 26 Apr 2026 00:00:00 +0000

CMYK, RGB, and grayscale colour output from the same set of colour strings.

Rendered PDF: E024_colors.pdf
PHP source: E024_colors.phps
All examples: /examples/
Category: Colour

PDF

Source Code

<?php

declare(strict_types=1);

/**
 * E024_colors.php
 *
 * @since 2026-04-26
 * @category Library
 * @package Pdf
 * @author Nicola Asuni <info@tecnick.com>
 * @copyright 2002-2026 Nicola Asuni - Tecnick.com LTD
 * @license https://www.gnu.org/copyleft/lesser.html GNU-LGPL v3 (see LICENSE)
 * @link https://github.com/tecnickcom/tc-lib-pdf
 *
 * This file is part of tc-lib-pdf software library.
 */

// NOTE: local file reads (images, fonts, attachments) are restricted to an allowlist of
// trusted paths that covers this package tree, so run the examples in place. To read assets
// from other locations, list them in the 'allowedPaths' entry of the fileOptions constructor
// parameter (see E047_remote_resources_security.php).

// NOTE: run make fonts in the project root to generate the dependencies and example fonts.

// autoloader when using Composer
require __DIR__ . '/../vendor/autoload.php';

// define fonts directory
\define('K_PATH_FONTS', \realpath(__DIR__ . '/../vendor/tecnickcom/tc-lib-pdf-font/target/fonts'));

$pdf = new \Com\Tecnick\Pdf\Tcpdf(
 unit: \Com\Tecnick\Pdf\Page\Unit::Millimeter,
 isunicode: true,
 subsetfont: false,
 compress: true,
 mode: \Com\Tecnick\Pdf\PdfConformance::None,
 objEncrypt: null,
);

$pdf->setCreator('tc-lib-pdf');
$pdf->setAuthor('Nicola Asuni');
$pdf->setSubject('tc-lib-pdf example: 024');
$pdf->setTitle('CMYK, RGB and Grayscale colors');
$pdf->setKeywords('TCPDF tc-lib-pdf example cmyk rgb grayscale colors');
$pdf->setPDFFilename('024_colors.pdf');
$pdf->setViewerPreferences(['DisplayDocTitle' => true]);
$pdf->enableDefaultPageContent();

$fontFamily = 'helvetica';
$fontStyle = '';
$fontSize = 10;

$drawColorBlock = static function (
 \Com\Tecnick\Pdf\Tcpdf $pdf,
 float $x,
 float $y,
 float $w,
 float $h,
 string $label,
 string $strokeColor,
 string $fillColor,
 string $textColor,
): void {
 $style = [
 'all' => [
 'lineWidth' => 2.0,
 'lineCap' => 'square',
 'lineJoin' => 'miter',
 'dashArray' => [],
 'dashPhase' => 0,
 'lineColor' => $strokeColor,
 'fillColor' => $fillColor,
 ],
 ];

 $pdf->page->addContent($pdf->graph->getRect($x, $y, $w, $h, 'DF', $style));
 $pdf->page->addContent($pdf->color->getPdfColor($textColor));
 $pdf->page->addContent($pdf->getTextCell(
 $label,
 $x,
 $y + $h + 2.0,
 $w,
 6.0,
 valign: \Com\Tecnick\Pdf\TextVAlign::Top,
 halign: \Com\Tecnick\Pdf\TextHAlign::Left,
 drawcell: false,
 ));
};

// Insert the font once and reuse it across all pages.
$pdf->font->insert($pdf->pon, $fontFamily, $fontStyle, $fontSize, 0.0, 1.0);

$pdf->addPage();

$colorIntroHtml = '<h1>Color Example</h1>This page demonstrates core color support powered by <span style="color:#008800">tc-lib-color</span>. The library provides unified parsing and conversion for grayscale, RGB, CMYK, spot, and Lab color models so the same API can target both screen output and print-ready workflows. In this sample, color definitions are applied consistently to fills, strokes, and text to highlight how each model can be mixed in a single PDF document.';
$pdf->addHTMLCell(html: $colorIntroHtml, posx: 15, posy: 28, width: 180);

$posy = 100;

$drawColorBlock($pdf, 30.0, $posy, 30.0, 30.0, 'Cyan', 'cmyk(50,0,0,0)', 'cmyk(100,0,0,0)', 'cmyk(100,0,0,0)');
$drawColorBlock($pdf, 70.0, $posy, 30.0, 30.0, 'Magenta', 'cmyk(0,50,0,0)', 'cmyk(0,100,0,0)', 'cmyk(0,100,0,0)');
$drawColorBlock($pdf, 110.0, $posy, 30.0, 30.0, 'Yellow', 'cmyk(0,0,50,0)', 'cmyk(0,0,100,0)', 'cmyk(0,0,100,0)');
$drawColorBlock($pdf, 150.0, $posy, 30.0, 30.0, 'Black', 'cmyk(0,0,0,50)', 'cmyk(0,0,0,100)', 'cmyk(0,0,0,100)');

$posy += 50;
$drawColorBlock($pdf, 30.0, $posy, 30.0, 30.0, 'Red', 'rgb(255,127,127)', 'rgb(255,0,0)', 'rgb(255,0,0)');
$drawColorBlock($pdf, 70.0, $posy, 30.0, 30.0, 'Green', 'rgb(127,255,127)', 'rgb(0,255,0)', 'rgb(0,255,0)');
$drawColorBlock($pdf, 110.0, $posy, 30.0, 30.0, 'Blue', 'rgb(127,127,255)', 'rgb(0,0,255)', 'rgb(0,0,255)');

$posy += 50;
$drawColorBlock($pdf, 30.0, $posy, 30.0, 30.0, 'Gray', '#bfbfbf', '#7f7f7f', '#7f7f7f');

// ----------

$pdf->addPage();
$spotIntroHtml = '<h1>Example of Spot Colors</h1>Spot colors are single, pre-mixed inks, rather than colors produced by four (CMYK), six (CMYKOG), or more process inks during printing. They are usually supplied by specialized vendors, although many printers also use in-house formulations to match target shades.<br /><br />Because there is no universal open standard for spot colors, users typically rely on vendor color books and manually register both the spot color names and their CMYK equivalents.<br /><br />Common industry spot color systems include:<br /><span style="color:#008800">ANPA-COLOR, DIC, FOCOLTONE, GCMI, HKS, PANTONE, TOYO, TRUMATCH</span>.';
$pdf->addHTMLCell(html: $spotIntroHtml, posx: 15, posy: 28, width: 180);

$pdf->color->addSpotColor('My TCPDF Dark Green', new \Com\Tecnick\Color\Model\Cmyk([
 'cyan' => 1.0,
 'magenta' => 0.5,
 'yellow' => 0.8,
 'key' => 0.45,
 'alpha' => 0.0,
]));
$pdf->color->addSpotColor('My TCPDF Light Yellow', new \Com\Tecnick\Color\Model\Cmyk([
 'cyan' => 0.0,
 'magenta' => 0.0,
 'yellow' => 0.55,
 'key' => 0.0,
 'alpha' => 0.0,
]));
$pdf->color->addSpotColor('My TCPDF Black', new \Com\Tecnick\Color\Model\Cmyk([
 'cyan' => 0.0,
 'magenta' => 0.0,
 'yellow' => 0.0,
 'key' => 1.0,
 'alpha' => 0.0,
]));
$pdf->color->addSpotColor('My TCPDF Red', new \Com\Tecnick\Color\Model\Cmyk([
 'cyan' => 0.3,
 'magenta' => 1.0,
 'yellow' => 0.9,
 'key' => 0.1,
 'alpha' => 0.0,
]));
$pdf->color->addSpotColor('My TCPDF Green', new \Com\Tecnick\Color\Model\Cmyk([
 'cyan' => 1.0,
 'magenta' => 0.3,
 'yellow' => 1.0,
 'key' => 0.0,
 'alpha' => 0.0,
]));
$pdf->color->addSpotColor('My TCPDF Blue', new \Com\Tecnick\Color\Model\Cmyk([
 'cyan' => 1.0,
 'magenta' => 0.6,
 'yellow' => 0.1,
 'key' => 0.05,
 'alpha' => 0.0,
]));
$pdf->color->addSpotColor('My TCPDF Yellow', new \Com\Tecnick\Color\Model\Cmyk([
 'cyan' => 0.0,
 'magenta' => 0.2,
 'yellow' => 1.0,
 'key' => 0.0,
 'alpha' => 0.0,
]));

$drawSpotColorBlock = static function (
 \Com\Tecnick\Pdf\Tcpdf $pdf,
 float $x,
 float $y,
 float $w,
 float $h,
 string $spotName,
 float $tint,
): void {
 $pdf->page->addContent($pdf->color->getPdfColor($spotName, true, $tint));
 $pdf->page->addContent($pdf->color->getPdfColor($spotName, false, $tint));
 $pdf->page->addContent($pdf->graph->getRect($x, $y, $w, $h, 'DF'));

 $pdf->page->addContent($pdf->color->getPdfColor('My TCPDF Black', false, 1.0));
 $pdf->page->addContent($pdf->getTextCell(
 $spotName,
 $x + $w + 3.0,
 $y + 6.0,
 110.0,
 8.0,
 valign: \Com\Tecnick\Pdf\TextVAlign::Top,
 halign: \Com\Tecnick\Pdf\TextHAlign::Left,
 drawcell: false,
 ));
};

$spots = [
 'My TCPDF Dark Green',
 'My TCPDF Light Yellow',
 'My TCPDF Red',
 'My TCPDF Green',
 'My TCPDF Blue',
 'My TCPDF Yellow',
];

$startY = 90.0;
foreach ($spots as $spot) {
 $drawSpotColorBlock($pdf, 30.0, $startY, 40.0, 16.0, $spot, 1.0);
 $startY += 24.0;
}

// ----------

$pdf->addPage();
$labIntroHtml = '<h1>Example of Lab Spot Colors</h1>Lab-based spot colors define color values using CIE L*a*b* coordinates, which are device-independent and better suited for consistent cross-device color reproduction.<br /><br />The following sample spot colors are registered using <span style="color:#008800">addSpotLabColor()</span> and then rendered with standard spot-color drawing commands.';
$pdf->addHTMLCell(html: $labIntroHtml, posx: 15, posy: 28, width: 180);

$pdf->color->addSpotLabColor('My TCPDF Lab Red', 53.0, 80.0, 67.0);
$pdf->color->addSpotLabColor('My TCPDF Lab Green', 87.0, -86.0, 83.0);
$pdf->color->addSpotLabColor('My TCPDF Lab Blue', 32.0, 79.0, -108.0);
$pdf->color->addSpotLabColor('My TCPDF Lab Orange', 74.0, 24.0, 78.0);
$pdf->color->addSpotLabColor('My TCPDF Lab Violet', 40.0, 60.0, -55.0);
$pdf->color->addSpotLabColor('My TCPDF Lab Gray', 55.0, 0.0, 0.0);

// Advanced Lab spot example: custom whitepoint/blackpoint (D50 with non-zero blackpoint).
$pdf->color->addSpotLabColor(
 'My TCPDF Lab D50 Orange',
 64.25,
 58.5,
 71.2,
 [0.9642, 1.0000, 0.8251],
 [0.0120, 0.0125, 0.0110],
);

// Advanced Lab spot example: constrained a*/b* range and explicit Tint=0 Lab endpoint (col0).
$pdf->color->addSpotLabColor(
 'My TCPDF Lab Narrow Blue',
 36.0,
 62.0,
 -76.0,
 [0.9505, 1.0000, 1.0890],
 [0.0, 0.0, 0.0],
 [-96.0, 96.0, -96.0, 96.0],
 [92.0, -4.0, -8.0],
);

$labSpots = [
 ['My TCPDF Lab Red', 1.0],
 ['My TCPDF Lab Green', 1.0],
 ['My TCPDF Lab Blue', 1.0],
 ['My TCPDF Lab Orange', 0.9],
 ['My TCPDF Lab Violet', 0.85],
 ['My TCPDF Lab Gray', 1.0],
 ['My TCPDF Lab D50 Orange', 1.0],
 ['My TCPDF Lab Narrow Blue', 1.0],
];

$startY = 70.0;
foreach ($labSpots as [$spot, $tint]) {
 $drawSpotColorBlock($pdf, 30.0, $startY, 40.0, 16.0, $spot, $tint);
 $startY += 24.0;
}

// ----------

$rawpdf = $pdf->getOutPDFString();
$pdf->renderPDF(rawpdf: $rawpdf);

Example E025 : transparency

Sun, 26 Apr 2026 00:00:00 +0000

Constant alpha and the 16 PDF blend modes, applied through ExtGState objects.

Rendered PDF: E025_transparency.pdf
PHP source: E025_transparency.phps
All examples: /examples/
Category: Vector Graphics

PDF

Source Code

<?php

declare(strict_types=1);

/**
 * E025_transparency.php
 *
 * @since 2026-04-26
 * @category Library
 * @package Pdf
 * @author Nicola Asuni <info@tecnick.com>
 * @copyright 2002-2026 Nicola Asuni - Tecnick.com LTD
 * @license https://www.gnu.org/copyleft/lesser.html GNU-LGPL v3 (see LICENSE)
 * @link https://github.com/tecnickcom/tc-lib-pdf
 *
 * This file is part of tc-lib-pdf software library.
 */

// NOTE: local file reads (images, fonts, attachments) are restricted to an allowlist of
// trusted paths that covers this package tree, so run the examples in place. To read assets
// from other locations, list them in the 'allowedPaths' entry of the fileOptions constructor
// parameter (see E047_remote_resources_security.php).

// NOTE: run make fonts in the project root to generate the dependencies and example fonts.

// autoloader when using Composer
require __DIR__ . '/../vendor/autoload.php';

// define fonts directory
\define('K_PATH_FONTS', \realpath(__DIR__ . '/../vendor/tecnickcom/tc-lib-pdf-font/target/fonts'));

$pdf = new \Com\Tecnick\Pdf\Tcpdf(
 unit: \Com\Tecnick\Pdf\Page\Unit::Millimeter,
 isunicode: true,
 subsetfont: false,
 compress: true,
 mode: \Com\Tecnick\Pdf\PdfConformance::None,
 objEncrypt: null,
);

$pdf->setCreator('tc-lib-pdf');
$pdf->setAuthor('Nicola Asuni');
$pdf->setSubject('tc-lib-pdf example: 025');
$pdf->setTitle('Object transparency');
$pdf->setKeywords('TCPDF tc-lib-pdf example object transparency alpha extgstate');
$pdf->setPDFFilename('025_transparency.pdf');
$pdf->setViewerPreferences(['DisplayDocTitle' => true]);
$pdf->enableDefaultPageContent();

$setFont = static function (\Com\Tecnick\Pdf\Tcpdf $pdf, string $family, string $style, int $size): array {
 $font = $pdf->font->insert($pdf->pon, $family, $style, $size, 0.0, 1.0);
 $pdf->page->addContent($font['out']);
 return $font;
};

$getRectStyle = static fn(string $strokeColor, string $fillColor): array => [
 'all' => [
 'lineWidth' => 2.0,
 'lineCap' => 'square',
 'lineJoin' => 'miter',
 'dashArray' => [],
 'dashPhase' => 0,
 'lineColor' => $strokeColor,
 'fillColor' => $fillColor,
 ],
];

// Insert one neutral font before addPage() so page context has a valid current font.
$pdf->font->insert($pdf->pon, 'helvetica', '', 10, 0.0, 1.0);

$page = $pdf->addPage();

$setFont($pdf, 'helvetica', '', 12);
$pdf->page->addContent($pdf->getTextCell(
 'You can set the transparency of PDF objects using graph->getAlpha().',
 15,
 20,
 180,
 0,
 valign: \Com\Tecnick\Pdf\TextVAlign::Top,
 halign: \Com\Tecnick\Pdf\TextHAlign::Left,
 drawcell: false,
));

// Opaque red square.
$pdf->page->addContent($pdf->graph->getRect(
 30.0,
 40.0,
 60.0,
 60.0,
 'DF',
 $getRectStyle('rgb(127,0,0)', 'rgb(255,0,0)'),
));

// Semi-transparent objects.
$pdf->page->addContent($pdf->graph->getAlpha(0.5));

$pdf->page->addContent($pdf->graph->getRect(
 50.0,
 60.0,
 60.0,
 60.0,
 'DF',
 $getRectStyle('rgb(0,127,0)', 'rgb(0,255,0)'),
));

$pdf->page->addContent($pdf->graph->getRect(
 70.0,
 80.0,
 60.0,
 60.0,
 'DF',
 $getRectStyle('rgb(0,0,127)', 'rgb(0,0,255)'),
));

$imagePath = __DIR__ . '/images/tcpdf_logo.jpg';
if (\is_file($imagePath)) {
 $imageId = $pdf->image->add($imagePath);
 $pdf->page->addContent($pdf->image->getSetImage($imageId, 90.0, 100.0, 60.0, 60.0, $page['height']));
}

// Restore full opacity.
$pdf->page->addContent($pdf->graph->getAlpha(1.0));

$rawpdf = $pdf->getOutPDFString();
$pdf->renderPDF(rawpdf: $rawpdf);

Example E026 : text rendering modes

Sun, 26 Apr 2026 00:00:00 +0000

The text rendering modes: fill, stroke, fill and stroke, invisible, and the clipping variants.

Rendered PDF: E026_text_rendering_modes.pdf
PHP source: E026_text_rendering_modes.phps
All examples: /examples/
Category: Text and Typography

PDF

Source Code

<?php

declare(strict_types=1);

/**
 * E026_text_rendering_modes.php
 *
 * @since 2026-04-26
 * @category Library
 * @package Pdf
 * @author Nicola Asuni <info@tecnick.com>
 * @copyright 2002-2026 Nicola Asuni - Tecnick.com LTD
 * @license https://www.gnu.org/copyleft/lesser.html GNU-LGPL v3 (see LICENSE)
 * @link https://github.com/tecnickcom/tc-lib-pdf
 *
 * This file is part of tc-lib-pdf software library.
 */

// NOTE: local file reads (images, fonts, attachments) are restricted to an allowlist of
// trusted paths that covers this package tree, so run the examples in place. To read assets
// from other locations, list them in the 'allowedPaths' entry of the fileOptions constructor
// parameter (see E047_remote_resources_security.php).

// NOTE: run make fonts in the project root to generate the dependencies and example fonts.

// autoloader when using Composer
require __DIR__ . '/../vendor/autoload.php';

// define fonts directory
\define('K_PATH_FONTS', \realpath(__DIR__ . '/../vendor/tecnickcom/tc-lib-pdf-font/target/fonts'));

$pdf = new \Com\Tecnick\Pdf\Tcpdf(
 unit: \Com\Tecnick\Pdf\Page\Unit::Millimeter,
 isunicode: true,
 subsetfont: false,
 compress: true,
 mode: \Com\Tecnick\Pdf\PdfConformance::None,
 objEncrypt: null,
);

$pdf->setCreator('tc-lib-pdf');
$pdf->setAuthor('Nicola Asuni');
$pdf->setSubject('tc-lib-pdf example: 026');
$pdf->setTitle('Text rendering modes and clipping');
$pdf->setKeywords('TCPDF tc-lib-pdf example text rendering mode clipping stroke fill');
$pdf->setPDFFilename('026_text_rendering_modes.pdf');
$pdf->setViewerPreferences(['DisplayDocTitle' => true]);
$pdf->enableDefaultPageContent();

$setFont = static function (\Com\Tecnick\Pdf\Tcpdf $pdf, string $family, string $style, int $size): array {
 $font = $pdf->font->insert($pdf->pon, $family, $style, $size, 0.0, 1.0);
 $pdf->page->addContent($font['out']);
 return $font;
};

$drawTextModeLine = static function (
 \Com\Tecnick\Pdf\Tcpdf $pdf,
 string $text,
 float $y,
 float $strokeWidth,
 bool $fill,
 bool $stroke,
 bool $clip,
 int $imageId,
 float $pageHeight,
): void {
 if ($clip) {
 $pdf->page->addContent($pdf->graph->getStartTransform());
 }

 $pdf->page->addContent($pdf->getTextCell(
 $text,
 15.0,
 $y,
 180.0,
 0.0,
 strokewidth: $strokeWidth,
 fill: $fill,
 stroke: $stroke,
 clip: $clip,
 drawcell: false,
 valign: \Com\Tecnick\Pdf\TextVAlign::Top,
 halign: \Com\Tecnick\Pdf\TextHAlign::Left,
 ));

 if ($clip && $imageId > 0) {
 $pdf->page->addContent($pdf->image->getSetImage($imageId, 15.0, $y + 2.0, 170.0, 10.0, $pageHeight));
 $pdf->page->addContent($pdf->graph->getStopTransform());
 }
};

// Insert one neutral font before addPage() so page context has a valid current font.
$pdf->font->insert($pdf->pon, 'helvetica', '', 10, 0.0, 1.0);

$page = $pdf->addPage();

$setFont($pdf, 'helvetica', '', 11);
$pdf->page->addContent($pdf->getTextCell(
 'Text rendering modes: fill, stroke, fill+stroke, invisible, and clipping.',
 15.0,
 20.0,
 180.0,
 0.0,
 drawcell: false,
 valign: \Com\Tecnick\Pdf\TextVAlign::Top,
 halign: \Com\Tecnick\Pdf\TextHAlign::Left,
));

$setFont($pdf, 'helvetica', '', 22);

$pdf->page->addContent($pdf->color->getPdfColor('black', false));
$pdf->page->addContent($pdf->color->getPdfColor('rgb(255,0,0)', true));

$drawTextModeLine($pdf, 'Fill text', 35.0, 0.0, true, false, false, 0, $page['height']);
$drawTextModeLine($pdf, 'Stroke text', 47.0, 0.2, false, true, false, 0, $page['height']);
$drawTextModeLine($pdf, 'Fill, then stroke text', 59.0, 0.2, true, true, false, 0, $page['height']);
$drawTextModeLine($pdf, 'Neither fill nor stroke text (invisible)', 71.0, 0.0, false, false, false, 0, $page['height']);

$imagePath = __DIR__ . '/images/tcpdf_logo.jpg';
$imageId = 0;
if (\is_file($imagePath)) {
 $imageId = $pdf->image->add($imagePath);
}

$drawTextModeLine(
 $pdf,
 'Fill text and add to path for clipping',
 95.0,
 0.0,
 true,
 false,
 true,
 $imageId,
 $page['height'],
);
$drawTextModeLine(
 $pdf,
 'Stroke text and add to path for clipping',
 107.0,
 0.3,
 false,
 true,
 true,
 $imageId,
 $page['height'],
);
$drawTextModeLine(
 $pdf,
 'Fill, then stroke text and add to path for clipping',
 119.0,
 0.3,
 true,
 true,
 true,
 $imageId,
 $page['height'],
);
$drawTextModeLine($pdf, 'Add text to path for clipping', 131.0, 0.0, false, false, true, $imageId, $page['height']);

$rawpdf = $pdf->getOutPDFString();
$pdf->renderPDF(rawpdf: $rawpdf);

Example E027 : annotations

Sun, 26 Apr 2026 00:00:00 +0000

Every supported annotation subtype, one per block, with its appearance.

Rendered PDF: E027_annotations.pdf
PHP source: E027_annotations.phps
All examples: /examples/
Category: Interactive Documents

PDF

Source Code

<?php

declare(strict_types=1);

/**
 * E027_annotations.php
 *
 * Demonstrates all currently supported annotation subtypes.
 *
 * @since 2026-04-27
 * @category Library
 * @package Pdf
 * @author Nicola Asuni <info@tecnick.com>
 * @copyright 2002-2026 Nicola Asuni - Tecnick.com LTD
 * @license https://www.gnu.org/copyleft/lesser.html GNU-LGPL v3 (see LICENSE)
 * @link https://github.com/tecnickcom/tc-lib-pdf
 *
 * This file is part of tc-lib-pdf software library.
 */

// NOTE: local file reads (images, fonts, attachments) are restricted to an allowlist of
// trusted paths that covers this package tree, so run the examples in place. To read assets
// from other locations, list them in the 'allowedPaths' entry of the fileOptions constructor
// parameter (see E047_remote_resources_security.php).

// NOTE: run make fonts in the project root to generate the dependencies and example fonts.

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

define('K_PATH_FONTS', (string) realpath(__DIR__ . '/../vendor/tecnickcom/tc-lib-pdf-font/target/fonts'));

$pdf = new \Com\Tecnick\Pdf\Tcpdf(
 unit: \Com\Tecnick\Pdf\Page\Unit::Millimeter,
 isunicode: true,
 subsetfont: false,
 compress: true,
 mode: \Com\Tecnick\Pdf\PdfConformance::None,
 objEncrypt: null,
);

$pdf->setCreator('tc-lib-pdf');
$pdf->setAuthor('Nicola Asuni');
$pdf->setSubject('tc-lib-pdf example: 027');
$pdf->setTitle('All Supported Annotation Types');
$pdf->setKeywords('TCPDF tc-lib-pdf example annotation all subtypes');
$pdf->setPDFFilename('027_annotations.pdf');
$pdf->setViewerPreferences(['DisplayDocTitle' => true]);
$pdf->enableDefaultPageContent();

$setFont = static function (\Com\Tecnick\Pdf\Tcpdf $pdf, string $family, string $style, int $size): void {
 $font = $pdf->font->insert($pdf->pon, $family, $style, $size, 0.0, 1.0);
 $pdf->page->addContent($font['out']);
};

$pdf->font->insert($pdf->pon, 'helvetica', '', 12, 0.0, 1.0);

$leftMargin = 20.0;
$annX = 108.0;
$annW = 40.0;
$rowH = 10.0;

$convertTopToPdfCoordinates = static function (array $coords, float $pageHeight): array {
 $out = [];
 foreach ($coords as $idx => $val) {
 if (!is_numeric($val)) {
 continue;
 }

 $num = (float) $val;
 if (($idx % 2) === 1) {
 $num = $pageHeight - $num;
 }

 $out[] = $num;
 }

 return $out;
};

$normalizeAnnotationOptionCoordinates = static function (array $opt, float $pageHeight) use (
 $convertTopToPdfCoordinates,
): array {
 $subtype = strtolower((string) ($opt['subtype'] ?? ''));

 if ($subtype === 'line' && isset($opt['l']) && is_array($opt['l'])) {
 $opt['l'] = $convertTopToPdfCoordinates($opt['l'], $pageHeight);
 }

 if (in_array($subtype, ['polygon', 'polyline'], true) && isset($opt['vertices']) && is_array($opt['vertices'])) {
 $opt['vertices'] = $convertTopToPdfCoordinates($opt['vertices'], $pageHeight);
 }

 if (in_array($subtype, ['highlight', 'underline', 'squiggly', 'strikeout', 'redact'], true)) {
 if (isset($opt['quadpoints']) && is_array($opt['quadpoints'])) {
 $quadOut = [];
 foreach ($opt['quadpoints'] as $quad) {
 if (!is_array($quad)) {
 continue;
 }

 $quadOut[] = $convertTopToPdfCoordinates($quad, $pageHeight);
 }

 $opt['quadpoints'] = $quadOut;
 }
 }

 if ($subtype === 'ink' && isset($opt['inklist']) && is_array($opt['inklist'])) {
 $inkOut = [];
 foreach ($opt['inklist'] as $line) {
 if (!is_array($line)) {
 continue;
 }

 $inkOut[] = $convertTopToPdfCoordinates($line, $pageHeight);
 }

 $opt['inklist'] = $inkOut;
 }

 return $opt;
};

$addRow = static function (
 \Com\Tecnick\Pdf\Tcpdf $pdf,
 string $label,
 float $y,
 string $txt,
 array $opt,
 float $pageHeight,
 string $preview = '',
) use ($leftMargin, $annX, $annW, $rowH, $normalizeAnnotationOptionCoordinates): int {
 $x = $leftMargin;
 $labelW = $annX - $x - 1.0;

 $pdf->page->addContent($pdf->getTextCell(
 $label,
 $x,
 $y,
 $labelW,
 $rowH,
 drawcell: true,
 valign: \Com\Tecnick\Pdf\TextVAlign::Center,
 halign: \Com\Tecnick\Pdf\TextHAlign::Left,
 ));

 $pdf->page->addContent($pdf->getTextCell(
 '',
 $annX,
 $y,
 $annW,
 $rowH,
 drawcell: true,
 valign: \Com\Tecnick\Pdf\TextVAlign::Center,
 halign: \Com\Tecnick\Pdf\TextHAlign::Left,
 ));

 if ($preview !== '') {
 $pdf->page->addContent($pdf->getTextCell(
 $preview,
 $annX + 0.4,
 $y + 0.3,
 $annW - 0.8,
 $rowH - 0.6,
 drawcell: false,
 valign: \Com\Tecnick\Pdf\TextVAlign::Center,
 halign: \Com\Tecnick\Pdf\TextHAlign::Center,
 ));
 }

 $aid = $pdf->setAnnotation(
 posx: $annX,
 posy: $y,
 width: $annW,
 height: $rowH,
 txt: $txt,
 opt: $normalizeAnnotationOptionCoordinates($opt, $pageHeight),
 );
 $pdf->page->addAnnotRef($aid);

 return $aid;
};

$mkQuadPoints = static fn(float $x, float $y, float $w, float $h): array => [[
 $x,
 $y + $h,
 $x + $w,
 $y + $h,
 $x,
 $y,
 $x + $w,
 $y,
]];

$attachmentPath = __DIR__ . '/data/utf8test.txt';
$soundPath = __DIR__ . '/data/utf8test.txt';

$page1 = $pdf->addPage();
$setFont($pdf, 'helvetica', 'B', 16);
$pdf->page->addContent($pdf->getTextCell(
 'All Supported Annotation Types (page 1/2)',
 $leftMargin,
 10,
 190,
 9,
 drawcell: false,
 valign: \Com\Tecnick\Pdf\TextVAlign::Top,
 halign: \Com\Tecnick\Pdf\TextHAlign::Left,
));
$setFont($pdf, 'helvetica', '', 10);

$y = 22.0;
$textAnnotId = $addRow(
 $pdf,
 'Text',
 $y,
 "Text note body\nwith two lines",
 ['subtype' => 'Text', 'name' => 'Comment', 't' => 'Text note'],
 $page1['height'],
);
$y += 10.0;

$addRow(
 $pdf,
 'Link (URI)',
 $y,
 'https://github.com/tecnickcom/tc-lib-pdf',
 ['subtype' => 'Link', 'h' => 'I'],
 $page1['height'],
 'Open URL',
);
$y += 10.0;

$addRow(
 $pdf,
 'FreeText',
 $y,
 'FreeText content',
 ['subtype' => 'FreeText', 'da' => '/F1 10 Tf', 'q' => 1, 'it' => 'FreeTextTypeWriter'],
 $page1['height'],
);
$y += 10.0;

$addRow(
 $pdf,
 'Line',
 $y,
 'Line annotation',
 [
 'subtype' => 'Line',
 'l' => [$annX + 1.0, $y + ($rowH - 1.0), $annX + $annW - 1.0, $y + 1.0],
 'le' => ['OpenArrow', 'ClosedArrow'],
 'cap' => true,
 'it' => 'LineDimension',
 ],
 $page1['height'],
);
$y += 10.0;

$addRow($pdf, 'Square', $y, 'Square annotation', ['subtype' => 'Square', 'ic' => [0.9, 0.9, 0.5]], $page1['height']);
$y += 10.0;

$addRow($pdf, 'Circle', $y, 'Circle annotation', ['subtype' => 'Circle', 'ic' => [0.7, 0.9, 1.0]], $page1['height']);
$y += 10.0;

$addRow(
 $pdf,
 'Polygon',
 $y,
 'Polygon annotation',
 [
 'subtype' => 'Polygon',
 'vertices' => [
 $annX,
 $y + ($rowH - 2.0),
 $annX + 14.0,
 $y + 1.5,
 $annX + 28.0,
 $y + ($rowH - 2.0),
 $annX + $annW,
 $y + 1.5,
 ],
 ],
 $page1['height'],
);
$y += 10.0;

$addRow(
 $pdf,
 'Polyline',
 $y,
 'Polyline annotation',
 [
 'subtype' => 'Polyline',
 'vertices' => [
 $annX,
 $y + 1.5,
 $annX + 12.0,
 $y + ($rowH - 2.0),
 $annX + 24.0,
 $y + 1.5,
 $annX + $annW,
 $y + ($rowH - 2.0),
 ],
 'le' => ['Circle', 'Slash'],
 ],
 $page1['height'],
);
$y += 10.0;

$qp1 = $mkQuadPoints($annX, $y, $annW, $rowH);
$addRow(
 $pdf,
 'Highlight',
 $y,
 'Highlight annotation',
 ['subtype' => 'Highlight', 'quadpoints' => $qp1],
 $page1['height'],
 'Sample text',
);
$y += 10.0;

$qp2 = $mkQuadPoints($annX, $y, $annW, $rowH);
$addRow(
 $pdf,
 'Underline',
 $y,
 'Underline annotation',
 ['subtype' => 'Underline', 'quadpoints' => $qp2],
 $page1['height'],
 'Sample text',
);
$y += 10.0;

$qp3 = $mkQuadPoints($annX, $y, $annW, $rowH);
$addRow(
 $pdf,
 'Squiggly',
 $y,
 'Squiggly annotation',
 ['subtype' => 'Squiggly', 'quadpoints' => $qp3],
 $page1['height'],
 'Sample text',
);
$y += 10.0;

$qp4 = $mkQuadPoints($annX, $y, $annW, $rowH);
$addRow(
 $pdf,
 'StrikeOut',
 $y,
 'StrikeOut annotation',
 ['subtype' => 'StrikeOut', 'quadpoints' => $qp4],
 $page1['height'],
 'Sample text',
);
$y += 10.0;

$addRow($pdf, 'Stamp', $y, 'Stamp annotation', ['subtype' => 'Stamp', 'name' => 'Approved'], $page1['height']);
$y += 10.0;

$addRow($pdf, 'Caret', $y, 'Caret annotation', ['subtype' => 'Caret', 'sy' => 'P'], $page1['height']);
$y += 10.0;

$addRow(
 $pdf,
 'Ink',
 $y,
 'Ink annotation',
 [
 'subtype' => 'Ink',
 'inklist' => [[
 $annX,
 $y + ($rowH - 2.0),
 $annX + 14.0,
 $y + 2.0,
 $annX + 28.0,
 $y + ($rowH - 2.0),
 $annX + $annW,
 $y + 2.5,
 ]],
 ],
 $page1['height'],
);
$y += 10.0;

$addRow(
 $pdf,
 'Popup (parent: Text)',
 $y,
 'Popup annotation',
 ['subtype' => 'Popup', 'parent' => ['n' => $textAnnotId], 'open' => false],
 $page1['height'],
 'Popup target',
);
$y += 10.0;

if (is_file($attachmentPath)) {
 $addRow(
 $pdf,
 'FileAttachment',
 $y,
 'Attached file',
 ['subtype' => 'FileAttachment', 'name' => 'PushPin', 'fs' => $attachmentPath],
 $page1['height'],
 );
} else {
 $pdf->page->addContent($pdf->getTextCell(
 txt: 'FileAttachment skipped: missing examples/data/utf8test.txt',
 posx: $leftMargin,
 posy: $y,
 width: 190,
 height: 7,
 ));
}

$page2 = $pdf->addPage();
$setFont($pdf, 'helvetica', 'B', 16);
$pdf->page->addContent($pdf->getTextCell(
 'All Supported Annotation Types (page 2/2)',
 $leftMargin,
 10,
 190,
 9,
 drawcell: false,
 valign: \Com\Tecnick\Pdf\TextVAlign::Top,
 halign: \Com\Tecnick\Pdf\TextHAlign::Left,
));
$setFont($pdf, 'helvetica', '', 10);

$y = 22.0;

if (is_file($soundPath)) {
 $addRow(
 $pdf,
 'Sound',
 $y,
 'Sound payload',
 ['subtype' => 'Sound', 'name' => 'Speaker', 'fs' => $soundPath],
 $page2['height'],
 'Sound icon',
 );
} else {
 $pdf->page->addContent($pdf->getTextCell(
 txt: 'Sound skipped: missing examples/data/utf8test.txt',
 posx: $leftMargin,
 posy: $y,
 width: 190,
 height: 7,
 ));
}
$y += 10.0;

$addRow(
 $pdf,
 'Movie',
 $y,
 'Movie payload',
 [
 'subtype' => 'Movie',
 't' => 'Movie title',
 'movie' => ['f' => 'sample.mov', 'aspect' => [16.0, 9.0], 'poster' => true],
 'a' => ['showcontrols' => true, 'mode' => 'Repeat'],
 ],
 $page2['height'],
 'Movie action',
);
$y += 10.0;

$addRow(
 $pdf,
 'Screen',
 $y,
 'Screen payload',
 [
 'subtype' => 'Screen',
 't' => 'Screen title',
 'mk' => ['r' => 90, 'bc' => [0.1, 0.2, 0.3], 'tp' => 2],
 'a' => '/S /Named /N /NextPage',
 ],
 $page2['height'],
 'Screen action',
);
$y += 10.0;

$addRow(
 $pdf,
 'Widget',
 $y,
 'field-demo',
 [
 'subtype' => 'Widget',
 'h' => 'N',
 't' => 'demo_widget',
 'v' => 'abc',
 'da' => '/F1 10 Tf',
 'q' => 0,
 ],
 $page2['height'],
 'Widget field',
);
$y += 10.0;

$redactQuad = $mkQuadPoints($annX, $y, $annW, $rowH);
$addRow(
 $pdf,
 'Redact',
 $y,
 'Redact payload',
 [
 'subtype' => 'Redact',
 'quadpoints' => $redactQuad,
 'overlaytext' => 'REDACTED',
 'repeat' => true,
 'da' => '/F1 10 Tf',
 'q' => 1,
 ],
 $page2['height'],
 'Sample text',
);
$y += 10.0;

$addRow(
 $pdf,
 'Watermark',
 $y,
 'Watermark payload',
 [
 'subtype' => 'Watermark',
 'fixedprint' => [
 'type' => 'FixedPrint',
 'matrix' => [1.0, 0.0, 0.0, 1.0, 5.0, 5.0],
 'h' => 0.5,
 'v' => 0.5,
 ],
 ],
 $page2['height'],
);
$y += 12.0;

$pdf->page->addContent($pdf->getTextCell(
 'Notes: PrinterMark, TrapNet, and 3D are currently intentionally unsupported and are not included in this demo.',
 $leftMargin,
 $y,
 190,
 0,
 drawcell: false,
 valign: \Com\Tecnick\Pdf\TextVAlign::Top,
 halign: \Com\Tecnick\Pdf\TextHAlign::Left,
));

$rawpdf = $pdf->getOutPDFString();
$pdf->renderPDF(rawpdf: $rawpdf);

Example E028 : text hyphenation

Sun, 26 Apr 2026 00:00:00 +0000

Hyphenation in HTML content, from explicit soft hyphens and from the loaded pattern dictionary.

Rendered PDF: E028_text_hyphenation.pdf
PHP source: E028_text_hyphenation.phps
All examples: /examples/
Category: Text and Typography
Guide: HTML and CSS

PDF

Source Code

<?php

declare(strict_types=1);

/**
 * E028_text_hyphenation.php
 *
 * @since 2026-04-26
 * @category Library
 * @package Pdf
 * @author Nicola Asuni <info@tecnick.com>
 * @copyright 2002-2026 Nicola Asuni - Tecnick.com LTD
 * @license https://www.gnu.org/copyleft/lesser.html GNU-LGPL v3 (see LICENSE)
 * @link https://github.com/tecnickcom/tc-lib-pdf
 *
 * This file is part of tc-lib-pdf software library.
 */

// NOTE: local file reads (images, fonts, attachments) are restricted to an allowlist of
// trusted paths that covers this package tree, so run the examples in place. To read assets
// from other locations, list them in the 'allowedPaths' entry of the fileOptions constructor
// parameter (see E047_remote_resources_security.php).

// NOTE: run make fonts in the project root to generate the dependencies and example fonts.

// autoloader when using Composer
require __DIR__ . '/../vendor/autoload.php';

// define fonts directory
\define('K_PATH_FONTS', \realpath(__DIR__ . '/../vendor/tecnickcom/tc-lib-pdf-font/target/fonts'));

$pdf = new \Com\Tecnick\Pdf\Tcpdf(
 unit: \Com\Tecnick\Pdf\Page\Unit::Millimeter,
 isunicode: true,
 subsetfont: false,
 compress: true,
 mode: \Com\Tecnick\Pdf\PdfConformance::None,
 objEncrypt: null,
);

$pdf->setCreator('tc-lib-pdf');
$pdf->setAuthor('Nicola Asuni');
$pdf->setSubject('tc-lib-pdf example: 028');
$pdf->setTitle('Text hyphenation with soft hyphens');
$pdf->setKeywords('TCPDF tc-lib-pdf example text hyphenation soft hyphen shy html');
$pdf->setPDFFilename('028_text_hyphenation.pdf');
$pdf->setViewerPreferences(['DisplayDocTitle' => true]);
$pdf->enableDefaultPageContent();

$setFont = static function (\Com\Tecnick\Pdf\Tcpdf $pdf, string $family, string $style, int $size): void {
 $font = $pdf->font->insert($pdf->pon, $family, $style, $size, 0.0, 1.0);
 $pdf->page->addContent($font['out']);
};

// Insert one neutral font before addPage() so page context has a valid current font.
$pdf->font->insert($pdf->pon, 'helvetica', '', 10, 0.0, 1.0);

$pdf->addPage();

$setFont($pdf, 'helvetica', 'B', 20);
$pdf->page->addContent($pdf->getTextCell(
 'Example of Text Hyphenation',
 15.0,
 22.0,
 180.0,
 0.0,
 drawcell: false,
 valign: \Com\Tecnick\Pdf\TextVAlign::Top,
 halign: \Com\Tecnick\Pdf\TextHAlign::Left,
));

$setFont($pdf, 'helvetica', '', 10);
$pdf->page->addContent($pdf->getTextCell(
 'The text below uses explicit soft hyphens (&shy;) inside words and is rendered in a narrow left-aligned column.',
 15.0,
 34.0,
 180.0,
 0.0,
 drawcell: false,
 valign: \Com\Tecnick\Pdf\TextVAlign::Top,
 halign: \Com\Tecnick\Pdf\TextHAlign::Left,
));

$setFont($pdf, 'times', '', 10);

$html =
 '<div style="color:#003f7f;text-align:justify">'
 . 'On the other hand, we de&shy;nounce with righ&shy;teous in&shy;dig&shy;na&shy;tion '
 . 'and dis&shy;like men who are so be&shy;guiled and de&shy;mo&shy;r&shy;al&shy;ized by the charms '
 . 'of plea&shy;sure of the mo&shy;ment, so blind&shy;ed by de&shy;sire, that they can&shy;not fore&shy;see '
 . 'the pain and trou&shy;ble that are bound to en&shy;sue; and equal blame be&shy;longs to '
 . 'those who fail in their du&shy;ty through weak&shy;ness of will, which is the same as '
 . 'say&shy;ing through shrink&shy;ing from toil and pain. Th&shy;ese cas&shy;es are per&shy;fect&shy;ly '
 . 'sim&shy;ple and easy to distin&shy;guish. In a free hour, when our pow&shy;er of choice is '
 . 'un&shy;tram&shy;melled and when noth&shy;ing pre&shy;vents our be&shy;ing able to do what we like '
 . 'best, ev&shy;ery plea&shy;sure is to be wel&shy;comed and ev&shy;ery pain avoid&shy;ed. But in '
 . 'cer&shy;tain cir&shy;cum&shy;s&shy;tances and ow&shy;ing to the claims of du&shy;ty or the obli&shy;ga&shy;tions '
 . 'of busi&shy;ness it will fre&shy;quent&shy;ly oc&shy;cur that plea&shy;sures have to be '
 . 're&shy;pu&shy;di&shy;at&shy;ed and an&shy;noy&shy;ances ac&shy;cept&shy;ed. The wise man there&shy;fore al&shy;ways holds '
 . 'in th&shy;ese mat&shy;ters to this prin&shy;ci&shy;ple of se&shy;lec&shy;tion: he re&shy;jects plea&shy;sures to '
 . 'se&shy;cure other greater plea&shy;sures, or else he en&shy;dures pains to avoid worse pains.'
 . '</div>';

$cellBorderStyles = [
 'all' => [
 'lineWidth' => 0.2,
 'lineCap' => 'butt',
 'lineJoin' => 'miter',
 'dashArray' => [],
 'dashPhase' => 0,
 'lineColor' => 'red',
 'fillColor' => '',
 ],
];

$pdf->addHTMLCell(html: $html, posx: 15.0, posy: 45.0, width: 42.0, height: 0.0, cell: null, styles: $cellBorderStyles);

$rawpdf = $pdf->getOutPDFString();
$pdf->renderPDF(rawpdf: $rawpdf);

Example E029 : xobject template

Sun, 26 Apr 2026 00:00:00 +0000

Reusable Form XObject templates, defined once and placed several times, including under transparency and clipping.

Rendered PDF: E029_xobject_template.pdf
PHP source: E029_xobject_template.phps
All examples: /examples/
Category: Vector Graphics

PDF

Source Code

<?php

declare(strict_types=1);

/**
 * E029_xobject_template.php
 *
 * @since 2026-04-26
 * @category Library
 * @package Pdf
 * @author Nicola Asuni <info@tecnick.com>
 * @copyright 2002-2026 Nicola Asuni - Tecnick.com LTD
 * @license https://www.gnu.org/copyleft/lesser.html GNU-LGPL v3 (see LICENSE)
 * @link https://github.com/tecnickcom/tc-lib-pdf
 *
 * This file is part of tc-lib-pdf software library.
 */

// NOTE: local file reads (images, fonts, attachments) are restricted to an allowlist of
// trusted paths that covers this package tree, so run the examples in place. To read assets
// from other locations, list them in the 'allowedPaths' entry of the fileOptions constructor
// parameter (see E047_remote_resources_security.php).

// NOTE: run make fonts in the project root to generate the dependencies and example fonts.

// autoloader when using Composer
require __DIR__ . '/../vendor/autoload.php';

// define fonts directory
\define('K_PATH_FONTS', \realpath(__DIR__ . '/../vendor/tecnickcom/tc-lib-pdf-font/target/fonts'));

$pdf = new \Com\Tecnick\Pdf\Tcpdf(
 unit: \Com\Tecnick\Pdf\Page\Unit::Millimeter,
 isunicode: true,
 subsetfont: false,
 compress: true,
 mode: \Com\Tecnick\Pdf\PdfConformance::None,
 objEncrypt: null,
);

$pdf->setCreator('tc-lib-pdf');
$pdf->setAuthor('Nicola Asuni');
$pdf->setSubject('tc-lib-pdf example: 029');
$pdf->setTitle('XObject template');
$pdf->setKeywords('TCPDF tc-lib-pdf example xobject template transparency clipping');
$pdf->setPDFFilename('029_xobject_template.pdf');
$pdf->setViewerPreferences(['DisplayDocTitle' => true]);
$pdf->enableDefaultPageContent();

$setFont = static function (\Com\Tecnick\Pdf\Tcpdf $pdf, string $family, string $style, int $size): array {
 $font = $pdf->font->insert($pdf->pon, $family, $style, $size, 0.0, 1.0);
 $pdf->page->addContent($font['out']);
 return $font;
};

// Insert one neutral font before addPage() so page context has a valid current font.
$pdf->font->insert($pdf->pon, 'helvetica', '', 10, 0.0, 1.0);

$pdf->addPage();

$setFont($pdf, 'helvetica', 'B', 20);
$pdf->page->addContent($pdf->getTextCell(
 'XObject Templates',
 15.0,
 22.0,
 180.0,
 0.0,
 drawcell: false,
 valign: \Com\Tecnick\Pdf\TextVAlign::Top,
 halign: \Com\Tecnick\Pdf\TextHAlign::Center,
));

$setFont($pdf, 'helvetica', '', 10);
$pdf->page->addContent($pdf->getTextCell(
 'The same template object is rendered multiple times with different sizes and alpha values.',
 15.0,
 34.0,
 180.0,
 0.0,
 drawcell: false,
 valign: \Com\Tecnick\Pdf\TextVAlign::Top,
 halign: \Com\Tecnick\Pdf\TextHAlign::Left,
));

$templateWidth = 60.0;
$templateHeight = 60.0;
$templateGroup = ['CS' => 'DeviceRGB', 'I' => true, 'K' => false];
$templateId = $pdf->newXObjectTemplate($templateWidth, $templateHeight, $templateGroup);

$imageId = 0;
$imagePath = __DIR__ . '/images/tcpdf_logo.jpg';
if (\is_file($imagePath)) {
 $imageId = $pdf->image->add($imagePath);
 $pdf->addXObjectImageID($templateId, $imageId);
}

$templateContent = $pdf->graph->getStartTransform();
$templateContent .= $pdf->graph->getStarPolygon(30.0, 30.0, 29.0, 10, 3, 0.0, 'CNZ');
if ($imageId > 0) {
 $templateContent .= $pdf->image->getSetImage($imageId, 0.0, 0.0, $templateWidth, $templateHeight, $templateHeight);
}
$templateContent .= $pdf->graph->getStopTransform();

$templateFont = $pdf->font->insert($pdf->pon, 'times', 'B', 15, 0.0, 1.0);
$pdf->addXObjectFontID($templateId, $templateFont['key']);
$templateContent .= $templateFont['out'];
$templateContent .= $pdf->color->getPdfColor('rgb(255,0,0)', true);
$templateContent .= $pdf->getTextCell(
 'Template',
 0.0,
 22.0,
 $templateWidth,
 0.0,
 drawcell: false,
 valign: \Com\Tecnick\Pdf\TextVAlign::Top,
 halign: \Com\Tecnick\Pdf\TextHAlign::Center,
);

$pdf->addXObjectContent($templateId, $templateContent);
$pdf->exitXObjectTemplate();

$instances = [
 [0.4, 15.0, 50.0, 20.0],
 [0.6, 27.0, 62.0, 40.0],
 [0.8, 55.0, 85.0, 60.0],
 [1.0, 95.0, 125.0, 80.0],
];

foreach ($instances as [$alpha, $x, $y, $size]) {
 $pdf->page->addContent($pdf->graph->getAlpha((float) $alpha));
 $pdf->page->addContent($pdf->getXObjectTemplate($templateId, (float) $x, (float) $y, (float) $size, (float) $size));
}

$pdf->page->addContent($pdf->graph->getAlpha(1.0));

$rawpdf = $pdf->getOutPDFString();
$pdf->renderPDF(rawpdf: $rawpdf);

Example E030 : svg

Sun, 26 Apr 2026 00:00:00 +0000

SVG rendering: path parsing, markers, text anchoring, and style inheritance.

Rendered PDF: E030_svg.pdf
PHP source: E030_svg.phps
All examples: /examples/
Category: Vector Graphics

PDF

Source Code

<?php

declare(strict_types=1);

/**
 * E030_svg.php
 *
 * Dedicated SVG rendering example.
 *
 * Renders every SVG image file shipped in the examples/images/ directory.
 *
 * @since 2026-04-26
 * @category Library
 * @package Pdf
 * @author Nicola Asuni <info@tecnick.com>
 * @copyright 2002-2026 Nicola Asuni - Tecnick.com LTD
 * @license https://www.gnu.org/copyleft/lesser.html GNU-LGPL v3 (see LICENSE)
 * @link https://github.com/tecnickcom/tc-lib-pdf
 *
 * This file is part of tc-lib-pdf software library.
 */

// NOTE: local file reads (images, fonts, attachments) are restricted to an allowlist of
// trusted paths that covers this package tree, so run the examples in place. To read assets
// from other locations, list them in the 'allowedPaths' entry of the fileOptions constructor
// parameter (see E047_remote_resources_security.php).

// NOTE: run make fonts in the project root to generate the dependencies and example fonts.

// autoloader when using Composer
require __DIR__ . '/../vendor/autoload.php';

\define('OUTPUT_FILE', \realpath(__DIR__ . '/../target') . '/example_svg.pdf');

// define fonts directory
\define('K_PATH_FONTS', \realpath(__DIR__ . '/../vendor/tecnickcom/tc-lib-pdf-font/target/fonts'));

// autoloader when using RPM or DEB package installation
//require ('/usr/share/php/Com/Tecnick/Pdf/autoload.php');

// ---------------------------------------------------------------------------
// SVG directory
$svgdir = __DIR__ . '/images';

// ---------------------------------------------------------------------------
// PDF object

$pdf = new \Com\Tecnick\Pdf\Tcpdf(
 unit: \Com\Tecnick\Pdf\Page\Unit::Millimeter,
 isunicode: true,
 subsetfont: false,
 compress: true,
);

$pdf->setCreator('tc-lib-pdf');
$pdf->setAuthor('Nicola Asuni');
$pdf->setSubject('tc-lib-pdf example: 030 — SVG');
$pdf->setTitle('SVG Rendering Example');
$pdf->setKeywords('TCPDF tc-lib-pdf SVG example');
$pdf->setPDFFilename('030_svg.pdf');

$pdf->setViewerPreferences(['DisplayDocTitle' => true]);

$pdf->enableDefaultPageContent();

// Insert a font for page labels
$bfont = $pdf->font->insert($pdf->pon, 'helvetica', '', 10);

// ---------------------------------------------------------------------------
// Page 1 - tcpdf_box.svg
//
// A multi-path box illustration that exercises fill, stroke, fill-rule and
// transform handling.
// ---------------------------------------------------------------------------

$page01 = $pdf->addPage();
$pdf->setBookmark(name: 'tcpdf_box.svg', link: '', level: 0, page: -1, posx: 0, posy: 0, fstyle: 'B', color: 'blue');

$pdf->page->addContent($bfont['out']);

// Label
$pdf->addTextCell(
 txt: 'tcpdf_box.svg — paths, fill, stroke, fill-rule',
 pid: -1,
 posx: 10,
 posy: 10,
 width: 190,
 height: 6,
 offset: 0,
 linespace: 0,
 valign: \Com\Tecnick\Pdf\TextVAlign::Top,
 halign: \Com\Tecnick\Pdf\TextHAlign::Left,
 cell: null,
 styles: [],
 strokewidth: 0,
 wordspacing: 0,
 leading: 0,
 rise: 0,
 jlast: true,
 fill: true,
 stroke: false,
 underline: false,
 linethrough: false,
 overline: false,
 clip: false,
 drawcell: false,
);

// Render at two different sizes to check scaling
$svg01a = $pdf->addSVG(
 img: $svgdir . '/tcpdf_box.svg',
 posx: 10,
 posy: 20,
 width: 180,
 height: 120,
 pageheight: $page01['height'],
);
$pdf->page->addContent($pdf->getSetSVG(soid: $svg01a));

$svg01b = $pdf->addSVG(
 img: $svgdir . '/tcpdf_box.svg',
 posx: 10,
 posy: 148,
 width: 90,
 height: 60,
 pageheight: $page01['height'],
);
$pdf->page->addContent($pdf->getSetSVG(soid: $svg01b));

$svg01c = $pdf->addSVG(
 img: $svgdir . '/tcpdf_box.svg',
 posx: 105,
 posy: 148,
 width: 45,
 height: 30,
 pageheight: $page01['height'],
);
$pdf->page->addContent($pdf->getSetSVG(soid: $svg01c));

// ---------------------------------------------------------------------------
// Page 2 - testsvg.svg
//
// Exercises linear and radial gradients, clip-paths, complex paths, text and
// image embedding inside an SVG document.
// ---------------------------------------------------------------------------

$page02 = $pdf->addPage();
$pdf->setBookmark(name: 'testsvg.svg', link: '', level: 0, page: -1, posx: 0, posy: 0, fstyle: 'B', color: 'green');

$pdf->page->addContent($bfont['out']);

$pdf->addTextCell(
 txt: 'testsvg.svg — gradients, clip-paths, text, embedded image',
 pid: -1,
 posx: 10,
 posy: 10,
 width: 190,
 height: 6,
 offset: 0,
 linespace: 0,
 valign: \Com\Tecnick\Pdf\TextVAlign::Top,
 halign: \Com\Tecnick\Pdf\TextHAlign::Left,
 cell: null,
 styles: [],
 strokewidth: 0,
 wordspacing: 0,
 leading: 0,
 rise: 0,
 jlast: true,
 fill: true,
 stroke: false,
 underline: false,
 linethrough: false,
 overline: false,
 clip: false,
 drawcell: false,
);

// Full-width render
$svg02a = $pdf->addSVG(
 img: $svgdir . '/testsvg.svg',
 posx: 10,
 posy: 20,
 width: 190,
 height: 95,
 pageheight: $page02['height'],
);
$pdf->page->addContent($pdf->getSetSVG(soid: $svg02a));

// Smaller render to verify scaling
$svg02b = $pdf->addSVG(
 img: $svgdir . '/testsvg.svg',
 posx: 10,
 posy: 120,
 width: 95,
 height: 47,
 pageheight: $page02['height'],
);
$pdf->page->addContent($pdf->getSetSVG(soid: $svg02b));

$svg02c = $pdf->addSVG(
 img: $svgdir . '/testsvg.svg',
 posx: 110,
 posy: 120,
 width: 47,
 height: 23,
 pageheight: $page02['height'],
);
$pdf->page->addContent($pdf->getSetSVG(soid: $svg02c));

// ---------------------------------------------------------------------------
// Page 3 - testsvgblend.svg
//
// Exercises mix-blend-mode (multiply, screen, darken …) and opacity.
// ---------------------------------------------------------------------------

$page03 = $pdf->addPage();
$pdf->setBookmark(name: 'testsvgblend.svg', link: '', level: 0, page: -1, posx: 0, posy: 0, fstyle: 'B', color: 'red');

$pdf->page->addContent($bfont['out']);

$pdf->addTextCell(
 txt: 'testsvgblend.svg — blend modes, opacity',
 pid: -1,
 posx: 10,
 posy: 10,
 width: 190,
 height: 6,
 offset: 0,
 linespace: 0,
 valign: \Com\Tecnick\Pdf\TextVAlign::Top,
 halign: \Com\Tecnick\Pdf\TextHAlign::Left,
 cell: null,
 styles: [],
 strokewidth: 0,
 wordspacing: 0,
 leading: 0,
 rise: 0,
 jlast: true,
 fill: true,
 stroke: false,
 underline: false,
 linethrough: false,
 overline: false,
 clip: false,
 drawcell: false,
);

$svg03a = $pdf->addSVG(
 img: $svgdir . '/testsvgblend.svg',
 posx: 10,
 posy: 20,
 width: 190,
 height: 127,
 pageheight: $page03['height'],
);
$pdf->page->addContent($pdf->getSetSVG(soid: $svg03a));

// Side-by-side scaled copies
$svg03b = $pdf->addSVG(
 img: $svgdir . '/testsvgblend.svg',
 posx: 10,
 posy: 155,
 width: 90,
 height: 60,
 pageheight: $page03['height'],
);
$pdf->page->addContent($pdf->getSetSVG(soid: $svg03b));

$svg03c = $pdf->addSVG(
 img: $svgdir . '/testsvgblend.svg',
 posx: 105,
 posy: 155,
 width: 90,
 height: 60,
 pageheight: $page03['height'],
);
$pdf->page->addContent($pdf->getSetSVG(soid: $svg03c));

// ---------------------------------------------------------------------------
// Page 4 - tux.svg
//
// The Tux penguin - a complex multi-path SVG with fine detail and many style
// attributes (fill, stroke, stroke-width, opacity).
//
// Copyright: Larry Ewing - permits any use with proper attribution.
// ---------------------------------------------------------------------------

$page04 = $pdf->addPage();
$pdf->setBookmark(name: 'tux.svg', link: '', level: 0, page: -1, posx: 0, posy: 0, fstyle: 'B', color: 'black');

$pdf->page->addContent($bfont['out']);

$pdf->addTextCell(
 txt: 'tux.svg — complex multi-path illustration (The copyright holder of the Tux image is Larry Ewing)',
 pid: -1,
 posx: 10,
 posy: 10,
 width: 190,
 height: 6,
 offset: 0,
 linespace: 0,
 valign: \Com\Tecnick\Pdf\TextVAlign::Top,
 halign: \Com\Tecnick\Pdf\TextHAlign::Left,
 cell: null,
 styles: [],
 strokewidth: 0,
 wordspacing: 0,
 leading: 0,
 rise: 0,
 jlast: true,
 fill: true,
 stroke: false,
 underline: false,
 linethrough: false,
 overline: false,
 clip: false,
 drawcell: false,
);

// Large centred render
$svg04a = $pdf->addSVG(
 img: $svgdir . '/tux.svg',
 posx: 55,
 posy: 20,
 width: 100,
 height: 121,
 pageheight: $page04['height'],
);
$pdf->page->addContent($pdf->getSetSVG(soid: $svg04a));

// Three scaled thumbnails
$svg04b = $pdf->addSVG(
 img: $svgdir . '/tux.svg',
 posx: 10,
 posy: 148,
 width: 55,
 height: 66,
 pageheight: $page04['height'],
);
$pdf->page->addContent($pdf->getSetSVG(soid: $svg04b));

$svg04c = $pdf->addSVG(
 img: $svgdir . '/tux.svg',
 posx: 70,
 posy: 148,
 width: 40,
 height: 48,
 pageheight: $page04['height'],
);
$pdf->page->addContent($pdf->getSetSVG(soid: $svg04c));

$svg04d = $pdf->addSVG(
 img: $svgdir . '/tux.svg',
 posx: 115,
 posy: 148,
 width: 25,
 height: 30,
 pageheight: $page04['height'],
);
$pdf->page->addContent($pdf->getSetSVG(soid: $svg04d));

// ---------------------------------------------------------------------------
// Page 5 - all four images together (overview grid)
// ---------------------------------------------------------------------------

$page05 = $pdf->addPage();
$pdf->setBookmark(
 name: 'SVG overview grid',
 link: '',
 level: 0,
 page: -1,
 posx: 0,
 posy: 0,
 fstyle: 'B',
 color: 'purple',
);

$pdf->page->addContent($bfont['out']);

$pdf->addTextCell(
 txt: 'SVG overview grid — all four images at equal size',
 pid: -1,
 posx: 10,
 posy: 10,
 width: 190,
 height: 6,
 offset: 0,
 linespace: 0,
 valign: \Com\Tecnick\Pdf\TextVAlign::Top,
 halign: \Com\Tecnick\Pdf\TextHAlign::Left,
 cell: null,
 styles: [],
 strokewidth: 0,
 wordspacing: 0,
 leading: 0,
 rise: 0,
 jlast: true,
 fill: true,
 stroke: false,
 underline: false,
 linethrough: false,
 overline: false,
 clip: false,
 drawcell: false,
);

// Row 1
$s1 = $pdf->addSVG(
 img: $svgdir . '/tcpdf_box.svg',
 posx: 10,
 posy: 20,
 width: 90,
 height: 60,
 pageheight: $page05['height'],
);
$pdf->page->addContent($pdf->getSetSVG(soid: $s1));

$s2 = $pdf->addSVG(
 img: $svgdir . '/testsvg.svg',
 posx: 105,
 posy: 20,
 width: 90,
 height: 60,
 pageheight: $page05['height'],
);
$pdf->page->addContent($pdf->getSetSVG(soid: $s2));

// Row 2
$s3 = $pdf->addSVG(
 img: $svgdir . '/testsvgblend.svg',
 posx: 10,
 posy: 88,
 width: 90,
 height: 60,
 pageheight: $page05['height'],
);
$pdf->page->addContent($pdf->getSetSVG(soid: $s3));

$s4 = $pdf->addSVG(
 img: $svgdir . '/tux.svg',
 posx: 105,
 posy: 88,
 width: 90,
 height: 109,
 pageheight: $page05['height'],
);
$pdf->page->addContent($pdf->getSetSVG(soid: $s4));

// ---------------------------------------------------------------------------
// Page 6 - abstract_a4_features.svg (full-page portrait)
//
// Dedicated A4 portrait abstract composition that concentrates most SVG
// features currently supported by this library in one single visual sample.
// ---------------------------------------------------------------------------

$page06 = $pdf->addPage();
$pdf->setBookmark(
 name: 'abstract_a4_features.svg',
 link: '',
 level: 0,
 page: -1,
 posx: 0,
 posy: 0,
 fstyle: 'B',
 color: 'orange',
);

$svg06a = $pdf->addSVG(
 img: $svgdir . '/abstract_a4_features.svg',
 posx: 0,
 posy: 0,
 width: $page06['width'],
 height: $page06['height'],
 pageheight: $page06['height'],
);
$pdf->page->addContent($pdf->getSetSVG(soid: $svg06a));

// ---------------------------------------------------------------------------
// Page 7 - path_text_regressions.svg (full-page portrait)
//
// Sheet covering the path and text parsing rules: numbers with no leading
// digit, packed decimals, scientific notation,
// elliptical arc flags packed against their neighbours, the smooth curve
// commands 'S' and 'T', compound subpaths under both fill rules, text
// anchoring, XML white space handling and multi chunk text layout.
//
// Every shape is drawn twice, as a pale fill from a verbose path and as a dark
// outline from the compact equivalent: the outline must trace the fill exactly.
// ---------------------------------------------------------------------------

$page07 = $pdf->addPage();
$pdf->setBookmark(
 name: 'path_text_regressions.svg',
 link: '',
 level: 0,
 page: -1,
 posx: 0,
 posy: 0,
 fstyle: 'B',
 color: 'purple',
);

$svg07a = $pdf->addSVG(
 img: $svgdir . '/path_text_regressions.svg',
 posx: 0,
 posy: 0,
 width: $page07['width'],
 height: $page07['height'],
 pageheight: $page07['height'],
);
$pdf->page->addContent($pdf->getSetSVG(soid: $svg07a));

// ---------------------------------------------------------------------------
// Page 8 - style_cascade_regressions.svg (full-page portrait)
//
// Sheet covering the style cascade, opacity, length units and clipping rules:
// a style declaration against the presentation attribute of the same element,
// a fully transparent group, lengths with and without a unit suffix,
// percentage alpha values, and a clipPath applied to a shape, to a group and
// to nothing at all.
//
// Each case is drawn next to a reference shape painted directly in the
// expected form: the two must be identical.
// ---------------------------------------------------------------------------

$page08 = $pdf->addPage();
$pdf->setBookmark(
 name: 'style_cascade_regressions.svg',
 link: '',
 level: 0,
 page: -1,
 posx: 0,
 posy: 0,
 fstyle: 'B',
 color: 'green',
);

$svg08a = $pdf->addSVG(
 img: $svgdir . '/style_cascade_regressions.svg',
 posx: 0,
 posy: 0,
 width: $page08['width'],
 height: $page08['height'],
 pageheight: $page08['height'],
);
$pdf->page->addContent($pdf->getSetSVG(soid: $svg08a));

// ---------------------------------------------------------------------------
// Page 9 - style_sheet_use_regressions.svg (full-page portrait)
//
// Sheet covering the rules a document stylesheet contributes to the cascade,
// the compositing of a translucent group, the dash pattern, the dash offset
// and the miter limit, and the use element against a shape, a group and a
// symbol target.
//
// Each case is drawn next to a reference shape painted directly in the
// expected form: the two must be identical.
// ---------------------------------------------------------------------------

$page09 = $pdf->addPage();
$pdf->setBookmark(
 name: 'style_sheet_use_regressions.svg',
 link: '',
 level: 0,
 page: -1,
 posx: 0,
 posy: 0,
 fstyle: 'B',
 color: 'orange',
);

$svg09a = $pdf->addSVG(
 img: $svgdir . '/style_sheet_use_regressions.svg',
 posx: 0,
 posy: 0,
 width: $page09['width'],
 height: $page09['height'],
 pageheight: $page09['height'],
);
$pdf->page->addContent($pdf->getSetSVG(soid: $svg09a));

// ---------------------------------------------------------------------------
// Output
// ---------------------------------------------------------------------------

$rawpdf = $pdf->getOutPDFString();
$pdf->renderPDF(rawpdf: $rawpdf);

Example E031 : html features

Sun, 26 Apr 2026 00:00:00 +0000

The breadth of the HTML and CSS support: selector combinators, pseudo-elements, floats and positioning, table tags, and form controls.

Rendered PDF: E031_html_features.pdf
PHP source: E031_html_features.phps
All examples: /examples/
Category: HTML and CSS
Guide: HTML and CSS

PDF

Source Code

<?php

declare(strict_types=1);

/**
 * E031_html_features.php
 *
 * @since 2026-04-27
 * @category Library
 * @package Pdf
 * @author Nicola Asuni <info@tecnick.com>
 * @copyright 2002-2026 Nicola Asuni - Tecnick.com LTD
 * @license https://www.gnu.org/copyleft/lesser.html GNU-LGPL v3 (see LICENSE)
 * @link https://github.com/tecnickcom/tc-lib-pdf
 *
 * This file is part of tc-lib-pdf software library.
 */

// NOTE: local file reads (images, fonts, attachments) are restricted to an allowlist of
// trusted paths that covers this package tree, so run the examples in place. To read assets
// from other locations, list them in the 'allowedPaths' entry of the fileOptions constructor
// parameter (see E047_remote_resources_security.php).

// NOTE: run make fonts in the project root to generate the dependencies and example fonts.

// autoloader when using Composer
require __DIR__ . '/../vendor/autoload.php';

// define fonts directory
\define('K_PATH_FONTS', \realpath(__DIR__ . '/../vendor/tecnickcom/tc-lib-pdf-font/target/fonts'));

// autoloader when using RPM or DEB package installation
//require ('/usr/share/php/Com/Tecnick/Pdf/autoload.php');

// main TCPDF object
$pdf = new \Com\Tecnick\Pdf\Tcpdf(
 unit: \Com\Tecnick\Pdf\Page\Unit::Millimeter,
 isunicode: true,
 subsetfont: false,
 compress: true,
 mode: \Com\Tecnick\Pdf\PdfConformance::None,
 objEncrypt: null,
);

// ----------

$pdf->setCreator('tc-lib-pdf');
$pdf->setAuthor('Nicola Asuni');
$pdf->setSubject('tc-lib-pdf example: 031');
$pdf->setTitle('HTML Features Example');
$pdf->setKeywords('TCPDF tc-lib-pdf example HTML selectors forms table tags');
$pdf->setPDFFilename('031_html_features.pdf');

$pdf->setViewerPreferences(['DisplayDocTitle' => true]);

$pdf->enableDefaultPageContent();

// ----------
// Insert fonts

$bfont = $pdf->font->insert($pdf->pon, 'helvetica', '', 10);

$page01 = $pdf->addPage();
$pdf->setBookmark(
 name: 'HTML feature showcase',
 link: '',
 level: 0,
 page: -1,
 posx: 0,
 posy: 0,
 fstyle: 'B',
 color: '',
);
$pdf->page->addContent($bfont['out']);

// NOTE:
// The HTML parser expects input already cleaned to XHTML-like markup (e.g. via tidyHTML),
// and attribute extraction is intentionally based on double-quoted values.
// Unsupported interactive selectors intentionally remain no-op (for example :hover).
// For table-structure tags, this example demonstrates current support for
// caption/colgroup/col/tfoot; unsupported styling on colgroup/col remains
// intentionally a no-op in this conservative implementation.

// A small SVG image embedded as a data URI, in base64 and in percent-encoded form.
$svgImage =
 '<svg xmlns="http://www.w3.org/2000/svg" width="24" height="12">'
 . '<rect width="24" height="12" rx="3" fill="#3366cc"/><circle cx="6" cy="6" r="3" fill="#ffcc00"/></svg>';
$svgBase64 = 'data:image/svg+xml;base64,' . \base64_encode($svgImage);
$svgEncoded = 'data:image/svg+xml,' . \rawurlencode($svgImage);

$html = <<<HTML
 <style>
 .demo {
 font-size: 10pt;
 color: #222222;
 }
 .demo h2 {
 color: #003366;
 margin: 0 0 3mm 0;
 }
 .demo .selector-list li:first-child {
 color: #0b6e4f;
 font-weight: bold;
 }
 .demo .selector-list li:last-child {
 color: #8a1c7c;
 }
 .demo .selector-list li:nth-child(2n+1) {
 background-color: #f4f7ff;
 }
 .demo .selector-list li:nth-child(-n+2) {
 text-decoration: underline;
 }
 .demo .group > p + a.target {
 color: #0066cc;
 }
 .demo .group > p ~ a.target {
 font-weight: bold;
 }
 .demo .generated::before {
 content: "[PRE] ";
 color: #b03030;
 }
 .demo .generated::after {
 content: " [POST]";
 font-weight: bold;
 }
 .demo p:empty {
 background-color: #fff2cc;
 border: 0.2mm solid #c7a600;
 height: 4mm;
 }
 .demo a:link {
 text-decoration: underline;
 }
 .demo table {
 border: 0.2mm solid #666666;
 }
 .demo th {
 background-color: #dddddd;
 }
 .demo input,
 .demo select,
 .demo textarea {
 border: 0.2mm solid #777777;
 }
 .note {
 font-size: 8pt;
 color: #555555;
 }
 </style>
 <div class="demo">
 <h2>HTML Feature Showcase</h2>
 <p>This example demonstrates currently implemented selector, table, and form behavior in the HTML engine.</p>

 <h3>1) Pseudo-class selectors</h3>
 <ul class="selector-list">
 <li>First item (first-child + odd + -n+2)</li>
 <li>Second item (-n+2)</li>
 <li>Third item (odd)</li>
 <li>Fourth item (last-child)</li>
 </ul>

 <h3>2) Combinators (+ and ~)</h3>
 <div class="group">
 <p>Adjacent sibling trigger paragraph</p>
 <a class="target" href="https://github.com/tecnickcom/tc-lib-pdf">Adjacent + general sibling target link</a>
 </div>

 <h3>3) Empty pseudo-class</h3>
 <p></p>

 <h3>4) Pseudo-elements (::before / ::after, text-only content)</h3>
 <p><span class="generated">Generated marker sample</span></p>

 <h3>5) Stable table rendering with selectors applied</h3>
 <table border="1" cellpadding="2" cellspacing="0" style="width:100%">
 <tr>
 <th style="width:20%">Key</th>
 <th style="width:80%">Value</th>
 </tr>
 <tr>
 <td>first-child</td>
 <td>Supported</td>
 </tr>
 <tr>
 <td>last-child</td>
 <td>Supported</td>
 </tr>
 <tr>
 <td>nth-child</td>
 <td>Supports n, odd/even, and an+b (for example 2n+1, -n+2)</td>
 </tr>
 <tr>
 <td>empty</td>
 <td>Supported</td>
 </tr>
 <tr>
 <td>link</td>
 <td>Supported for anchors with href</td>
 </tr>
 </table>

 <h3>6) Table structure tags (caption, colgroup, col, tfoot)</h3>
 <table border="1" cellpadding="2" cellspacing="0" style="width:100%">
 <caption>Quarterly feature status</caption>
 <colgroup>
 <col width="22%">
 <col span="2" width="78%">
 </colgroup>
 <thead>
 <tr>
 <th>Area</th>
 <th>State</th>
 <th>Notes</th>
 </tr>
 </thead>
 <tr>
 <td>caption</td>
 <td>Rendered</td>
 <td>Displayed as a block-level table title.</td>
 </tr>
 <tr>
 <td>colgroup/col width hints</td>
 <td>Applied</td>
 <td>Used as precomputed column width hints before first-row fallback.</td>
 </tr>
 <tfoot>
 <tr>
 <td>tfoot</td>
 <td>Parsed</td>
 <td>Footer row contributes to table row/column bookkeeping.</td>
 </tr>
 </tfoot>
 </table>

 <h3>7) Form semantics (labels, field flags, select precedence)</h3>
 <p>
 <label for="contact_email">Email (for-id label):</label>
 <input type="email" id="contact_email" name="contact_email" value="user@example.com" maxlength="64" width="150">
 </p>
 <p>
 <label>Phone (wrapping label fallback):
 <input type="text" name="contact_phone" value="+39 010 123 456" size="70" width="150">
 </label>
 </p>
 <p>
 <label for="priority_pick">Priority:</label>
 <select id="priority_pick" name="priority_pick" value="normal" width="200">
 <optgroup label="Standard">
 <option value="normal">Normal</option>
 <option value="low">Low</option>
 </optgroup>
 <optgroup label="Urgent">
 <option value="high" selected>High (explicit selected wins)</option>
 <option value="critical">Critical</option>
 </optgroup>
 </select>
 </p>
 <p>
 <label for="notes">Notes (disabled textarea mapping):</label>
 <textarea id="notes" name="notes" cols="32" rows="2" maxlength="120" disabled>Handled by support queue</textarea>
 <br>
 <span class="note">Visible fallback text: Handled by support queue</span>
 </p>

 <p class="note">
 Unsupported selector examples intentionally remain unmatched: :hover, :focus, :active, and :visited.
 </p>
 <p class="note">
 Pseudo-elements are intentionally limited to text-only `content:"..."` behavior in this conservative implementation.
 </p>
 <p class="note">
 Unsupported styling on structural tags like colgroup/col is intentionally ignored in this conservative HTML engine pass.
 </p>
 <p class="note">
 This form section is focused on parser/field-mapping behavior; it is not intended to replicate browser form UX.
 </p>
 </div>
 HTML;

$pdf->addHTMLCell(html: $html, posx: 15, posy: 20, width: 180);

// ----------

// HTML B

$pageV02 = $pdf->addPage();

$rect = $pdf->graph->getRect(160, 36, 30, 50, 'DF');
$pdf->page->addContent($rect);

$textcolors = '<h2>Text</h1>';
$bgcolors = '<h2>Background</h2>';
$csscolortypes =
 '<h2>CSS Color Types</h2>'
 . '<table border="1" cellpadding="3" cellspacing="2" style="width:100%; font-size:9pt;">'
 . '<tr><th style="width:20%">Type</th><th style="width:80%">Example</th></tr>'
 . '<tr><td>named</td><td style="background-color: navy; color: #ffffff;">background-color: navy</td></tr>'
 . '<tr><td>gray</td><td style="background-color: g(50%); color: #ffffff;">background-color: g(50%)</td></tr>'
 . '<tr><td>hex short</td><td style="background-color: #0f0; color: #000000;">background-color: #0f0</td></tr>'
 . '<tr><td>hex long</td><td style="background-color: #1e90ff; color: #ffffff;">background-color: #1e90ff</td></tr>'
 . '<tr><td>rgb</td><td style="background-color: rgb(255, 99, 71); color: #000000;">background-color: rgb(255, 99, 71)</td></tr>'
 . '<tr><td>rgba</td><td style="background-color: rgba(30, 144, 255, 0.25); color: #000000;">background-color: rgba(30, 144, 255, 0.25)</td></tr>'
 . '<tr><td>hsl</td><td style="background-color: hsl(120, 100%, 25%); color: #ffffff;">background-color: hsl(120, 100%, 25%)</td></tr>'
 . '<tr><td>hsla</td><td style="background-color: hsla(300, 100%, 50%, 0.20); color: #000000;">background-color: hsla(300, 100%, 50%, 0.20)</td></tr>'
 . '<tr><td>lab</td><td style="background-color: lab(54.29% -19.04 38.25); color: #ffffff;">background-color: lab(54.29% -19.04 38.25)</td></tr>'
 . '<tr><td>lab alpha</td><td style="background-color: lab(54.29% -19.04 38.25 / 0.35); color: #ffffff;">background-color: lab(54.29% -19.04 38.25 / 0.35)</td></tr>'
 . '<tr><td>cmyk</td><td style="background-color: cmyk(67, 33, 0, 25); color: #ffffff;">background-color: cmyk(67, 33, 0, 25)</td></tr>'
 . '</table>';

foreach ($pdf->color::WEBHEX as $k => $v) {
 $textcolors .= '<span color="#' . $v . '">' . $k . '</span> ';
 $bgcolors .= '<span bgcolor="#' . $v . '" color="#333333">' . $k . '</span> ';
}

$html_02 = '<h1>HTML Colors</h1>' . $csscolortypes . '<hr />' . $textcolors . '<hr />' . $bgcolors;

$pdf->addHTMLCell(html: $html_02, posx: 20, posy: 10, width: 180);

// ----------

// HTML D - Transparency Showcase

$pageV02T = $pdf->addPage();

$pdf->page->addContent($bfont['out']);

$pdf->setBookmark(
 name: 'Transparency color showcase',
 link: '',
 level: 0,
 page: -1,
 posx: 0,
 posy: 0,
 fstyle: 'B',
 color: '',
);

$baseRectStyle = [
 'lineWidth' => 0,
 'lineCap' => 'butt',
 'lineJoin' => 'miter',
 'miterLimit' => 10,
 'dashArray' => [],
 'dashPhase' => 0,
 'lineColor' => 'none',
 'fillColor' => 'rgb(0, 64, 128)',
];

$pdf->page->addContent($pdf->graph->getRect(20, 24, 170, 96, 'F', ['all' => $baseRectStyle]));

$html_transparency = <<<HTML
 <style>
 .alpha-demo {
 font-size: 10pt;
 color: #ffffff;
 }
 .alpha-demo h2 {
 margin: 0 0 2mm 0;
 font-size: 16pt;
 color: rgba(255, 255, 255, 0.62);
 }
 .alpha-demo .line-a {
 font-size: 12pt;
 color: rgba(255, 255, 255, 0.48);
 margin: 0 0 2mm 0;
 }
 .alpha-demo .line-b {
 font-size: 12pt;
 color: hsla(60, 100%, 86%, 0.58);
 margin: 0 0 3mm 0;
 }
 .alpha-demo .bg-strip {
 margin-top: 1mm;
 padding: 1.3mm 1.8mm;
 background-color: rgba(0, 0, 0, 0.30);
 color: rgba(255, 255, 255, 0.9);
 }
 .alpha-demo .swatch {
 display: inline-block;
 margin-right: 2mm;
 padding: 0.7mm 1.6mm;
 color: rgba(0, 0, 0, 0.86);
 font-weight: bold;
 }
 .alpha-demo .swatch-rgba {
 background-color: rgba(30, 144, 255, 0.32);
 }
 .alpha-demo .swatch-hsla {
 background-color: hsla(300, 100%, 60%, 0.30);
 }
 .alpha-demo .swatch-rgba2 {
 background-color: rgba(255, 255, 255, 0.45);
 }
 </style>
 <div class="alpha-demo">
 <h2>Transparency Color Showcase</h2>
 <p class="line-a">RGBA text: white alpha at 0.48 over a solid blue rectangle</p>
 <p class="line-b">HSLA text: warm yellow alpha at 0.58 over the same blue base</p>
 <div class="bg-strip">Background object with alpha: rgba(0, 0, 0, 0.30)</div>
 <p>
 <span class="swatch swatch-rgba">RGBA bg 0.32</span>
 <span class="swatch swatch-hsla">HSLA bg 0.30</span>
 <span class="swatch swatch-rgba2">RGBA bg 0.45</span>
 </p>
 </div>
 HTML;

$pdf->addHTMLCell(html: $html_transparency, posx: 24, posy: 28, width: 162);

// ----------

// HTML C

$pageV03 = $pdf->addPage();

$html_03 = '<h1>Various HTML Tests</h1>
<font face="courier"><b>thisisaverylongword</b></font> <font face="helvetica"><i>thisisanotherverylongword</i></font> <font face="times"><b>thisisaverylongword</b></font> thisisanotherverylongword <font face="times">thisisaverylongword</font> <font face="courier"><b>thisisaverylongword</b></font> <font face="helvetica"><i>thisisanotherverylongword</i></font> <font face="times"><b>thisisaverylongword</b></font> thisisanotherverylongword <font face="times">thisisaverylongword</font> <font face="courier"><b>thisisaverylongword</b></font> <font face="helvetica"><i>thisisanotherverylongword</i></font> <font face="times"><b>thisisaverylongword</b></font> thisisanotherverylongword <font face="times">thisisaverylongword</font> <font face="courier"><b>thisisaverylongword</b></font> <font face="helvetica"><i>thisisanotherverylongword</i></font> <font face="times"><b>thisisaverylongword</b></font> thisisanotherverylongword <font face="times">thisisaverylongword</font> <font face="courier"><b>thisisaverylongword</b></font> <font face="helvetica"><i>thisisanotherverylongword</i></font> <font face="times"><b>thisisaverylongword</b></font> thisisanotherverylongword <font face="times">thisisaverylongword</font>';

// Test fonts nesting
$htmlt1 = 'Default <font face="courier">Courier <font face="helvetica">Helvetica <font face="times">Times <font face="dejavusans">dejavusans </font>Times </font>Helvetica </font>Courier </font>Default';
$htmlt2 = '<small>small text</small> normal <small>small text</small> normal <sub>subscript</sub> normal <sup>superscript</sup> normal';
$htmlt3 = '<font size="10" color="#ff7f50">The</font> <font size="10" color="#6495ed">quick</font> <font size="14" color="#dc143c">brown</font> <font size="18" color="#008000">fox</font> <font size="22"><a href="https://tcpdf.org">jumps</a></font> <font size="22" color="#a0522d">over</font> <font size="18" color="#da70d6">the</font> <font size="14" color="#9400d3">lazy</font> <font size="10" color="#4169ef">dog</font>.';

$html_03 .=
 '<br />' . $htmlt1 . '<br />' . $htmlt2 . '<br />' . $htmlt3 . '<br />' . $htmlt3 . '<br />' . $htmlt2 . '<br />';

$html_03 .= '<div><span style="font-size:8pt; line-height:110%;">#<span style="font-size:18pt">1</span>a</span></div>';

$html_03 .= <<<EOF
 <hr />
 <h2>Div Blocks</h2>
 <div style="background-color:#880000;color:white;">
 Hello World!<br />
 Hello
 </div>
 <pre style="background-color:#336699;color:white;">
 int main() {
 printf("HelloWorld");
 return 0;
 }
 </pre>
 <tt>Monospace font</tt>, normal font, <tt>monospace font</tt>, normal font.
 <br />
 <div style="background-color:#880000;color:white;">DIV LEVEL 1<div style="background-color:#008800;color:white;">DIV LEVEL 2</div>DIV LEVEL 1</div>
 <br />
 <span style="background-color:#880000;color:white;">SPAN LEVEL 1 <span style="background-color:#008800;color:white;">SPAN LEVEL 2</span> SPAN LEVEL 1</span>
 <hr />
 <h2>Images from Data URIs</h2>
 SVG, base64: <img src="{$svgBase64}" alt="SVG base64" width="48" height="24" />
 SVG, percent-encoded: <img src="{$svgEncoded}" alt="SVG percent-encoded" width="48" height="24" />
 EOF;

$pdf->addHTMLCell(html: $html_03, posx: 20, posy: 10, width: 180);

// ----------

// HTML E-A

$pageV05A = $pdf->addPage();

$html_05A = '<h2>HTML Text Alignment (A)</h2>
Sed ut perspiciatis unde omnis iste natus error sit voluptatem accusantium doloremque laudantium, totam rem aperiam, eaque ipsa quae ab illo inventore veritatis et quasi architecto beatae vitae dicta sunt explicabo. Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed quia consequuntur magni dolores eos qui ratione voluptatem sequi nesciunt. Neque porro quisquam est, qui dolorem ipsum quia dolor sit amet, consectetur, adipisci velit, sed quia non numquam eius modi tempora incidunt ut labore et dolore magnam aliquam quaerat voluptatem. <em>Ut enim ad minima veniam, quis nostrum exercitationem ullam corporis suscipit laboriosam, nisi ut aliquid ex ea commodi consequatur?</em> <em>Quis autem vel eum iure reprehenderit qui in ea voluptate velit esse quam nihil molestiae consequatur, vel illum qui dolorem eum fugiat quo voluptas nulla pariatur?</em><br /><br /><b>A</b> + <b>B</b> = <b>C</b> &nbsp;&nbsp; -&gt; &nbsp;&nbsp; <i>C</i> - <i>B</i> = <i>A</i> &nbsp;&nbsp; -&gt; &nbsp;&nbsp; <i>C</i> - <i>A</i> = <i>B</i> -&gt; &nbsp;&nbsp; <b>A</b> + <b>B</b> = <b>C</b> &nbsp;&nbsp; -&gt; &nbsp;&nbsp; <i>C</i> - <i>B</i> = <i>A</i> &nbsp;&nbsp; -&gt; &nbsp;&nbsp; <i>C</i> - <i>A</i> = <i>B</i> -&gt; &nbsp;&nbsp; <b>A</b> + <b>B</b> = <b>C</b> &nbsp;&nbsp; -&gt; &nbsp;&nbsp; <i>C</i> - <i>B</i> = <i>A</i> &nbsp;&nbsp; -&gt; &nbsp;&nbsp; <i>C</i> - <i>A</i> = <i>B</i> -&gt; &nbsp;&nbsp; <b>A</b> + <b>B</b> = <b>C</b> &nbsp;&nbsp; -&gt; &nbsp;&nbsp; <i>C</i> - <i>B</i> = <i>A</i> &nbsp;&nbsp; -&gt; &nbsp;&nbsp; <i>C</i> - <i>A</i> = <i>B</i> &nbsp;&nbsp; -&gt; &nbsp;&nbsp; <b>A</b> + <b>B</b> = <b>C</b> &nbsp;&nbsp; -&gt; &nbsp;&nbsp; <i>C</i> - <i>B</i> = <i>A</i> &nbsp;&nbsp; -&gt; &nbsp;&nbsp; <i>C</i> - <i>A</i> = <i>B</i> -&gt; &nbsp;&nbsp; <b>A</b> + <b>B</b> = <b>C</b> &nbsp;&nbsp; -&gt; &nbsp;&nbsp; <i>C</i> - <i>B</i> = <i>A</i> &nbsp;&nbsp; -&gt; &nbsp;&nbsp; <i>C</i> - <i>A</i> = <i>B</i> -&gt; &nbsp;&nbsp; <b>A</b> + <b>B</b> = <b>C</b> &nbsp;&nbsp; -&gt; &nbsp;&nbsp; <i>C</i> - <i>B</i> = <i>A</i> &nbsp;&nbsp; -&gt; &nbsp;&nbsp; <i>C</i> - <i>A</i> = <i>B</i> -&gt; &nbsp;&nbsp; <b>A</b> + <b>B</b> = <b>C</b> &nbsp;&nbsp; -&gt; &nbsp;&nbsp; <i>C</i> - <i>B</i> = <i>A</i> &nbsp;&nbsp; -&gt; &nbsp;&nbsp; <i>C</i> - <i>A</i> = <i>B</i><br /><br /><b>Bold</b><i>Italic</i><u>Underlined</u> <b>Bold</b><i>Italic</i><u>Underlined</u> <b>Bold</b><i>Italic</i><u>Underlined</u> <b>Bold</b><i>Italic</i><u>Underlined</u> <b>Bold</b><i>Italic</i><u>Underlined</u> <b>Bold</b><i>Italic</i><u>Underlined</u> <b>Bold</b><i>Italic</i><u>Underlined</u> <b>Bold</b><i>Italic</i><u>Underlined</u> <b>Bold</b><i>Italic</i><u>Underlined</u> <b>Bold</b><i>Italic</i><u>Underlined</u> <b>Bold</b><i>Italic</i><u>Underlined</u> <b>Bold</b><i>Italic</i><u>Underlined</u> <b>Bold</b><i>Italic</i><u>Underlined</u>';

$pdf->addHTMLCell(html: $html_05A, posx: 20, posy: 10, width: 180);

// ----------

// HTML E-L

$html_05L = '<p>Alfa Bravo Charlie Delta Echo Foxtrot Golf Hotel India Juliett Kilo. Lima Mike November Oscar Papa Quebec Romeo (<em>Sierra-Tango</em>) Uniform Victor Whiskey (<em>Xray-Yankee</em>). Zulu. Alfa Bravo Charlie Delta Echo Foxtrot Golf Hotel India Juliett Kilo. Lima Mike November Oscar Papa Quebec Romeo (<em>Sierra-Tango</em>) Uniform Victor Whiskey (<em>Xray-Yankee</em>). Zulu. Alfa Bravo Charlie Delta Echo Foxtrot Golf Hotel India Juliett Kilo. Lima Mike November Oscar Papa Quebec Romeo (<em>Sierra-Tango</em>) Uniform Victor Whiskey (<em>Xray-Yankee</em>). Zulu.</p>';

$pdf->addHTMLCell(html: $html_05L, posx: 20, posy: 100, width: 180);

// ----------

// HTML E-B

$pageV05B = $pdf->addPage();

$html_05B = '<h2>HTML Text Alignment (B)</h2>
<div style="text-align:justify;">JUSTIFY: Alfa Bravo Charlie Delta Echo Foxtrot Golf Hotel India Juliett Kilo Lima Mike November Oscar Papa Quebec Romeo Sierra Tango Uniform Victor Whiskey Xray Yankee Zulu Alfa Bravo Charlie Delta Echo Foxtrot Golf Hotel India Juliett Kilo Lima Mike November Oscar Papa
Quebec Romeo</div>
<br />
<div style="text-align:left;">LEFT: Alfa <i>Bravo</i> Charlie <i>Delta</i> Echo <i>Foxtrot</i> Golf <i>Hotel</i> India <i>Juliett</i> Kilo <i>Lima</i> Mike <i>November</i> Oscar <i>Papa</i> Quebec <i>Romeo</i> Sierra <i>Tango</i> Uniform <i>Victor</i> Whiskey <i>Xray</i> Yankee <i>Zulu</i></div>
<br />
<div style="text-align:center;">CENTER: Alfa <i>Bravo</i> Charlie <i>Delta</i> Echo <i>Foxtrot</i> Golf <i>Hotel</i> India <i>Juliett</i> Kilo <i>Lima</i> Mike <i>November</i> Oscar <i>Papa</i> Quebec <i>Romeo</i> Sierra <i>Tango</i> Uniform <i>Victor</i> Whiskey <i>Xray</i> Yankee <i>Zulu</i></div>
<br />
<div style="text-align:right;">RIGHT: Alfa <i>Bravo</i> Charlie <i>Delta</i> Echo <i>Foxtrot</i> Golf <i>Hotel</i> India <i>Juliett</i> Kilo <i>Lima</i> Mike <i>November</i> Oscar <i>Papa</i> Quebec <i>Romeo</i> Sierra <i>Tango</i> Uniform <i>Victor</i> Whiskey <i>Xray</i> Yankee <i>Zulu</i></div>
<br />
<div style="text-align:justify;">JUSTIFY: Alfa <i>Bravo</i> Charlie <i>Delta</i> Echo <i>Foxtrot</i> Golf <i>Hotel</i> India <i>Juliett</i> Kilo <i>Lima</i> Mike <i>November</i> Oscar <i>Papa</i> Quebec <i>Romeo</i> Sierra <i>Tango</i> Uniform <i>Victor</i> Whiskey <i>Xray</i> Yankee <i>Zulu</i></div>
<br />
<div style="text-align:justify;">JUSTIFY: Alfa <i>Bravo</i> Charlie <i>Delta</i> Echo <img src="images/tcpdf_logo.jpg" alt="TCPDF logo" width="89" height="30" border="0" /><img src="images/tcpdf_box.svg" alt="TCPDF box" width="100" height="67" border="0" /> <i>Foxtrot</i> Golf <i>Hotel</i> India <i>Juliett</i> Kilo <i>Lima</i> Mike <i>November</i> Oscar <i>Papa</i> Quebec <i>Romeo</i> Sierra <i>Tango</i> Uniform <i>Victor</i> Whiskey <i>Xray</i> Yankee <i>Zulu</i></div>
<br />
<div style="text-align:left;">LEFT: Alfa <i>Bravo</i> Charlie <i>Delta</i> Echo <img src="images/tcpdf_logo.jpg" alt="TCPDF logo" width="89" height="30" border="0" /><img src="images/tcpdf_box.svg" alt="TCPDF box" width="100" height="67" border="0" /> <i>Foxtrot</i> Golf <i>Hotel</i> India <i>Juliett</i> Kilo <i>Lima</i> Mike <i>November</i> Oscar <i>Papa</i> Quebec <i>Romeo</i> Sierra <i>Tango</i> Uniform <i>Victor</i> Whiskey <i>Xray</i> Yankee <i>Zulu</i></div>
<br />
<div style="text-align:center;">CENTER: Alfa <i>Bravo</i> Charlie <i>Delta</i> Echo <img src="images/tcpdf_logo.jpg" alt="TCPDF logo" width="89" height="30" border="0" /><img src="images/tcpdf_box.svg" alt="TCPDF box" width="100" height="67" border="0" /> <i>Foxtrot</i> Golf <i>Hotel</i> India <i>Juliett</i> Kilo <i>Lima</i> Mike <i>November</i> Oscar <i>Papa</i> Quebec <i>Romeo</i> Sierra <i>Tango</i> Uniform <i>Victor</i> Whiskey <i>Xray</i> Yankee <i>Zulu</i></div>
<br />
<div style="text-align:right;">RIGHT: Alfa <i>Bravo</i> Charlie <i>Delta</i> Echo <img src="images/tcpdf_logo.jpg" alt="TCPDF logo" width="89" height="30" border="0" /><img src="images/tcpdf_box.svg" alt="TCPDF box" width="100" height="67" border="0" /> <i>Foxtrot</i> Golf <i>Hotel</i> India <i>Juliett</i> Kilo <i>Lima</i> Mike <i>November</i> Oscar <i>Papa</i> Quebec <i>Romeo</i> Sierra <i>Tango</i> Uniform <i>Victor</i> Whiskey <i>Xray</i> Yankee <i>Zulu</i></div>
<br /><hr />
<div><span style="text-align:justify;">a <u>abc</u> abcdefghijkl (abcdef) abcdefg <b>abcdefghi</b> a ((abc)) abcd <img src="images/tcpdf_logo.jpg" alt="TCPDF logo" width="89" height="30" border="0" /> abcdef abcdefg <b>abcdefghi</b> a abc abcd abcdef abcdefg <b>abcdefghi</b> a abc abcd abcdef abcdefg <b>abcdefghi</b> a <u>abc</u> abcd abcdef abcdefg <b>abcdefghi</b> a abc \(abcd\) abcdef abcdefg <b>abcdefghi</b> a abc \\\(abcd\\\) abcdef abcdefg <b>abcdefghi</b> a abc abcd abcdef abcdefg <b>abcdefghi</b> a abc abcd abcdef abcdefg <b>abcdefghi</b> a abc abcd abcdef abcdefg abcdefghi a abc abcd <a href="https://tcpdf.org">abcdef abcdefg</a> start a abc before <span style="background-color:yellow">yellow color</span> after a abc abcd abcdef abcdefg abcdefghi a abc abcd end abcdefg abcdefghi a abc abcd abcdef abcdefg abcdefghi a abc abcd abcdef abcdefg abcdefghi a abc abcd abcdef abcdefg abcdefghi a abc abcd abcdef abcdefg abcdefghi a abc abcd abcdef abcdefg abcdefghi a abc abcd abcdef abcdefg abcdefghi a abc abcd abcdef abcdefg abcdefghi<br />abcd abcdef abcdefg abcdefghi<br />abcd abcde abcdef</span></div><hr />';

$pdf->addHTMLCell(html: $html_05B, posx: 20, posy: 10, width: 180);

// ----------

// HTML F

$pageV06 = $pdf->addPage();

$html_06 = <<<EOF
 <!-- EXAMPLE OF CSS STYLE -->
 <style>
 	h1 {
 		color: navy;
 		font-family: times;
 		font-size: 24pt;
 		text-decoration: underline;
 	}
 	p.first {
 		color: #003300;
 		font-family: helvetica;
 		font-size: 12pt;
 	}
 	p.first span {
 		color: #006600;
 		font-style: italic;
 	}
 	p#second {
 		color: rgb(00,63,127);
 		font-family: times;
 		font-size: 12pt;
 		text-align: justify;
 	}
 	p#second > span {
 		background-color: #FFFFAA;
 	}
 	table.first {
 		color: #003300;
 		font-family: helvetica;
 		font-size: 8pt;
 		border-left: 3px solid red;
 		border-right: 3px solid #FF00FF;
 		border-top: 3px solid green;
 		border-bottom: 3px solid blue;
 		background-color: #ccffcc;
 	}
 	td {
 		border: 2px solid blue;
 		background-color: #ffffee;
 	}
 	td.second {
 		border: 2px dashed green;
 	}
 	div.test {
 		color: #CC0000;
 		background-color: #FFFF66;
 		font-family: helvetica;
 		font-size: 10pt;
 		border-style: solid solid solid solid;
 		border-width: 2px 2px 2px 2px;
 		border-color: green #FF00FF blue red;
 		text-align: center;
 	}
 	.lowercase {
 		text-transform: lowercase;
 	}
 	.uppercase {
 		text-transform: uppercase;
 	}
 	.capitalize {
 		text-transform: capitalize;
 	}
 </style>

 <h1 class="title">Example of <i style="color:#990000">XHTML + CSS</i></h1>

 <p class="first">Example of paragraph with class selector. <span>Lorem ipsum dolor sit amet, consectetur adipiscing elit. In sed imperdiet lectus. Phasellus quis velit velit, non condimentum quam. Sed neque urna, ultrices ac volutpat vel, laoreet vitae augue. Sed vel velit erat. Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos himenaeos. Cras eget velit nulla, eu sagittis elit. Nunc ac arcu est, in lobortis tellus. Praesent condimentum rhoncus sodales. In hac habitasse platea dictumst. Proin porta eros pharetra enim tincidunt dignissim nec vel dolor. Cras sapien elit, ornare ac dignissim eu, ultricies ac eros. Maecenas augue magna, ultrices a congue in, mollis eu nulla. Nunc venenatis massa at est eleifend faucibus. Vivamus sed risus lectus, nec interdum nunc.</span></p>

 <p id="second">Example of paragraph with ID selector. <span>Fusce et felis vitae diam lobortis sollicitudin. Aenean tincidunt accumsan nisi, id vehicula quam laoreet elementum. Phasellus egestas interdum erat, et viverra ipsum ultricies ac. Praesent sagittis augue at augue volutpat eleifend. Cras nec orci neque. Mauris bibendum posuere blandit. Donec feugiat mollis dui sit amet pellentesque. Sed a enim justo. Donec tincidunt, nisl eget elementum aliquam, odio ipsum ultrices quam, eu porttitor ligula urna at lorem. Donec varius, eros et convallis laoreet, ligula tellus consequat felis, ut ornare metus tellus sodales velit. Duis sed diam ante. Ut rutrum malesuada massa, vitae consectetur ipsum rhoncus sed. Suspendisse potenti. Pellentesque a congue massa.</span></p>

 <div class="test">example of DIV with border and fill.
 <br />Lorem ipsum dolor sit amet, consectetur adipiscing elit.
 <br /><span class="lowercase">text-transform <b>LOWERCASE</b> Lorem ipsum dolor sit amet, consectetur adipiscing elit.</span>
 <br /><span class="uppercase">text-transform <b>uppercase</b> Lorem ipsum dolor sit amet, consectetur adipiscing elit.</span>
 <br /><span class="capitalize">text-transform <b>cAPITALIZE</b> Lorem ipsum dolor sit amet, consectetur adipiscing elit.</span>
 </div>
 EOF;

$pdf->addHTMLCell(html: $html_06, posx: 20, posy: 10, width: 180);

// ----------

// HTML A

$pageV01 = $pdf->addPage();

$bfont6 = $pdf->font->insert($pdf->pon, 'dejavusans', '', 10);

$pdf->page->addContent($bfont6['out']);

$style_cell = [
 'all' => [
 'lineWidth' => 1,
 'lineCap' => 'round',
 'lineJoin' => 'round',
 'miterLimit' => 1,
 'dashArray' => [],
 'dashPhase' => 0,
 'lineColor' => 'green',
 'fillColor' => '#fdfca5',
 ],
];

$html_01 = '<h1>HTML Example A</h1>
Some special characters: &lt; € &euro; &#8364; &amp; è &egrave; &copy; &gt; \\slash \\\\double-slash \\\\\\triple-slash
<h2>List</h2>
List example:
<ol>
	<li><b>bold text</b></li>
	<li><i>italic text</i></li>
	<li><u>underlined text</u></li>
	<li><b>b<i>bi<u>biu</u>bi</i>b</b></li>
	<li><a href="https://tcpdf.org" dir="ltr">link to https://tcpdf.org</a></li>
	<li>Sed ut perspiciatis unde omnis iste natus error sit voluptatem accusantium doloremque laudantium, totam rem aperiam, eaque ipsa quae ab illo inventore veritatis et quasi architecto beatae vitae dicta sunt explicabo.<br />Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed quia consequuntur magni dolores eos qui ratione voluptatem sequi nesciunt.</li>
	<li>SUBLIST
		<ol>
			<li>row one
				<ul>
					<li>sublist</li>
				</ul>
			</li>
			<li>row two</li>
		</ol>
	</li>
	<li><b>T</b>E<i>S</i><u>T</u> <del>line through</del></li>
	<li><font size="+3">font + 3</font></li>
	<li><small>small text</small> normal <small>small text</small> normal <sub>subscript</sub> normal <sup>superscript</sup> normal</li>
</ol>
<dl>
	<dt>Coffee</dt>
	<dd>Black hot drink</dd>
	<dt>Milk</dt>
	<dd>White cold drink</dd>
</dl>

<div style="text-align:center">The words &#8220;<span dir="rtl">&#1502;&#1494;&#1500; [mazel] &#1496;&#1493;&#1489; [tov]</span>&#8221; mean &#8220;Congratulations!&#8221;</div>

<p>This is just an example of html code to demonstrate some supported CSS inline styles.
<span style="font-weight: bold;">bold text</span>
<span style="text-decoration: line-through;">line-trough</span>
<span style="text-decoration: underline line-through;">underline and line-trough</span>
<span style="color: rgb(0, 128, 64);">color</span>
<span style="background-color: rgb(255, 0, 0); color: rgb(255, 255, 255);">background color</span>
<span style="font-weight: bold;">bold</span>
<span style="font-size: xx-small;">xx-small</span>
<span style="font-size: x-small;">x-small</span>
<span style="font-size: small;">small</span>
<span style="font-size: medium;">medium</span>
<span style="font-size: large;">large</span>
<span style="font-size: x-large;">x-large</span>
<span style="font-size: xx-large;">xx-large</span>
</p>';

$pdf->addHTMLCell(html: $html_01, posx: 20, posy: 10, width: 150, height: 0, cell: null, styles: $style_cell);

// ----------

$pageVC = $pdf->addPage();

$pdf->page->addContent($bfont6['out']);

$html_vc1 = <<<HTML
 <style>
 .vc-box {
 width: 150mm;
 height: 90mm;
 border: 0.6mm solid #003366;
 background-color: #e9f2ff;
 }
 .vc-fill {
 width: 100%;
 height: 100%;
 }
 .vc-content {
 vertical-align: middle;
 text-align: center;
 color: #002244;
 }
 </style>
 <div class="vc-box">
 <table class="vc-fill" border="0" cellpadding="0" cellspacing="0">
 <tr>
 <td class="vc-content">
 <h1>Vertically Centered Block</h1>
 <p>This content is centered in the middle of the box.</p>
 <p><b>HTML:</b> headings, paragraphs, and inline formatting.</p>
 </td>
 </tr>
 </table>
 </div>
 HTML;

$pdf->addHTMLCell(html: $html_vc1, posx: 20, posy: 20);

// ----------

$html_vc2 = <<<HTML
 <table border="1" cellpadding="0" cellspacing="0" style="width:150mm; height:100mm; background-color:blue; border-color:#003366;">
 <tr>
 <td style="height:100mm; vertical-align:middle; text-align:center; color:cmyk(100,0,0,0);">
 <h1>Vertically Centered Block</h1>
 <p>This content is centered in the middle of the box.</p>
 <p><b>HTML:</b> headings, paragraphs, and inline formatting.</p>
 </td>
 </tr>
 </table>
 HTML;

$pdf->addHTMLCell(html: $html_vc2, posx: 20, posy: 120, width: 150, height: 100);

// ----------

// HTML G - Non-breaking characters
//
// Every column is 33 mm wide, so "AAAA BBBB CCCC" fits on one line but
// "AAAA BBBB CCCC DDDD" does not. Only the first column, joined by an ordinary
// space, may break between CCCC and DDDD: in all the others the two words move
// to the second line together.

$pageNB = $pdf->addPage();

$pdf->page->addContent($bfont6['out']);

$nb_separators = [
 'U+0020 SPACE' => ' ',
 'U+00A0 NO-BREAK SPACE' => "\u{00A0}",
 'U+2007 FIGURE SPACE' => "\u{2007}",
 'U+202F NARROW NO-BREAK' => "\u{202F}",
];

$nb_posx = 20.0;
foreach ($nb_separators as $nb_label => $nb_separator) {
 $nb_text = 'AAAA BBBB CCCC' . $nb_separator . 'DDDD EEEE';

 $pdf->addHTMLCell(
 html: '<p style="font-size:7pt;color:#666666;">' . $nb_label . '</p>',
 posx: $nb_posx,
 posy: 20,
 width: 36,
 );
 $pdf->addHTMLCell(html: '<p style="font-size:10pt;">' . $nb_text . '</p>', posx: $nb_posx, posy: 28, width: 33);
 $pdf->addTextCell(
 txt: $nb_text,
 pid: -1,
 posx: $nb_posx,
 posy: 50,
 width: 33,
 height: 30,
 offset: 0,
 linespace: 0,
 valign: \Com\Tecnick\Pdf\TextVAlign::Top,
 halign: \Com\Tecnick\Pdf\TextHAlign::Left,
 cell: null,
 styles: [],
 strokewidth: 0,
 wordspacing: 0,
 leading: 0,
 rise: 0,
 jlast: true,
 fill: true,
 stroke: false,
 underline: false,
 linethrough: false,
 overline: false,
 clip: false,
 drawcell: false,
 );

 $nb_posx += 41.0;
}

// A NO-BREAK SPACE keeps a short word attached to the one that follows it.

$html_nb = <<<HTML
 <p style="font-size:10pt;">Заголовок в&nbsp;двух строках и&nbsp;ещё немного текста для переноса.</p>
 HTML;

$pdf->addHTMLCell(html: $html_nb, posx: 20, posy: 90, width: 60);

// ----------

// get PDF document as raw string
$rawpdf = $pdf->getOutPDFString();

// Various output modes:

//$pdf->savePDF(\dirname(__DIR__).'/target', $rawpdf);
$pdf->renderPDF(rawpdf: $rawpdf);

//$pdf->downloadPDF($rawpdf);
//echo $pdf->getMIMEAttachmentPDF($rawpdf);

tc-lib-pdf (TCPDF) on TCPDF

Colour Notations

Hexadecimal

Rendering Options

Width and Height

Colour Models

Output Formats

Conversions

The Matrix

Linear Barcodes

49 Formats

See Also

2D Barcodes

13 Formats

See Also

Web Colours

Lookups

Nearest Colour

The Two Answers

Postal Barcodes

11 Formats

See Also

Spot Colours

Registering One

PDF Output

Fill And Stroke

Errors

2 of 5 Datalogic

Type Token

Input

Examples

Ten digits

2 of 5 IATA

Type Token

Input

Examples

Ten digits

2 of 5 Matrix

Type Token

Input

Examples

Ten digits

Australia Post 4-State

Aztec Code

Aztec Rune

Type Token

Input

Examples

A value in the middle of the range

CIE Lab

Model

Components

CMYK

Model

Codabar

Type Token

Input

Examples

Ten digits

CODE 11

Type Token

Input

Examples

Ten digits, one check character

CODE 128

CODE 128 A

Type Token

Input

Examples

Digits and upper case

CODE 128 B

Type Token

Input

Examples

Lower case text

CODE 128 C

Type Token

Input

Examples

Ten digits in five symbol characters