Example E074 : text cell fit modes

Your support helps keep this website running. Please consider supporting this project. SPONSOR DONATE
26 Apr 2026
The overflow fit modes for a text cell: truncate, stretch, or shrink the font until the text fits.
Rendered PDF: E074_text_cell_fit_modes.pdf
PHP source: E074_text_cell_fit_modes.phps
All examples: /examples/
PDF

Source Code

<?php

declare(strict_types=1);

/**
 * E074_text_cell_fit_modes.php
 *
 * Demonstrates getTextCell/addTextCell fit modes:
 * T, S, F and disabled behavior.
 *
 * @since       2026-05-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'));

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

$pdf->setCreator('tc-lib-pdf');
$pdf->setAuthor('Nicola Asuni');
$pdf->setSubject('tc-lib-pdf example: 074');
$pdf->setTitle('Text Cell Fit Modes');
$pdf->setKeywords('TCPDF tc-lib-pdf example text cell fit T S F');
$pdf->setPDFFilename('074_text_cell_fit_modes.pdf');

$titleFont = $pdf->font->insert($pdf->pon, 'helvetica', 'B', 14);

// ----------

$pdf->addPage();
$pdf->page->addContent($titleFont['out']);
$pdf->page->addContent($pdf->getTextCell(
    txt: 'getTextCell() fit mode',
    posx: 15,
    posy: 15,
    valign: \Com\Tecnick\Pdf\TextVAlign::Top,
    halign: \Com\Tecnick\Pdf\TextHAlign::Left,
));

$baseFont = $pdf->font->insert($pdf->pon, 'helvetica', '', 11);

$cellStyle = [
    'all' => [
        'lineWidth' => 0.3,
        'lineCap' => 'butt',
        'lineJoin' => 'miter',
        'dashArray' => [],
        'dashPhase' => 0,
        'lineColor' => '#4a5b70',
        'fillColor' => '#ffffff',
    ],
];

$pdf->page->addContent($baseFont['out']);

$pdf->page->addContent($pdf->getTextCell(
    txt: 'Long text scenario (overflow):',
    posx: 15,
    posy: 30,
    valign: \Com\Tecnick\Pdf\TextVAlign::Top,
    halign: \Com\Tecnick\Pdf\TextHAlign::Left,
));

$longSample = 'Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.';
$modesL = [
    \Com\Tecnick\Pdf\TextFitMode::Truncate,
    \Com\Tecnick\Pdf\TextFitMode::Stretch,
    \Com\Tecnick\Pdf\TextFitMode::ShrinkFont,
    \Com\Tecnick\Pdf\TextFitMode::Off,
];
$modeY = 40;

foreach ($modesL as $mode) {
    $label = $mode === \Com\Tecnick\Pdf\TextFitMode::Off ? 'fit=(disabled)' : 'fit=' . $mode->value;

    $pdf->page->addContent($pdf->getTextCell(
        txt: $label,
        posx: 15,
        posy: $modeY,
        width: 24,
        height: 6,
        valign: \Com\Tecnick\Pdf\TextVAlign::Top,
        halign: \Com\Tecnick\Pdf\TextHAlign::Right,
    ));

    // one line
    $pdf->page->addContent($pdf->getTextCell(
        txt: $longSample,
        posx: 41,
        posy: $modeY,
        width: 160,
        height: 5,
        valign: \Com\Tecnick\Pdf\TextVAlign::Top,
        halign: \Com\Tecnick\Pdf\TextHAlign::Left,
        styles: $cellStyle,
        fit: $mode,
    ));

    // multiple lines
    $pdf->page->addContent($pdf->getTextCell(
        txt: $longSample,
        posx: 41,
        posy: $modeY + 8,
        width: 80,
        height: 10,
        valign: \Com\Tecnick\Pdf\TextVAlign::Top,
        halign: \Com\Tecnick\Pdf\TextHAlign::Left,
        styles: $cellStyle,
        fit: $mode,
    ));

    $modeY += 25;
}

// ----------

$page = $pdf->addPage();
$pid = $page['pid'];

$pdf->page->addContent($titleFont['out']);
$pdf->page->addContent($pdf->getTextCell(
    txt: 'addTextCell() fit mode',
    posx: 15,
    posy: 15,
    valign: \Com\Tecnick\Pdf\TextVAlign::Top,
    halign: \Com\Tecnick\Pdf\TextHAlign::Left,
));

$pdf->page->addContent($baseFont['out']);

$pdf->page->addContent($pdf->getTextCell(
    txt: 'Long text scenario (overflow):',
    posx: 15,
    posy: 30,
    valign: \Com\Tecnick\Pdf\TextVAlign::Top,
    halign: \Com\Tecnick\Pdf\TextHAlign::Left,
));

$modeY = 40;

foreach ($modesL as $mode) {
    $label = $mode === \Com\Tecnick\Pdf\TextFitMode::Off ? 'fit=(disabled)' : 'fit=' . $mode->value;

    $pdf->page->addContent($pdf->getTextCell(
        txt: $label,
        posx: 15,
        posy: $modeY,
        width: 24,
        height: 6,
        valign: \Com\Tecnick\Pdf\TextVAlign::Top,
        halign: \Com\Tecnick\Pdf\TextHAlign::Right,
    ));

    // one line
    $pdf->addTextCell(
        txt: $longSample,
        pid: $pid,
        posx: 41,
        posy: $modeY,
        width: 160,
        height: 5,
        valign: \Com\Tecnick\Pdf\TextVAlign::Top,
        halign: \Com\Tecnick\Pdf\TextHAlign::Left,
        styles: $cellStyle,
        fit: $mode,
    );

    // multiple lines
    $pdf->addTextCell(
        txt: $longSample,
        pid: $pid,
        posx: 41,
        posy: $modeY + 8,
        width: 80,
        height: 10,
        valign: \Com\Tecnick\Pdf\TextVAlign::Top,
        halign: \Com\Tecnick\Pdf\TextHAlign::Left,
        styles: $cellStyle,
        fit: $mode,
    );

    $modeY += 25;
}

// ----------
// /\/\/\/\/\
// ----------

$pdf->addPage();
$pdf->page->addContent($titleFont['out']);
$pdf->page->addContent($pdf->getTextCell(
    txt: 'getTextCell() fit mode long word (hyphenated)',
    posx: 15,
    posy: 15,
    width: 180,
    valign: \Com\Tecnick\Pdf\TextVAlign::Top,
    halign: \Com\Tecnick\Pdf\TextHAlign::Left,
));

$baseFont = $pdf->font->insert($pdf->pon, 'helvetica', '', 11);

$cellStyle = [
    'all' => [
        'lineWidth' => 0.3,
        'lineCap' => 'butt',
        'lineJoin' => 'miter',
        'dashArray' => [],
        'dashPhase' => 0,
        'lineColor' => '#4a5b70',
        'fillColor' => '#ffffff',
    ],
];

$pdf->page->addContent($baseFont['out']);

$pdf->page->addContent($pdf->getTextCell(
    txt: 'Long word scenario (overflow):',
    posx: 15,
    posy: 30,
    valign: \Com\Tecnick\Pdf\TextVAlign::Top,
    halign: \Com\Tecnick\Pdf\TextHAlign::Left,
));

// Define a custom hyphenation pattern that splits a word after each character.
// See loadTexHyphenPatterns() for language-specific hyphenation patterns.
$singleCharPattern = [];
foreach (range('a', 'z') as $letter) {
    $singleCharPattern[$letter] = $letter . '1';
}
$pdf->setTexHyphenPatterns(patterns: $singleCharPattern);

$longWord = 'Loremipsumdolorsitametconsecteturadipiscingelitseddoeiusmodtemporincididuntutlaboreetdoloremagnaaliqua.';
$modesL = [
    \Com\Tecnick\Pdf\TextFitMode::Truncate,
    \Com\Tecnick\Pdf\TextFitMode::Stretch,
    \Com\Tecnick\Pdf\TextFitMode::ShrinkFont,
    \Com\Tecnick\Pdf\TextFitMode::Off,
];
$modeY = 40;

foreach ($modesL as $mode) {
    $label = $mode === \Com\Tecnick\Pdf\TextFitMode::Off ? 'fit=(disabled)' : 'fit=' . $mode->value;

    $pdf->page->addContent($pdf->getTextCell(
        txt: $label,
        posx: 15,
        posy: $modeY,
        width: 24,
        height: 6,
        valign: \Com\Tecnick\Pdf\TextVAlign::Top,
        halign: \Com\Tecnick\Pdf\TextHAlign::Right,
    ));

    // one line
    $pdf->page->addContent($pdf->getTextCell(
        txt: $longWord,
        posx: 41,
        posy: $modeY,
        width: 160,
        height: 5,
        valign: \Com\Tecnick\Pdf\TextVAlign::Top,
        halign: \Com\Tecnick\Pdf\TextHAlign::Left,
        styles: $cellStyle,
        fit: $mode,
    ));

    // multiple lines
    $pdf->page->addContent($pdf->getTextCell(
        txt: $longWord,
        posx: 41,
        posy: $modeY + 8,
        width: 80,
        height: 10,
        valign: \Com\Tecnick\Pdf\TextVAlign::Top,
        halign: \Com\Tecnick\Pdf\TextHAlign::Left,
        styles: $cellStyle,
        fit: $mode,
    ));

    $modeY += 25;
}

// ----------

$page = $pdf->addPage();
$pid = $page['pid'];

$pdf->page->addContent($titleFont['out']);
$pdf->page->addContent($pdf->getTextCell(
    txt: 'addTextCell() fit mode long word (hyphenated)',
    posx: 15,
    posy: 15,
    width: 180,
    valign: \Com\Tecnick\Pdf\TextVAlign::Top,
    halign: \Com\Tecnick\Pdf\TextHAlign::Left,
));

$pdf->page->addContent($baseFont['out']);

$pdf->page->addContent($pdf->getTextCell(
    txt: 'Long word scenario (overflow):',
    posx: 15,
    posy: 30,
    valign: \Com\Tecnick\Pdf\TextVAlign::Top,
    halign: \Com\Tecnick\Pdf\TextHAlign::Left,
));

$modeY = 40;

foreach ($modesL as $mode) {
    $label = $mode === \Com\Tecnick\Pdf\TextFitMode::Off ? 'fit=(disabled)' : 'fit=' . $mode->value;

    $pdf->page->addContent($pdf->getTextCell(
        txt: $label,
        posx: 15,
        posy: $modeY,
        width: 24,
        height: 6,
        valign: \Com\Tecnick\Pdf\TextVAlign::Top,
        halign: \Com\Tecnick\Pdf\TextHAlign::Right,
    ));

    // one line
    $pdf->addTextCell(
        txt: $longWord,
        pid: $pid,
        posx: 41,
        posy: $modeY,
        width: 160,
        height: 5,
        valign: \Com\Tecnick\Pdf\TextVAlign::Top,
        halign: \Com\Tecnick\Pdf\TextHAlign::Left,
        styles: $cellStyle,
        fit: $mode,
    );

    // multiple lines
    $pdf->addTextCell(
        txt: $longWord,
        pid: $pid,
        posx: 41,
        posy: $modeY + 8,
        width: 80,
        height: 10,
        valign: \Com\Tecnick\Pdf\TextVAlign::Top,
        halign: \Com\Tecnick\Pdf\TextHAlign::Left,
        styles: $cellStyle,
        fit: $mode,
    );

    $modeY += 25;
}

// ----------

$rawpdf = $pdf->getOutPDFString();
$pdf->renderPDF(rawpdf: $rawpdf);