cleanup examples

nicolaasuni · nicolaasuni · commit ad018e24c35b · 2026-05-09T18:53:09.000+01:00
diff --git a/VERSION b/VERSION
@@ -1 +1 @@
-8.19.0
+8.19.1
diff --git a/examples/E001_invoice.php b/examples/E001_invoice.php
@@ -41,7 +41,7 @@
 $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 example');
+$pdf->setKeywords('TCPDF tc-lib-pdf invoice Factur-X ZUGFeRD e-invoice XML');
 $pdf->setPDFFilename('001_invoice.pdf');
 
 $pdf->setViewerPreferences(['DisplayDocTitle' => true]);
diff --git a/examples/E002_font_dump.php b/examples/E002_font_dump.php
@@ -39,8 +39,8 @@
 $pdf->setCreator('tc-lib-pdf');
 $pdf->setAuthor('Nicola Asuni');
 $pdf->setSubject('tc-lib-pdf example: 002');
-$pdf->setTitle('Example');
-$pdf->setKeywords('TCPDF tc-lib-pdf example');
+$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]);
diff --git a/examples/E003_persian_arabic.php b/examples/E003_persian_arabic.php
@@ -39,8 +39,8 @@
 $pdf->setCreator('tc-lib-pdf');
 $pdf->setAuthor('Nicola Asuni');
 $pdf->setSubject('tc-lib-pdf example: 003');
-$pdf->setTitle('Example');
-$pdf->setKeywords('TCPDF tc-lib-pdf example');
+$pdf->setTitle('Persian and Arabic Text Rendering');
+$pdf->setKeywords('TCPDF tc-lib-pdf persian arabic rtl bidi unicode shaping');
 $pdf->setPDFFilename('003_persian_arabic.pdf');
 
 $pdf->setViewerPreferences(['DisplayDocTitle' => true]);
diff --git a/examples/E004_page_formats.php b/examples/E004_page_formats.php
@@ -39,8 +39,8 @@
 $pdf->setCreator('tc-lib-pdf');
 $pdf->setAuthor('Nicola Asuni');
 $pdf->setSubject('tc-lib-pdf example: 004');
-$pdf->setTitle('Example');
-$pdf->setKeywords('TCPDF tc-lib-pdf example');
+$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]);
diff --git a/examples/E006_minimal.php b/examples/E006_minimal.php
@@ -24,6 +24,13 @@
 // 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);
 
diff --git a/examples/E010_pdfx.php b/examples/E010_pdfx.php
@@ -18,6 +18,14 @@
 \define('K_PATH_FONTS', \realpath(__DIR__ . '/../vendor/tecnickcom/tc-lib-pdf-font/target/fonts'));
 
 $pdf = new \Com\Tecnick\Pdf\Tcpdf('mm', true, false, true, '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']);
diff --git a/examples/E011_pdfx1a.php b/examples/E011_pdfx1a.php
@@ -8,6 +8,14 @@
 \define('K_PATH_FONTS', \realpath(__DIR__ . '/../vendor/tecnickcom/tc-lib-pdf-font/target/fonts'));
 
 $pdf = new \Com\Tecnick\Pdf\Tcpdf('mm', true, false, true, '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']);
diff --git a/examples/E012_pdfx3.php b/examples/E012_pdfx3.php
@@ -8,6 +8,14 @@
 \define('K_PATH_FONTS', \realpath(__DIR__ . '/../vendor/tecnickcom/tc-lib-pdf-font/target/fonts'));
 
 $pdf = new \Com\Tecnick\Pdf\Tcpdf('mm', true, false, true, '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']);
diff --git a/examples/E013_pdfx4.php b/examples/E013_pdfx4.php
@@ -8,6 +8,14 @@
 \define('K_PATH_FONTS', \realpath(__DIR__ . '/../vendor/tecnickcom/tc-lib-pdf-font/target/fonts'));
 
 $pdf = new \Com\Tecnick\Pdf\Tcpdf('mm', true, false, true, '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');
