New PDF optput method for XOBjects

VERSION

@@ -1 +1 @@
-2.0.15
+2.1.0

src/Output.php

@@ -32,6 +32,8 @@
  *
  * @phpstan-import-type ImageBaseData from \Com\Tecnick\Pdf\Image\Import
  * @phpstan-import-type ImageRawData from \Com\Tecnick\Pdf\Image\Import
+ *
+ * @SuppressWarnings(PHPMD.ExcessiveClassComplexity)
  */
 abstract class Output
 {
@@ -270,6 +272,40 @@ public function getXobjectDict(): string
         return $out;
     }
 
+    /**
+     * Return XObjects Dictionary.
+     *
+     * @param array<int> $keys Image IDs.
+     */
+    public function getXobjectDictByKeys(array $keys): string
+    {
+        if (empty($keys)) {
+            return '';
+        }
+
+        $out = '';
+
+        foreach ($keys as $iid) {
+            $key = 'IMG' . $iid;
+            if (!empty($this->xobjdict[$key])) {
+                $out .= ' /' . $key . ' ' . $this->xobjdict[$key] . ' 0 R';
+                continue;
+            }
+            $key = 'IMGplain' . $iid;
+            if (!empty($this->xobjdict[$key])) {
+                $out .= ' /' . $key . ' ' . $this->xobjdict[$key] . ' 0 R';
+                continue;
+            }
+            $key = 'IMGmask' . $iid;
+            if (!empty($this->xobjdict[$key])) {
+                $out .= ' /' . $key . ' ' . $this->xobjdict[$key] . ' 0 R';
+                continue;
+            }
+        }
+
+        return $out;
+    }
+
     /**
      * Get the PDF output string for ICC object.
      *

test/ImportTest.php

@@ -221,5 +221,11 @@ public function testAdd(): void
             . ' /IMG15 31 0 R /IMGplain16 33 0 R /IMG17 35 0 R /IMG18 37 0 R',
             $xobjectDict
         );
+
+        $xdByKeys = $import->getXobjectDictByKeys([2,3]);
+        $this->assertEquals(
+            ' /IMG2 12 0 R /IMG3 13 0 R',
+            $xdByKeys
+        );
     }
 }