Fill with Rich-Text Styling
The PDF format itself supports rich-text formatting for text fields while this is currently not supported by the SetaPDF-FormFiller component.
But since version 2.41 SetaPDF comes with a rich- text block class that allows you to write text that is formatted by simple HTML tags and a subset of CSS onto a canvas object. You can use this feature to create an individual field appearance which can be used and also be flattened.
The PDF we use has also other fields for an individual header which are not filled in this demo (see here for how you can fill these fields with e.g. images). For simplicity, we only fill the "Description" field in this demo.
PHP
<?php
// load and register the autoload function
require_once __DIR__ . '/../../../../../bootstrap.php';
// get the main document isntance
$document = \SetaPDF_Core_Document::loadByFilename(
$assetsDirectory . '/pdfs/Fact-Sheet-form.pdf',
new \SetaPDF_Core_Writer_Http('Fact-Sheet.pdf', true)
);
// get an instance of the form filler
$formFiller = new \SetaPDF_FormFiller($document);
// get the form fields of the document
$fields = $formFiller->getFields();
// we only fill the "Description" field for demonstration purpose
$description = $fields->get('Description');
// access its annotation
$annotation = $description->getAnnotation();
// store the width and height for further calculations
$width = $annotation->getWidth();
$height = $annotation->getHeight();
// create a form xobject to which we are going to write the rich-text block
// this form xobject will be the resulting appearance of our form field
$xobject = \SetaPDF_Core_XObject_Form::create($document, [0, 0, $width, $height]);
// get the canvas for this xobject
$canvas = $xobject->getCanvas();
/* Font styles are done by using different font programs for each style. To
* benefit from font subsetting, we need to create a callback that will create
* the right font instances for us. See FontLoader.php for details:
*/
require_once $classesDirectory . '/FontLoader.php';
$fontLoader = new \com\setasign\SetaPDF\Demos\FontLoader($assetsDirectory);
// create a rich-text block instance
$textBlock = new \SetaPDF_Core_Text_RichTextBlock($document);
$textBlock->registerFontLoader($fontLoader);
$textBlock->setTextWidth($width - 4);
$textBlock->setPadding(2);
$textBlock->setDefaultFontFamily('DejaVuSans');
$textBlock->setDefaultFontSize(10);
$textBlock->setAlign(\SetaPDF_Core_Text::ALIGN_JUSTIFY);
// define and set its text
$text = <<<HTML
<span style="font-size:200%;line-height: 1">L</span>orem ipsum dolor sit amet, consetetur sadipscing elitr
m<sup>2</sup>, sed diam nonumy eirmod tempor invidunt ut labore et dolore <b>magna</b> aliquyam erat, sed diam
voluptua. At vero eos et accusam<sub>(rounded)</sub> et justo duo dolores et ea rebum. Stet <i>clita</i> kasd
gubergren, no sea takimata sanctus est Lorem <u>ipsum dolor sit amet</u>! Lorem ipsum dolor sit amet, consetetur
sadipscing elitr, sed diam nonumy eirmod tempor cam<span style="color:#e94e1c;">town</span> invidunt ut labore
et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet
clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. <b>Lorem</b> ipsum dolor sit amet,
consetetur sadipscing elitr, <u>sed diam nonumy <b>eirmod</b> tempor <i>invidunt</i></u> ut labore et dolore
magna aliquyam erat, sed diam voluptua. At <b><i>vero</i></b> eos et accusam et justo duo dolores et ea rebum.
Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet.<br />
<span style="font-size:200%;line-height: 1">O</span>rem ipsum dolor sit amet, consetetur sadipscing <b>elitr</b>,
sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et
cam<span style="color:#e94e1c;">town</span> accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren,
no sea <i>takimata</i> sanctus est Lorem <u>ipsum</u> dolor sit amet. Lorem ipsum dolor sit amet, consetetur
sadipscing elitr, sed diam nonumy <b>eirmod</b> tempor invidunt ut labore.
HTML;
$textBlock->setText($text);
// draw it onto the canvas
$textBlock->draw($canvas, 0, $height - $textBlock->getHeight());
// set the xobject as the appearance for the form field
$annotation->setAppearance($xobject);
// flatten all form fields
$fields->flatten();
$document->save()->finish();
PHP
<?php
namespace com\setasign\SetaPDF\Demos;
/**
* This is a simple, straight forward font-loader implementation.
* It should give you an idea of how to create your own.
*/
class FontLoader
{
/**
* @var \SetaPDF_Core_Font_Type0_Subset[]
*/
protected $loadedFonts = [];
/**
* @var string
*/
protected $assetsDirectory;
/**
* @param $assetsDirectory
* @param $loadedFonts
*/
public function __construct($assetsDirectory, &$loadedFonts = [])
{
$this->assetsDirectory = $assetsDirectory;
$this->loadedFonts = &$loadedFonts;
}
/**
* This is the method that is called when a font is requested.
*
* @param \SetaPDF_Core_Document $document
* @param string $fontFamily
* @param string $fontStyle
* @return \SetaPDF_Core_Font_Type0_Subset
*/
public function __invoke(\SetaPDF_Core_Document $document, $fontFamily, $fontStyle)
{
$cacheKey = $document->getInstanceIdent() . '_' . $fontFamily . '_' . $fontStyle;
if (!array_key_exists($cacheKey, $this->loadedFonts)) {
$dejaVufontPath = $this->assetsDirectory . '/fonts/DejaVu/ttf/DejaVuSans';
if ($fontFamily === 'DejaVuSans' && $fontStyle === 'B') {
$font = new \SetaPDF_Core_Font_Type0_Subset($document, $dejaVufontPath . '-Bold.ttf');
} elseif ($fontFamily === 'DejaVuSans' && $fontStyle === 'I') {
$font = new \SetaPDF_Core_Font_Type0_Subset($document, $dejaVufontPath . '-Oblique.ttf');
} elseif ($fontFamily === 'DejaVuSans' && $fontStyle === 'BI') {
$font = new \SetaPDF_Core_Font_Type0_Subset($document, $dejaVufontPath . '-BoldOblique.ttf');
} else {
$font = new \SetaPDF_Core_Font_Type0_Subset($document, $dejaVufontPath . '.ttf');
}
$this->loadedFonts[$cacheKey] = $font;
}
return $this->loadedFonts[$cacheKey];
}
}