+
 $font = $pdf->font->insert($pdf->pon, 'helvetica', '', 12);
 $pdf->addPage();
 $pdf->page->addContent($font['out']);
diff --git a/examples/E014_pdfx5.php b/examples/E014_pdfx5.php
@@ -8,6 +8,14 @@
 \define('K_PATH_FONTS', \realpath(__DIR__ . '/../vendor/tecnickcom/tc-lib-pdf-font/target/fonts'));
 
 $pdf = new \Com\Tecnick\Pdf\Tcpdf('mm', true, false, true, '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');
+
 $font = $pdf->font->insert($pdf->pon, 'helvetica', '', 12);
 $pdf->addPage();
 $pdf->page->addContent($font['out']);
diff --git a/examples/E015_pdfua.php b/examples/E015_pdfua.php
@@ -27,6 +27,8 @@
 \define('K_PATH_FONTS', \realpath(__DIR__ . '/../vendor/tecnickcom/tc-lib-pdf-font/target/fonts'));
 
 $pdf = new \Com\Tecnick\Pdf\Tcpdf('mm', true, false, true, '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');
diff --git a/examples/E016_pdfua1.php b/examples/E016_pdfua1.php
@@ -34,6 +34,8 @@
 \define('K_PATH_FONTS', \realpath(__DIR__ . '/../vendor/tecnickcom/tc-lib-pdf-font/target/fonts'));
 
 $pdf = new \Com\Tecnick\Pdf\Tcpdf('mm', true, false, true, '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');
diff --git a/examples/E017_pdfua2.php b/examples/E017_pdfua2.php
@@ -32,6 +32,8 @@
 \define('K_PATH_FONTS', \realpath(__DIR__ . '/../vendor/tecnickcom/tc-lib-pdf-font/target/fonts'));
 
 $pdf = new \Com\Tecnick\Pdf\Tcpdf('mm', true, false, true, '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');
diff --git a/examples/E018_html_page_span.php b/examples/E018_html_page_span.php
@@ -43,8 +43,8 @@
 $pdf->setCreator('tc-lib-pdf');
 $pdf->setAuthor('Nicola Asuni');
 $pdf->setSubject('tc-lib-pdf example: 018');
-$pdf->setTitle('Example');
-$pdf->setKeywords('TCPDF tc-lib-pdf example');
+$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]);
diff --git a/examples/E033_geometric_transformations.php b/examples/E033_geometric_transformations.php
@@ -42,9 +42,9 @@
 
 $pdf->setCreator('tc-lib-pdf');
 $pdf->setAuthor('Nicola Asuni');
-$pdf->setSubject('tc-lib-pdf example: 032');
-$pdf->setTitle('Example');
-$pdf->setKeywords('TCPDF tc-lib-pdf example');
+$pdf->setSubject('tc-lib-pdf example: 033');
+$pdf->setTitle('Geometric Transformations');
+$pdf->setKeywords('TCPDF tc-lib-pdf transformations rotate scale translate skew matrix');
 $pdf->setPDFFilename('033_geometric_transformations.pdf');
 
 $pdf->setViewerPreferences(['DisplayDocTitle' => true]);
diff --git a/examples/E034_color_gradient_mesh.php b/examples/E034_color_gradient_mesh.php
@@ -43,8 +43,8 @@
 $pdf->setCreator('tc-lib-pdf');
 $pdf->setAuthor('Nicola Asuni');
 $pdf->setSubject('tc-lib-pdf example: 034');
-$pdf->setTitle('Example');
-$pdf->setKeywords('TCPDF tc-lib-pdf example');
+$pdf->setTitle('Color Gradient Mesh');
+$pdf->setKeywords('TCPDF tc-lib-pdf color gradient mesh shading patch');
 $pdf->setPDFFilename('034_color_gradient_mesh.pdf');
 
 $pdf->setViewerPreferences(['DisplayDocTitle' => true]);
