add font stack size utility methods:

- hasCurrentFont()
- getStackSize()
- getCurrentFontIndex()

Author: nicolaasuni

VERSION

@@ -1 +1 @@
-2.11.0
+2.12.0

src/Stack.php

@@ -223,22 +223,22 @@ public function getCurrentFont(): array
     *
     * @param int     $objnum    Current PDF object number.
     * @param ?int    $idx       Font index. Leave it null to use the current font.
-     * @param ?string $style     Font style.
-     *                           Possible values are (case-insensitive):
-     *                           regular (default)
+    * @param ?string $style     Font style.
+    *                           Possible values are (case-insensitive):
+    *                           regular (default)
     *                           B: bold
     *                           I: italic
     *                           U: underline
     *                           D: strikeout (linethrough)
     *                           O: overline
     * @param ?float $size       Font size in points (set to null to inherit the last font size).
-     * @param ?float $spacing    Extra spacing between characters.
-     * @param ?float $stretching Horizontal character stretching ratio.
-     *
-     * @return TFontMetric
-     *
-     * @throws FontException
-     */
+    * @param ?float $spacing    Extra spacing between characters.
+    * @param ?float $stretching Horizontal character stretching ratio.
+    *
+    * @return TFontMetric
+    *
+    * @throws FontException
+    */
     public function cloneFont(
         int &$objnum,
         ?int $idx = null,
@@ -307,6 +307,36 @@ public function getCurrentFontType(): string
         return $this->getFont($this->stack[$this->index]['key'])['type'];
     }
 
+    /**
+     * Returns true if a current font is available on the stack.
+     *
+     * @return bool
+     */
+    public function hasCurrentFont(): bool
+    {
+        return ($this->index >= 0) && ($this->stack !== []);
+    }
+
+    /**
+     * Returns the number of fonts currently stored in the stack.
+     *
+     * @return int
+     */
+    public function getStackSize(): int
+    {
+        return \count($this->stack);
+    }
+
+    /**
+     * Returns the current font index in the stack.
+     *
+     * @return int
+     */
+    public function getCurrentFontIndex(): int
+    {
+        return $this->index;
+    }
+
     /**
      * Returns the PDF code to use the current font.
      *

test/StackTest.php

@@ -186,6 +186,39 @@ public function testStackMissingFont(): void
         $stack->insert($objnum, 'missing');
     }
 
+    public function testHasCurrentFont(): void
+    {
+        $this->setupTest();
+        $indir = \dirname(__DIR__) . '/util/vendor/tecnickcom/tc-font-mirror/';
+
+        $objnum = 1;
+        $stack = new \Com\Tecnick\Pdf\Font\Stack(0.75, true, true, true);
+        $this->assertFalse($stack->hasCurrentFont());
+        $this->assertSame(0, $stack->getStackSize());
+        $this->assertSame(-1, $stack->getCurrentFontIndex());
+
+        new \Com\Tecnick\Pdf\Font\Import($indir . 'freefont/FreeSans.ttf');
+        $font = $stack->insert($objnum, 'freesans', '', 12);
+        $this->assertTrue($stack->hasCurrentFont());
+        $this->assertSame(1, $stack->getStackSize());
+        $this->assertSame(0, $stack->getCurrentFontIndex());
+        $this->assertSame($font['out'], $stack->getOutCurrentFont());
+
+        $stack->cloneFont($objnum, null, null, 13);
+        $this->assertSame(2, $stack->getStackSize());
+        $this->assertSame(1, $stack->getCurrentFontIndex());
+
+        $stack->popLastFont();
+        $this->assertTrue($stack->hasCurrentFont());
+        $this->assertSame(1, $stack->getStackSize());
+        $this->assertSame(0, $stack->getCurrentFontIndex());
+
+        $stack->popLastFont();
+        $this->assertFalse($stack->hasCurrentFont());
+        $this->assertSame(0, $stack->getStackSize());
+        $this->assertSame(-1, $stack->getCurrentFontIndex());
+    }
+
     public function testUnicodeOrdAddedToSubsetChars(): void
     {
         $this->setupTest();