Added new demo for features released in 2.48

public/demos/1-Core/analyze/check-for-digital-signatures/script.php

@@ -40,15 +40,15 @@
     $signatureFieldFound = true;
 
     $v = DictionaryHelper::resolveAttribute($fieldData, 'V');
-    if (!$v || !$v->ensure() instanceof PdfDictionary) {
+    if (!$v instanceof PdfDictionary) {
         echo ' But not digital signed.<br /><br />';
         continue;
     }
 
     echo ' Including a digital signature.<br />';
 
     // This is the signature value
-    $signatureData = $v->ensure()->getValue('Contents')->ensure()->getValue();
+    $signatureData = PdfHexString::ensureType(DictionaryHelper::getValue($v, 'Contents'))->getValue();
     $signatureData = rtrim($signatureData, "\0");
 
     echo '<a href="https://lapo.it/asn1js/#' . PdfHexString::str2hex($signatureData) . '" ' .
@@ -58,14 +58,14 @@
 
     echo '<br />';
 
-    $value = $v->ensure();
     $signatureProperties = [];
     foreach (['Name', 'Location', 'ContactInfo', 'Reason', 'M'] as $property) {
-        if (!$value->offsetExists($property)) {
+        $value = DictionaryHelper::getValue($v, $property);
+        if ($value === null) {
             continue;
         }
 
-        $propertyValue = $value->getValue($property)->ensure()->getValue();
+        $propertyValue = $value->getValue();
         if ($property === 'M') {
             $propertyValue = Date::stringToDateTime($propertyValue);
         } else {

public/demos/2-Extractor/filter/same-area-several-times/demo.json

@@ -0,0 +1,9 @@
+{
+    "name": "Filter Same Area Several Times",
+    "teaserText": "A demo that filters the same area several times to recognize a document type.",
+    "requires": [
+        "SetaPDF-Core", "SetaPDF-Extractor"
+    ],
+    "faIcon": "",
+    "faIcon2": ""
+}

public/demos/2-Extractor/filter/same-area-several-times/description.html

@@ -0,0 +1,10 @@
+<p>
+    If a filter is directly attached to a strategy each text-item will be checked against it and will exist only once
+    in the result.<br/>
+    If e.g. two rectangle filters are combine in a multifilter but share the same or overlapping area, only one
+    instance will get the text-items. This can lead to unexpected results.
+</p>
+<p>
+    This demo shows a way, to resolve all text-items once while filter them afterward several times to identify a
+    document type. The rectangle filters use almost the same area.
+</p>

public/demos/2-Extractor/filter/same-area-several-times/script.php

@@ -0,0 +1,66 @@
+<?php
+
+use setasign\SetaPDF2\Core\Document;
+use setasign\SetaPDF2\Core\Geometry\Rectangle;
+use setasign\SetaPDF2\Extractor\Extractor;
+use setasign\SetaPDF2\Extractor\Filter\RectangleFilter;
+use setasign\SetaPDF2\Extractor\Strategy\ExactPlainStrategy;
+
+// load and register the autoload function
+require_once __DIR__ . '/../../../../../bootstrap.php';
+
+$files = [
+    $assetsDirectory . '/pdfs/camtown/Terms-and-Conditions.pdf',
+    $assetsDirectory . '/pdfs/etown/Laboratory-Report.pdf',
+    $assetsDirectory . '/pdfs/lenstown/Subscription-tekMag.pdf',
+    $assetsDirectory . '/pdfs/Brand-Guide.pdf'
+];
+
+$path = displayFiles($files);
+
+$document = Document::loadByFilename($path);
+$extractor = new Extractor($document);
+
+$strategy = new ExactPlainStrategy();
+$extractor->setStrategy($strategy);
+
+// we prepare an initial filter to reduce the text item count
+$mainFilter = new RectangleFilter(new Rectangle(0, 752, 596, 649));
+$strategy->setFilter($mainFilter);
+
+$filters = [
+    'Laboratory Report' => new RectangleFilter(new Rectangle(36, 712, 240, 674)),
+    'Terms and Conditions' => new RectangleFilter(new Rectangle(32, 716, 286, 671)),
+    'Subscription tekMag' => new RectangleFilter(new Rectangle(31, 713, 262, 672))
+];
+
+$page = $document->getCatalog()->getPages()->getPage(1);
+$textItems = $extractor->getTextItemsByPage($page);
+
+foreach ($filters as $filterName => $filter) {
+    // tell the filter about the page, the text-items came from
+    $filter->setPage($page);
+    // now we filter the existing text-items by the individual filter
+    $result = $strategy->getResultByTextItems($textItems, $filter);
+    if ($result === $filterName) {
+        $match = $filterName;
+        break;
+    }
+}
+
+switch ($match ?? null) {
+    case 'Laboratory Report':
+        echo 'This document is a laboratory report!';
+        // ...process it
+        break;
+    case 'Terms and Conditions':
+        echo 'This document shows Terms and Conditions!';
+        // ...process it
+        break;
+    case 'Subscription tekMag':
+        echo 'This document is a subscription form to the tekMag!';
+        // ...process it
+        break;
+    default:
+        echo 'Sorry, but I cannot recognize the document type.';
+}