diff --git a/examples/E035_registration_marks.php b/examples/E035_registration_marks.php
@@ -43,8 +43,8 @@
 $pdf->setCreator('tc-lib-pdf');
 $pdf->setAuthor('Nicola Asuni');
 $pdf->setSubject('tc-lib-pdf example: 035');
-$pdf->setTitle('Example');
-$pdf->setKeywords('TCPDF tc-lib-pdf example');
+$pdf->setTitle('Registration Marks');
+$pdf->setKeywords('TCPDF tc-lib-pdf registration marks prepress crop bleed print');
 $pdf->setPDFFilename('035_registration_marks.pdf');
 
 $pdf->setViewerPreferences(['DisplayDocTitle' => true]);
diff --git a/examples/E036_graphic_methods.php b/examples/E036_graphic_methods.php
@@ -43,8 +43,8 @@
 $pdf->setCreator('tc-lib-pdf');
 $pdf->setAuthor('Nicola Asuni');
 $pdf->setSubject('tc-lib-pdf example: 036');
-$pdf->setTitle('Example');
-$pdf->setKeywords('TCPDF tc-lib-pdf example');
+$pdf->setTitle('Graphic Methods');
+$pdf->setKeywords('TCPDF tc-lib-pdf graphic methods lines curves polygons shapes');
 $pdf->setPDFFilename('036_graphic_methods.pdf');
 
 $pdf->setViewerPreferences(['DisplayDocTitle' => true]);
diff --git a/examples/E037_image_methods.php b/examples/E037_image_methods.php
@@ -42,8 +42,8 @@
 $pdf->setCreator('tc-lib-pdf');
 $pdf->setAuthor('Nicola Asuni');
 $pdf->setSubject('tc-lib-pdf example: 037');
-$pdf->setTitle('Example');
-$pdf->setKeywords('TCPDF tc-lib-pdf example');
+$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]);
diff --git a/examples/E038_image_clipping.php b/examples/E038_image_clipping.php
@@ -43,8 +43,8 @@
 $pdf->setCreator('tc-lib-pdf');
 $pdf->setAuthor('Nicola Asuni');
 $pdf->setSubject('tc-lib-pdf example: 038');
-$pdf->setTitle('Example');
-$pdf->setKeywords('TCPDF tc-lib-pdf example');
+$pdf->setTitle('Image Clipping');
+$pdf->setKeywords('TCPDF tc-lib-pdf image clipping masks clipping paths');
 $pdf->setPDFFilename('038_image_clipping.pdf');
 
 $pdf->setViewerPreferences(['DisplayDocTitle' => true]);
diff --git a/examples/E039_text_methods.php b/examples/E039_text_methods.php
@@ -43,8 +43,8 @@
 $pdf->setCreator('tc-lib-pdf');
 $pdf->setAuthor('Nicola Asuni');
 $pdf->setSubject('tc-lib-pdf example: 039');
-$pdf->setTitle('Example');
-$pdf->setKeywords('TCPDF tc-lib-pdf example');
+$pdf->setTitle('Text Methods');
+$pdf->setKeywords('TCPDF tc-lib-pdf text methods alignment spacing writing');
 $pdf->setPDFFilename('039_text_methods.pdf');
 
 $pdf->setViewerPreferences(['DisplayDocTitle' => true]);
diff --git a/examples/E040_annotation_form.php b/examples/E040_annotation_form.php
@@ -43,8 +43,8 @@
 $pdf->setCreator('tc-lib-pdf');
 $pdf->setAuthor('Nicola Asuni');
 $pdf->setSubject('tc-lib-pdf example: 040');
-$pdf->setTitle('Example');
-$pdf->setKeywords('TCPDF tc-lib-pdf example');
+$pdf->setTitle('Annotation Form Widgets');
+$pdf->setKeywords('TCPDF tc-lib-pdf annotations form widgets acroform fields');
 $pdf->setPDFFilename('040_annotation_form.pdf');
 
 $pdf->setViewerPreferences(['DisplayDocTitle' => true]);
