PDFBox中liga连字启用无效，如何获取字体连字映射手动实现？

一、排查liga功能无效问题 #

你的代码中enableGsubFeature("liga")无效果，可从以下方向调整：

• 特性覆盖不全：部分字体的标准连字在liga，但常用可选连字（如fi/fl）可能放在dlig（ discretionary ligatures）特性中，建议同时启用两个特性；
• 版本兼容性：旧版本FontBox对GSUB特性支持不完善，建议升级至最新稳定版（2.0.x或3.0.x）；
• 警告可忽略：onum的日志警告是PDFBox内部处理逻辑导致，不影响功能，可通过将org.apache.fontbox日志级别设为ERROR屏蔽。

修改后的测试代码：

TrueTypeFont font = new TTFParser().parse(file);
font.enableGsubFeature("liga");
font.enableGsubFeature("dlig");
font.enableGsubFeature("onum");

return PDType0Font.load(doc, font, false);

二、手动提取字体连字映射 #

如果内置GSUB特性仍不生效，可直接解析字体的GSUB表获取连字规则，实现手动替换：

1. 解析GSUB表提取连字规则 #

使用FontBox的OpenType API读取liga/dlig对应的替换映射：

TTFParser parser = new TTFParser();
TrueTypeFont font = parser.parse(new File("your-font-path.ttf"));

// 确认字体为OpenType并获取GSUB表
if (!(font instanceof OpenTypeFont)) {
    System.err.println("非OpenType字体，不支持GSUB特性");
    return;
}
GSUBTable gsub = ((OpenTypeFont) font).getGSUB();
if (gsub == null) {
    System.err.println("字体未包含GSUB表");
    return;
}

// 遍历Lookup表提取连字规则
for (Lookup lookup : gsub.getLookupList()) {
    for (LookupSubtable subtable : lookup.getSubtables()) {
        if (subtable instanceof LigatureSubst) {
            LigatureSubst ligatureSubst = (LigatureSubst) subtable;
            Map<Integer, List<LigatureSet>> ligatureSets = ligatureSubst.getLigatureSets();
            
            for (Map.Entry<Integer, List<LigatureSet>> entry : ligatureSets.entrySet()) {
                int startGid = entry.getKey();
                String startCharName = font.getCharacterName(startGid);
                
                for (LigatureSet set : entry.getValue()) {
                    for (Ligature ligature : set.getLigatures()) {
                        int ligGid = ligature.getGlyphID();
                        String ligCharName = font.getCharacterName(ligGid);
                        List<Integer> componentGids = ligature.getComponentGlyphIDs();
                        
                        // 输出连字规则：起始字符 + 后续字符 → 连字Glyph
                        System.out.printf("连字规则：%s + %s → %s (GID: %d)%n",
                                startCharName,
                                componentGids.stream().map(font::getCharacterName).collect(Collectors.joining("+")),
                                ligCharName,
                                ligGid);
                    }
                }
            }
        }
    }
}

2. 手动替换文本为连字Glyph #

拿到连字映射后，在输出文本前将字符序列替换为对应连字GID，直接调用showGlyphs输出：

// 假设已从字体中提取连字映射：键为字符序列，值为对应GID
Map<String, Integer> ligatureMap = new HashMap<>();
ligatureMap.put("fi", 123); // 替换为实际获取的GID
ligatureMap.put("fl", 124);

String inputText = "fifteen flasks";
List<Integer> glyphIds = new ArrayList<>();
int index = 0;

while (index < inputText.length()) {
    boolean matched = false;
    // 优先匹配2字符连字（可扩展到3字符如ffi等）
    if (index + 1 < inputText.length()) {
        String pair = inputText.substring(index, index + 2);
        if (ligatureMap.containsKey(pair)) {
            glyphIds.add(ligatureMap.get(pair));
            index += 2;
            matched = true;
        }
    }
    if (!matched) {
        // 普通字符转换为GID
        char c = inputText.charAt(index);
        int gid = font.getGlyphId(c);
        glyphIds.add(gid);
        index++;
    }
}

// 直接输出Glyph数组
contentStream.showGlyphs(glyphIds.stream().mapToInt(Integer::intValue).toArray());

三、其他可选方案 #

• 尝试使用PDTrueTypeFont替代PDType0Font加载字体，部分场景下可能绕过GSUB解析问题；
• 若字体支持，启用calt（上下文替代）特性，部分连字依赖该特性生效。

内容的提问来源于stack exchange，提问作者linux_user36