Code Coverage
 
Lines
Functions and Methods
Classes and Traits
Total
100.00%
5 / 5
100.00%
1 / 1
 CRAP
100.00%
1 / 1
GlyphNames
100.00%
5 / 5
100.00%
1 / 1
 3
100.00%
1 / 1
 resolve
100.00%
5 / 5
100.00%
1 / 1
 3
1<?php
2declare(strict_types=1);
3/**
4 * Pop PHP Framework (https://www.popphp.org/)
5 *
6 * @link       https://github.com/popphp/popphp-framework
7 * @author     Nick Sagona, III <nick@popphp.org>
8 * @copyright  Copyright (c) 2009-2026 Nick Sagona, III
9 * @license    https://www.popphp.org/license     New BSD License
10 */
11
12/**
13 * @namespace
14 */
15namespace Pop\Pdf\Extract\Font;
16
17/**
18 * Pdf extract glyph names class
19 *
20 * Resolves a PostScript glyph name (as used in a font's /Differences array)
21 * to a Unicode codepoint. Tries the algorithmic "uniXXXX"/"uXXXX" naming
22 * convention first (covers most subsetted/custom fonts with no lookup
23 * table needed), then a curated table of common named glyphs - not the
24 * full ~4,300-entry Adobe Glyph List. An unmapped name returns null and is
25 * skipped by the caller rather than guessed at.
26 *
27 * @category   Pop
28 * @package    Pop\Pdf
29 * @author     Nick Sagona, III <nick@popphp.org>
30 * @copyright  Copyright (c) 2009-2026 Nick Sagona, III
31 * @license    https://www.popphp.org/license     New BSD License
32 * @version    6.0.0
33 */
34class GlyphNames
35{
36
37    /**
38     * Curated PostScript glyph name to Unicode codepoint table
39     */
40    protected const TABLE = [
41        // ASCII printable range - official Adobe glyph names.
42        'space' => 0x0020, 'exclam' => 0x0021, 'quotedbl' => 0x0022, 'numbersign' => 0x0023,
43        'dollar' => 0x0024, 'percent' => 0x0025, 'ampersand' => 0x0026, 'quotesingle' => 0x0027,
44        'parenleft' => 0x0028, 'parenright' => 0x0029, 'asterisk' => 0x002A, 'plus' => 0x002B,
45        'comma' => 0x002C, 'hyphen' => 0x002D, 'period' => 0x002E, 'slash' => 0x002F,
46        'zero' => 0x0030, 'one' => 0x0031, 'two' => 0x0032, 'three' => 0x0033, 'four' => 0x0034,
47        'five' => 0x0035, 'six' => 0x0036, 'seven' => 0x0037, 'eight' => 0x0038, 'nine' => 0x0039,
48        'colon' => 0x003A, 'semicolon' => 0x003B, 'less' => 0x003C, 'equal' => 0x003D,
49        'greater' => 0x003E, 'question' => 0x003F, 'at' => 0x0040,
50        'A' => 0x0041, 'B' => 0x0042, 'C' => 0x0043, 'D' => 0x0044, 'E' => 0x0045, 'F' => 0x0046,
51        'G' => 0x0047, 'H' => 0x0048, 'I' => 0x0049, 'J' => 0x004A, 'K' => 0x004B, 'L' => 0x004C,
52        'M' => 0x004D, 'N' => 0x004E, 'O' => 0x004F, 'P' => 0x0050, 'Q' => 0x0051, 'R' => 0x0052,
53        'S' => 0x0053, 'T' => 0x0054, 'U' => 0x0055, 'V' => 0x0056, 'W' => 0x0057, 'X' => 0x0058,
54        'Y' => 0x0059, 'Z' => 0x005A,
55        'bracketleft' => 0x005B, 'backslash' => 0x005C, 'bracketright' => 0x005D,
56        'asciicircum' => 0x005E, 'underscore' => 0x005F, 'grave' => 0x0060,
57        'a' => 0x0061, 'b' => 0x0062, 'c' => 0x0063, 'd' => 0x0064, 'e' => 0x0065, 'f' => 0x0066,
58        'g' => 0x0067, 'h' => 0x0068, 'i' => 0x0069, 'j' => 0x006A, 'k' => 0x006B, 'l' => 0x006C,
59        'm' => 0x006D, 'n' => 0x006E, 'o' => 0x006F, 'p' => 0x0070, 'q' => 0x0071, 'r' => 0x0072,
60        's' => 0x0073, 't' => 0x0074, 'u' => 0x0075, 'v' => 0x0076, 'w' => 0x0077, 'x' => 0x0078,
61        'y' => 0x0079, 'z' => 0x007A,
62        'braceleft' => 0x007B, 'bar' => 0x007C, 'braceright' => 0x007D, 'asciitilde' => 0x007E,
63
64        // Common typographic punctuation.
65        'quoteleft' => 0x2018, 'quoteright' => 0x2019, 'quotedblleft' => 0x201C,
66        'quotedblright' => 0x201D, 'quotesinglbase' => 0x201A, 'quotedblbase' => 0x201E,
67        'endash' => 0x2013, 'emdash' => 0x2014, 'bullet' => 0x2022, 'ellipsis' => 0x2026,
68        'dagger' => 0x2020, 'daggerdbl' => 0x2021, 'trademark' => 0x2122,
69        'copyright' => 0x00A9, 'registered' => 0x00AE, 'degree' => 0x00B0,
70        'plusminus' => 0x00B1, 'section' => 0x00A7, 'paragraph' => 0x00B6, 'periodcentered' => 0x00B7,
71        'fi' => 0xFB01, 'fl' => 0xFB02,
72
73        // Common accented Latin letters (Latin-1 Supplement block).
74        'Agrave' => 0x00C0, 'Aacute' => 0x00C1, 'Acircumflex' => 0x00C2, 'Atilde' => 0x00C3,
75        'Adieresis' => 0x00C4, 'Aring' => 0x00C5, 'AE' => 0x00C6, 'Ccedilla' => 0x00C7,
76        'Egrave' => 0x00C8, 'Eacute' => 0x00C9, 'Ecircumflex' => 0x00CA, 'Edieresis' => 0x00CB,
77        'Igrave' => 0x00CC, 'Iacute' => 0x00CD, 'Icircumflex' => 0x00CE, 'Idieresis' => 0x00CF,
78        'Ntilde' => 0x00D1, 'Ograve' => 0x00D2, 'Oacute' => 0x00D3, 'Ocircumflex' => 0x00D4,
79        'Otilde' => 0x00D5, 'Odieresis' => 0x00D6, 'Oslash' => 0x00D8, 'Ugrave' => 0x00D9,
80        'Uacute' => 0x00DA, 'Ucircumflex' => 0x00DB, 'Udieresis' => 0x00DC, 'Yacute' => 0x00DD,
81        'agrave' => 0x00E0, 'aacute' => 0x00E1, 'acircumflex' => 0x00E2, 'atilde' => 0x00E3,
82        'adieresis' => 0x00E4, 'aring' => 0x00E5, 'ae' => 0x00E6, 'ccedilla' => 0x00E7,
83        'egrave' => 0x00E8, 'eacute' => 0x00E9, 'ecircumflex' => 0x00EA, 'edieresis' => 0x00EB,
84        'igrave' => 0x00EC, 'iacute' => 0x00ED, 'icircumflex' => 0x00EE, 'idieresis' => 0x00EF,
85        'ntilde' => 0x00F1, 'ograve' => 0x00F2, 'oacute' => 0x00F3, 'ocircumflex' => 0x00F4,
86        'otilde' => 0x00F5, 'odieresis' => 0x00F6, 'oslash' => 0x00F8, 'ugrave' => 0x00F9,
87        'uacute' => 0x00FA, 'ucircumflex' => 0x00FB, 'udieresis' => 0x00FC, 'yacute' => 0x00FD,
88        'ydieresis' => 0x00FF, 'germandbls' => 0x00DF, 'dotlessi' => 0x0131,
89    ];
90
91    /**
92     * Resolve a PostScript glyph name to a Unicode codepoint
93     *
94     * @param  string $glyphName
95     * @return ?int
96     */
97    public static function resolve(string $glyphName): ?int
98    {
99        if (preg_match('/^uni([0-9A-Fa-f]{4})$/', $glyphName, $matches) === 1) {
100            return hexdec($matches[1]);
101        }
102
103        if (preg_match('/^u([0-9A-Fa-f]{4,6})$/', $glyphName, $matches) === 1) {
104            return hexdec($matches[1]);
105        }
106
107        return self::TABLE[$glyphName] ?? null;
108    }
109
110}