diff --git a/examples/E041_layers_visibility.php b/examples/E041_layers_visibility.php
@@ -43,8 +43,8 @@
 $pdf->setCreator('tc-lib-pdf');
 $pdf->setAuthor('Nicola Asuni');
 $pdf->setSubject('tc-lib-pdf example: 041');
-$pdf->setTitle('Example');
-$pdf->setKeywords('TCPDF tc-lib-pdf example');
+$pdf->setTitle('Layer Visibility (OCG)');
+$pdf->setKeywords('TCPDF tc-lib-pdf layers visibility OCG optional content groups');
 $pdf->setPDFFilename('041_layers_visibility.pdf');
 
 $pdf->setViewerPreferences(['DisplayDocTitle' => true]);
diff --git a/examples/E042_html_form.php b/examples/E042_html_form.php
@@ -43,8 +43,8 @@
 $pdf->setCreator('tc-lib-pdf');
 $pdf->setAuthor('Nicola Asuni');
 $pdf->setSubject('tc-lib-pdf example: 042');
-$pdf->setTitle('Example');
-$pdf->setKeywords('TCPDF tc-lib-pdf example');
+$pdf->setTitle('HTML Form Elements');
+$pdf->setKeywords('TCPDF tc-lib-pdf html forms input select textarea rendering');
 $pdf->setPDFFilename('042_html_form.pdf');
 
 $pdf->setViewerPreferences(['DisplayDocTitle' => true]);
diff --git a/examples/E043_html_tables.php b/examples/E043_html_tables.php
@@ -43,8 +43,8 @@
 $pdf->setCreator('tc-lib-pdf');
 $pdf->setAuthor('Nicola Asuni');
 $pdf->setSubject('tc-lib-pdf example: 043');
-$pdf->setTitle('Example');
-$pdf->setKeywords('TCPDF tc-lib-pdf example');
+$pdf->setTitle('HTML Tables');
+$pdf->setKeywords('TCPDF tc-lib-pdf html tables thead tbody cell borders layout');
 $pdf->setPDFFilename('043_html_tables.pdf');
 
 $pdf->setViewerPreferences(['DisplayDocTitle' => true]);
diff --git a/examples/E044_toc_index.php b/examples/E044_toc_index.php
@@ -43,8 +43,8 @@
 $pdf->setCreator('tc-lib-pdf');
 $pdf->setAuthor('Nicola Asuni');
 $pdf->setSubject('tc-lib-pdf example: 044');
-$pdf->setTitle('Example');
-$pdf->setKeywords('TCPDF tc-lib-pdf example');
+$pdf->setTitle('Table of Contents and Index');
+$pdf->setKeywords('TCPDF tc-lib-pdf toc index bookmarks pagination');
 $pdf->setPDFFilename('044_toc_index.pdf');
 
 $pdf->setViewerPreferences(['DisplayDocTitle' => true]);
diff --git a/examples/E045_encryption_and_permissions.php b/examples/E045_encryption_and_permissions.php
@@ -50,8 +50,8 @@
 $pdf->setCreator('tc-lib-pdf');
 $pdf->setAuthor('Nicola Asuni');
 $pdf->setSubject('tc-lib-pdf example: 045');
-$pdf->setTitle('HTML Features Example');
-$pdf->setKeywords('TCPDF tc-lib-pdf example Encryption and Permissions');
+$pdf->setTitle('Encryption and Permissions');
+$pdf->setKeywords('TCPDF tc-lib-pdf encryption permissions user password owner password rights');
 $pdf->setPDFFilename('E045_encryption_and_permissions.pdf');
 
 $pdf->setViewerPreferences(['DisplayDocTitle' => true]);
