. */ declare(strict_types=1); namespace Fisharebest\Webtrees\Report; use Fisharebest\Webtrees\MediaFile; use Fisharebest\Webtrees\Webtrees; use League\Flysystem\FilesystemOperator; use function count; /** * Class PdfRenderer */ class PdfRenderer extends AbstractRenderer { /** * PDF compression - Zlib extension is required * * @var bool const */ private const COMPRESSION = true; /** * If true reduce the RAM memory usage by caching temporary data on filesystem (slower). * * @var bool const */ private const DISK_CACHE = false; /** * true means that the input text is unicode (PDF) * * @var bool const */ private const UNICODE = true; /** * false means that the full font is embedded, true means only the used chars * in TCPDF v5.9 font subsetting is a very slow process, this leads to larger files * * @var bool const */ private const SUBSETTING = false; /** * @var TcpdfWrapper */ public $tcpdf; /** @var ReportBaseElement[] Array of elements in the header */ public $headerElements = []; /** @var ReportBaseElement[] Array of elements in the footer */ public $footerElements = []; /** @var ReportBaseElement[] Array of elements in the body */ public $bodyElements = []; /** @var ReportPdfFootnote[] Array of elements in the footer notes */ public $printedfootnotes = []; /** @var string Currently used style name */ public $currentStyle = ''; /** @var float The last cell height */ public $lastCellHeight = 0; /** @var float The largest font size within a TextBox to calculate the height */ public $largestFontHeight = 0; /** @var int The last pictures page number */ public $lastpicpage = 0; /** @var PdfRenderer The current report. */ public $wt_report; /** * PDF Header -PDF * * @return void */ public function header(): void { foreach ($this->headerElements as $element) { if ($element instanceof ReportBaseElement) { $element->render($this); } elseif ($element === 'footnotetexts') { $this->footnotes(); } elseif ($element === 'addpage') { $this->newPage(); } } } /** * PDF Body -PDF * * @return void */ public function body(): void { $this->tcpdf->AddPage(); foreach ($this->bodyElements as $key => $element) { if ($element instanceof ReportBaseElement) { $element->render($this); } elseif ($element === 'footnotetexts') { $this->footnotes(); } elseif ($element === 'addpage') { $this->newPage(); } } } /** * PDF Footnotes -PDF * * @return void */ public function footnotes(): void { foreach ($this->printedfootnotes as $element) { if ($this->tcpdf->GetY() + $element->getFootnoteHeight($this) > $this->tcpdf->getPageHeight()) { $this->tcpdf->AddPage(); } $element->renderFootnote($this); if ($this->tcpdf->GetY() > $this->tcpdf->getPageHeight()) { $this->tcpdf->AddPage(); } } } /** * PDF Footer -PDF * * @return void */ public function footer(): void { foreach ($this->footerElements as $element) { if ($element instanceof ReportBaseElement) { $element->render($this); } elseif ($element === 'footnotetexts') { $this->footnotes(); } elseif ($element === 'addpage') { $this->newPage(); } } } /** * Add an element to the Header -PDF * * @param ReportBaseElement|string $element * * @return void */ public function addHeader($element): void { $this->headerElements[] = $element; } /** * Add an element to the Body -PDF * * @param ReportBaseElement|string $element * * @return void */ public function addBody($element): void { $this->bodyElements[] = $element; } /** * Add an element to the Footer -PDF * * @param ReportBaseElement|string $element * * @return void */ public function addFooter($element): void { $this->footerElements[] = $element; } /** * Remove the header. * * @param int $index * * @return void */ public function removeHeader(int $index): void { unset($this->headerElements[$index]); } /** * Remove the body. * * @param int $index * * @return void */ public function removeBody(int $index): void { unset($this->bodyElements[$index]); } /** * Remove the footer. * * @param int $index * * @return void */ public function removeFooter(int $index): void { unset($this->footerElements[$index]); } /** * Clear the Header -PDF * * @return void */ public function clearHeader(): void { unset($this->headerElements); $this->headerElements = []; } /** * Set the report. * * @param PdfRenderer $report * * @return void */ public function setReport(PdfRenderer $report): void { $this->wt_report = $report; } /** * Get the currently used style name -PDF * * @return string */ public function getCurrentStyle(): string { return $this->currentStyle; } /** * Setup a style for usage -PDF * * @param string $s Style name * * @return void */ public function setCurrentStyle(string $s): void { $this->currentStyle = $s; $style = $this->wt_report->getStyle($s); $this->tcpdf->SetFont($style['font'], $style['style'], $style['size']); } /** * Get the style -PDF * * @param string $s Style name * * @return array */ public function getStyle(string $s): array { if (!isset($this->wt_report->styles[$s])) { $s = $this->getCurrentStyle(); $this->wt_report->styles[$s] = $s; } return $this->wt_report->styles[$s]; } /** * Add margin when static horizontal position is used -PDF * RTL supported * * @param float $x Static position * * @return float */ public function addMarginX(float $x): float { $m = $this->tcpdf->getMargins(); if ($this->tcpdf->getRTL()) { $x += $m['right']; } else { $x += $m['left']; } $this->tcpdf->SetX($x); return $x; } /** * Get the maximum line width to draw from the curren position -PDF * RTL supported * * @return float */ public function getMaxLineWidth(): float { $m = $this->tcpdf->getMargins(); if ($this->tcpdf->getRTL()) { return $this->tcpdf->getRemainingWidth() + $m['right']; } return $this->tcpdf->getRemainingWidth() + $m['left']; } /** * Get the height of the footnote. * * @return float */ public function getFootnotesHeight(): float { $h = 0; foreach ($this->printedfootnotes as $element) { $h += $element->getHeight($this); } return $h; } /** * Returns the the current font size height -PDF * * @return float */ public function getCurrentStyleHeight(): float { if ($this->currentStyle === '') { return $this->wt_report->default_font_size; } $style = $this->wt_report->getStyle($this->currentStyle); return (float) $style['size']; } /** * Checks the Footnote and numbers them * * @param ReportPdfFootnote $footnote * * @return ReportPdfFootnote|bool object if already numbered, false otherwise */ public function checkFootnote(ReportPdfFootnote $footnote) { $ct = count($this->printedfootnotes); $val = $footnote->getValue(); $i = 0; while ($i < $ct) { if ($this->printedfootnotes[$i]->getValue() == $val) { // If this footnote already exist then set up the numbers for this object $footnote->setNum($i + 1); $footnote->setAddlink((string) ($i + 1)); return $this->printedfootnotes[$i]; } $i++; } // If this Footnote has not been set up yet $footnote->setNum($ct + 1); $footnote->setAddlink((string) $this->tcpdf->AddLink()); $this->printedfootnotes[] = $footnote; return false; } /** * Used this function instead of AddPage() * This function will make sure that images will not be overwritten * * @return void */ public function newPage(): void { if ($this->lastpicpage > $this->tcpdf->getPage()) { $this->tcpdf->setPage($this->lastpicpage); } $this->tcpdf->AddPage(); } /** * Add a page if needed -PDF * * @param float $height Cell height * * @return bool true in case of page break, false otherwise */ public function checkPageBreakPDF(float $height): bool { return $this->tcpdf->checkPageBreak($height); } /** * Returns the remaining width between the current position and margins -PDF * * @return float Remaining width */ public function getRemainingWidthPDF(): float { return $this->tcpdf->getRemainingWidth(); } /** * PDF Setup - ReportPdf * * @return void */ public function setup(): void { parent::setup(); // Setup the PDF class with custom size pages because WT supports more page sizes. If WT sends an unknown size name then the default would be A4 $this->tcpdf = new TcpdfWrapper($this->orientation, parent::UNITS, [ $this->page_width, $this->page_height, ], self::UNICODE, 'UTF-8', self::DISK_CACHE); // Setup the PDF margins $this->tcpdf->SetMargins($this->left_margin, $this->top_margin, $this->right_margin); $this->tcpdf->setHeaderMargin($this->header_margin); $this->tcpdf->setFooterMargin($this->footer_margin); //Set auto page breaks $this->tcpdf->SetAutoPageBreak(true, $this->bottom_margin); // Set font subsetting $this->tcpdf->setFontSubsetting(self::SUBSETTING); // Setup PDF compression $this->tcpdf->SetCompression(self::COMPRESSION); // Setup RTL support $this->tcpdf->setRTL($this->rtl); // Set the document information $this->tcpdf->SetCreator(Webtrees::NAME . ' ' . Webtrees::VERSION); $this->tcpdf->SetAuthor($this->rauthor); $this->tcpdf->SetTitle($this->title); $this->tcpdf->SetSubject($this->rsubject); $this->tcpdf->SetKeywords($this->rkeywords); $this->tcpdf->SetHeaderData('', 0, $this->title); $this->tcpdf->setHeaderFont([$this->default_font, '', $this->default_font_size]); $this->setReport($this); if ($this->show_generated_by) { // The default style name for Generated by.... is 'genby' $element = new ReportPdfCell(0, 10, 0, 'C', '', 'genby', 1, ReportBaseElement::CURRENT_POSITION, ReportBaseElement::CURRENT_POSITION, 0, 0, '', '', true); $element->addText($this->generated_by); $element->setUrl(Webtrees::URL); $this->addFooter($element); } } /** * Add an element. * * @param ReportBaseElement|string $element * * @return void */ public function addElement($element): void { if ($this->processing === 'B') { $this->addBody($element); return; } if ($this->processing === 'H') { $this->addHeader($element); return; } if ($this->processing === 'F') { $this->addFooter($element); return; } } /** * Run the report. * * @return void */ public function run(): void { $this->body(); echo $this->tcpdf->Output('doc.pdf', 'S'); } /** * Create a new Cell object. * * @param int $width cell width (expressed in points) * @param int $height cell height (expressed in points) * @param mixed $border Border style * @param string $align Text alignement * @param string $bgcolor Background color code * @param string $style The name of the text style * @param int $ln Indicates where the current position should go after the call * @param mixed $top Y-position * @param mixed $left X-position * @param int $fill Indicates if the cell background must be painted (1) or transparent (0). Default value: 1 * @param int $stretch Stretch carachter mode * @param string $bocolor Border color * @param string $tcolor Text color * @param bool $reseth * * @return ReportBaseCell */ public function createCell(int $width, int $height, $border, string $align, string $bgcolor, string $style, int $ln, $top, $left, int $fill, int $stretch, string $bocolor, string $tcolor, bool $reseth): ReportBaseCell { return new ReportPdfCell($width, $height, $border, $align, $bgcolor, $style, $ln, $top, $left, $fill, $stretch, $bocolor, $tcolor, $reseth); } /** * Create a new TextBox object. * * @param float $width Text box width * @param float $height Text box height * @param bool $border * @param string $bgcolor Background color code in HTML * @param bool $newline * @param float $left * @param float $top * @param bool $pagecheck * @param string $style * @param bool $fill * @param bool $padding * @param bool $reseth * * @return ReportBaseTextbox */ public function createTextBox( float $width, float $height, bool $border, string $bgcolor, bool $newline, float $left, float $top, bool $pagecheck, string $style, bool $fill, bool $padding, bool $reseth ): ReportBaseTextbox { return new ReportPdfTextBox($width, $height, $border, $bgcolor, $newline, $left, $top, $pagecheck, $style, $fill, $padding, $reseth); } /** * Create a text element. * * @param string $style * @param string $color * * @return ReportBaseText */ public function createText(string $style, string $color): ReportBaseText { return new ReportPdfText($style, $color); } /** * Create a new Footnote object. * * @param string $style Style name * * @return ReportBaseFootnote */ public function createFootnote(string $style): ReportBaseFootnote { return new ReportPdfFootnote($style); } /** * Create a new image object. * * @param string $file Filename * @param float $x * @param float $y * @param float $w Image width * @param float $h Image height * @param string $align L:left, C:center, R:right or empty to use x/y * @param string $ln T:same line, N:next line * * @return ReportBaseImage */ public function createImage(string $file, float $x, float $y, float $w, float $h, string $align, string $ln): ReportBaseImage { return new ReportPdfImage($file, $x, $y, $w, $h, $align, $ln); } /** * Create a new image object from Media Object. * * @param MediaFile $media_file * @param float $x * @param float $y * @param float $w Image width * @param float $h Image height * @param string $align L:left, C:center, R:right or empty to use x/y * @param string $ln T:same line, N:next line * @param FilesystemOperator $data_filesystem * * @return ReportBaseImage */ public function createImageFromObject( MediaFile $media_file, float $x, float $y, float $w, float $h, string $align, string $ln, FilesystemOperator $data_filesystem ): ReportBaseImage { return new ReportPdfImage('@' . $media_file->fileContents($data_filesystem), $x, $y, $w, $h, $align, $ln); } /** * Create a line. * * @param float $x1 * @param float $y1 * @param float $x2 * @param float $y2 * * @return ReportBaseLine */ public function createLine(float $x1, float $y1, float $x2, float $y2): ReportBaseLine { return new ReportPdfLine($x1, $y1, $x2, $y2); } }