152 lines
5.0 KiB
PHP
152 lines
5.0 KiB
PHP
|
<?php
|
||
|
|
|
||
|
|
/**
|
||
|
|
* E037_image_methods.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.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: 037');
|
||
|
|
$pdf->setTitle('Image Methods');
|
||
|
|
$pdf->setKeywords('TCPDF tc-lib-pdf image methods jpeg png svg placement scaling');
|
||
|
|
$pdf->setPDFFilename('037_image_methods.pdf');
|
||
|
|
|
||
|
|
$pdf->setViewerPreferences(['DisplayDocTitle' => true]);
|
||
|
|
|
||
|
|
$pdf->enableDefaultPageContent();
|
||
|
|
|
||
|
|
// ----------
|
||
|
|
// Insert fonts
|
||
|
|
|
||
|
|
$bfont1 = $pdf->font->insert($pdf->pon, 'helvetica', '', 12);
|
||
|
|
|
||
|
|
// test images directory
|
||
|
|
$imgdir = \realpath(__DIR__ . '/../vendor/tecnickcom/tc-lib-pdf-image/test/images/');
|
||
|
|
|
||
|
|
// ----------
|
||
|
|
// Add first page
|
||
|
|
|
||
|
|
$page01 = $pdf->addPage();
|
||
|
|
|
||
|
|
$html = <<<HTML
|
||
|
|
<h1 style="font-size:16pt; color:#003366;">Image Methods</h1>
|
||
|
|
<p style="font-size:9pt; color:#333333;">
|
||
|
|
This example shows how to place JPEG and PNG images with different color models and transparency.
|
||
|
|
</p>
|
||
|
|
HTML;
|
||
|
|
|
||
|
|
$pdf->addHTMLCell(html: $html, posx: 15, posy: 15, width: 180);
|
||
|
|
|
||
|
|
$posx = 5;
|
||
|
|
$posy = 40;
|
||
|
|
|
||
|
|
// Cell grid geometry: 5 columns, each sample rendered $cellw units wide.
|
||
|
|
$cellw = 40;
|
||
|
|
$rowh = 20;
|
||
|
|
$cols = 5;
|
||
|
|
|
||
|
|
// Sample images exercising different color models and transparency.
|
||
|
|
$samples = [
|
||
|
|
'200x100_CMYK.jpg', // CMYK JPEG sample.
|
||
|
|
'200x100_GRAY.jpg', // Grayscale JPEG sample.
|
||
|
|
'200x100_GRAY.png', // Grayscale PNG sample.
|
||
|
|
'200x100_INDEX16.png', // Indexed-color PNG with a 16-color palette.
|
||
|
|
'200x100_INDEX256.png', // Indexed-color PNG with a 256-color palette.
|
||
|
|
'200x100_INDEXALPHA.png', // Indexed-color PNG with alpha transparency.
|
||
|
|
'200x100_RGB.jpg', // RGB JPEG sample.
|
||
|
|
'200x100_RGB.png', // RGB PNG sample.
|
||
|
|
'200x100_RGBALPHA.png', // RGB PNG with alpha transparency.
|
||
|
|
'200x100_RGBICC.jpg', // RGB JPEG carrying an ICC color profile.
|
||
|
|
'200x100_RGBICC.png', // RGB PNG carrying an ICC color profile.
|
||
|
|
'200x100_RGBINT.png', // RGB PNG variant (alternate RGB image path).
|
||
|
|
];
|
||
|
|
|
||
|
|
// Add Images
|
||
|
|
//
|
||
|
|
// Each sample is rendered preserving its original aspect ratio: only the target
|
||
|
|
// width is provided and the matching height is computed directly from the
|
||
|
|
// intrinsic image size by image->getImageDimensionsByKey().
|
||
|
|
foreach ($samples as $index => $name) {
|
||
|
|
$file = $imgdir . '/' . $name;
|
||
|
|
|
||
|
|
// Import the image; add() returns the image instance ID used for placement.
|
||
|
|
$iid = $pdf->image->add($file);
|
||
|
|
|
||
|
|
// Resolve the cache key for the imported image.
|
||
|
|
$key = $pdf->image->getKey($file);
|
||
|
|
|
||
|
|
// Derive the rendered dimensions from the intrinsic image size: a single
|
||
|
|
// target side (width) is given and the other (height) is computed to
|
||
|
|
// preserve the original aspect ratio.
|
||
|
|
$dim = $pdf->image->getImageDimensionsByKey($key, $cellw);
|
||
|
|
|
||
|
|
$col = $index % $cols;
|
||
|
|
$row = \intdiv($index, $cols);
|
||
|
|
$imgx = $posx + ($col * $cellw);
|
||
|
|
$imgy = $posy + ($row * $rowh);
|
||
|
|
|
||
|
|
$out = $pdf->image->getSetImage($iid, $imgx, $imgy, $dim['width'], $dim['height'], $page01['height']);
|
||
|
|
$pdf->page->addContent($out);
|
||
|
|
}
|
||
|
|
|
||
|
|
// getImageDimensionsByKey() supports additional resolution modes, for example:
|
||
|
|
// $pdf->image->getImageDimensionsByKey($key); // original pixel size
|
||
|
|
// $pdf->image->getImageDimensionsByKey($key, 0, 30); // derive width from height
|
||
|
|
// $pdf->image->getImageDimensionsByKey($key, 40, 40, true); // scale to fit a 40x40 box
|
||
|
|
|
||
|
|
// =============================================================
|
||
|
|
|
||
|
|
// ----------
|
||
|
|
// 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);
|