diff --git a/examples/E063_manual_tag_tree.php b/examples/E063_manual_tag_tree.php
@@ -152,7 +152,7 @@
 $addDecorativeSeparator($pdf, $pid1, 16.0);
 
 // --- H1 heading ---
-$setFont($pdf, 'helvetica', 'B', 20);
+$setFont($pdf, 'helvetica', 'B', 16);
 
 $pdf->beginStructElem('H1', $pid1);
 $pdf->addTextCell(
diff --git a/examples/E065_import_single_page.php b/examples/E065_import_single_page.php
@@ -24,6 +24,12 @@
 // ---- Step 1: create a source PDF to import from ----
 
 $src = new \Com\Tecnick\Pdf\Tcpdf();
+$src->setCreator('tc-lib-pdf');
+$src->setAuthor('Nicola Asuni');
+$src->setSubject('tc-lib-pdf example: 065 source');
+$src->setTitle('Import Single Page - Source');
+$src->setKeywords('TCPDF tc-lib-pdf import single page source template');
+$src->setPDFFilename('065_import_single_page_src.pdf');
 $bfont = $src->font->insert($src->pon, 'helvetica', '', 14);
 
 $srcPage = $src->addPage();
@@ -35,6 +41,13 @@
 // ---- Step 2: create a new document and import the source page ----
 
 $pdf = new \Com\Tecnick\Pdf\Tcpdf();
+$pdf->setCreator('tc-lib-pdf');
+$pdf->setAuthor('Nicola Asuni');
+$pdf->setSubject('tc-lib-pdf example: 065');
+$pdf->setTitle('Import Single Page - Destination');
+$pdf->setKeywords('TCPDF tc-lib-pdf import single page destination cropbox template');
+$pdf->setPDFFilename('065_import_single_page.pdf');
+
 $bfont = $pdf->font->insert($pdf->pon, 'helvetica', '', 12);
 
 // Register the source document from its raw bytes.
diff --git a/examples/E066_import_document_append.php b/examples/E066_import_document_append.php
@@ -24,6 +24,13 @@
 // ---- Step 1: build a multi-page source PDF ----
 
 $src = new \Com\Tecnick\Pdf\Tcpdf();
+$src->setCreator('tc-lib-pdf');
+$src->setAuthor('Nicola Asuni');
+$src->setSubject('tc-lib-pdf example: 066 source');
+$src->setTitle('Import Document Append - Source');
+$src->setKeywords('TCPDF tc-lib-pdf import document append source template');
+$src->setPDFFilename('066_import_document_append_src.pdf');
+
 $bfont = $src->font->insert($src->pon, 'helvetica', '', 14);
 
 $pages = ['First page', 'Second page', 'Third page'];
@@ -44,6 +51,13 @@
 // ---- Step 2: create destination document with an intro page ----
 
 $pdf = new \Com\Tecnick\Pdf\Tcpdf();
+$pdf->setCreator('tc-lib-pdf');
+$pdf->setAuthor('Nicola Asuni');
+$pdf->setSubject('tc-lib-pdf example: 066');
+$pdf->setTitle('Import Document Append - Destination');
+$pdf->setKeywords('TCPDF tc-lib-pdf import append merge destination template');
+$pdf->setPDFFilename('066_import_document_append.pdf');
+
 $bfont = $pdf->font->insert($pdf->pon, 'helvetica', '', 12);
 
 $pdf->addPage();
diff --git a/examples/E067_import_page_region_nup.php b/examples/E067_import_page_region_nup.php
diff --git a/examples/E068_font_subset.php b/examples/E068_font_subset.php
diff --git a/examples/E069_html_line_height.php b/examples/E069_html_line_height.php
diff --git a/examples/E072_import_new_font.php b/examples/E072_import_new_font.php
diff --git a/examples/E073_css_supported_categories.php b/examples/E073_css_supported_categories.php
diff --git a/src/Base.php b/src/Base.php
