summaryrefslogtreecommitdiffstats
path: root/vendor/iio/libmergepdf/tcpdi/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'vendor/iio/libmergepdf/tcpdi/README.md')
-rw-r--r--vendor/iio/libmergepdf/tcpdi/README.md65
1 files changed, 65 insertions, 0 deletions
diff --git a/vendor/iio/libmergepdf/tcpdi/README.md b/vendor/iio/libmergepdf/tcpdi/README.md
new file mode 100644
index 0000000..73aa22c
--- /dev/null
+++ b/vendor/iio/libmergepdf/tcpdi/README.md
@@ -0,0 +1,65 @@
+TCPDI
+=====
+
+Composer ready TCPDI with PDF annotations handling.
+
+Imported from https://github.com/RafikHaceb/tcpdi
+
+PDF importer for [TCPDF](http://www.tcpdf.org/), based on [FPDI](http://www.setasign.de/products/pdf-php-solutions/fpdi/).
+Requires [pauln/tcpdi_parser](https://github.com/pauln/tcpdi_parser) and [FPDF_TPL](http://www.setasign.de/products/pdf-php-solutions/fpdi/downloads/)
+which included in the repository.
+
+Usage
+-----
+
+Usage is essentially the same as FPDI, except importing TCPDI rather than FPDI. It also has a "setSourceData()" function which accepts raw PDF data, for cases where the file does not reside on disk or is not readable by TCPDI.
+
+```php
+// Create new PDF document.
+$pdf = new TCPDI(PDF_PAGE_ORIENTATION, PDF_UNIT, PDF_PAGE_FORMAT, true, 'UTF-8', false);
+
+// Add a page from a PDF by file path.
+$pdf->AddPage();
+$pdf->setSourceFile('/path/to/file-to-import.pdf');
+$idx = $pdf->importPage(1);
+$pdf->useTemplate($idx);
+
+$pdfdata = file_get_contents('/path/to/other-file.pdf'); // Simulate only having raw data available.
+$pagecount = $pdf->setSourceData($pdfdata);
+for ($i = 1; $i <= $pagecount; $i++) {
+ $tplidx = $pdf->importPage($i);
+ $pdf->AddPage();
+ $pdf->useTemplate($tplidx);
+}
+```
+
+As of version 1.1, TCPDI also includes additional functionality for handling PDF Annotations. As annotations are positioned relative to the bleed box rather than the crop box, you'll need to ensure that you're importing the full bleed box; a new function has also been introduced to set the page format (the various boxes, including the crop box) from the imported page, so that the imported page matches the original better. The following example demonstrates this:
+
+```php
+// Create new PDF document.
+$pdf = new TCPDI(PDF_PAGE_ORIENTATION, PDF_UNIT, PDF_PAGE_FORMAT, true, 'UTF-8', false);
+
+// Add a page from a PDF by file path.
+$pdf->setSourceFile('/path/to/file-to-import.pdf');
+
+// Import the bleed box (default is crop box) for page 1.
+$tplidx = $pdf->importPage(1, '/BleedBox');
+$size = $pdf->getTemplatesize($tplidx);
+$orientation = ($size['w'] > $size['h']) ? 'L' : 'P';
+
+$pdf->AddPage($orientation);
+
+// Set page boxes from imported page 1.
+$pdf->setPageFormatFromTemplatePage(1, $orientation);
+
+// Import the content for page 1.
+$pdf->useTemplate($tplidx);
+
+// Import the annotations for page 1.
+$pdf->importAnnotations(1);
+```
+
+TCPDI_PARSER
+============
+
+Parser for use with TCPDI, based on TCPDF_PARSER. Supports PDFs up to v1.7.