iText7技术问询：如何为PdfFont指定OpenType特性？

要解决藏文在iText中排版不符合预期的问题，你需要手动启用藏文对应的OpenType特性。iText 7提供了直接设置字体特性的API，下面是具体实现步骤和代码示例：

1. 藏文排版必需的OpenType特性 #

藏文的正确排版依赖多个OpenType特性，常用的关键特性包括：

• locl：启用本地化字形替换
• blwf：藏文基字变形
• abvf：藏文上方元音变形
• abvm：藏文上方元音定位
• blwm：藏文基字定位
• haln：藏文辅音连写

2. 完整代码示例 #

import com.itextpdf.io.font.FontProgram;
import com.itextpdf.io.font.FontProgramFactory;
import com.itextpdf.kernel.font.PdfFont;
import com.itextpdf.kernel.font.PdfFontFactory;
import com.itextpdf.kernel.pdf.PdfDocument;
import com.itextpdf.kernel.pdf.PdfWriter;
import com.itextpdf.layout.Document;
import com.itextpdf.layout.element.Paragraph;

import java.io.IOException;

public class TibetanPdfTest {
    public static void main(String args[]) throws IOException {
        final String notoPath = "/usr/share/fonts/truetype/noto/NotoSansTibetan-Regular.ttf";
        final PdfWriter writer = new PdfWriter("tibttest.pdf");
        final PdfDocument pdfDoc = new PdfDocument(writer);
        final Document document = new Document(pdfDoc);

        // 加载藏文字体程序
        FontProgram fontProgram = FontProgramFactory.createFont(notoPath);
        // 创建PdfFont实例并启用藏文特性
        PdfFont tibetanFont = PdfFontFactory.createFont(fontProgram);
        tibetanFont.setFeature("locl", true);
        tibetanFont.setFeature("blwf", true);
        tibetanFont.setFeature("abvf", true);
        tibetanFont.setFeature("abvm", true);
        tibetanFont.setFeature("blwm", true);
        tibetanFont.setFeature("haln", true);

        // 添加藏文测试文本
        String tibetanText = "བཀྲ་ཤིས་བདེ་ལེགས།"; // 吉祥如意
        Paragraph paragraph = new Paragraph(tibetanText)
                .setFont(tibetanFont)
                .setFontSize(20);
        document.add(paragraph);

        document.close();
    }
}

3. 注意事项 #

• 上述代码基于iText 7编写，iText 5的API差异较大，无法直接复用。
• 不同藏文字体支持的特性可能略有差异，如果排版仍有问题，可以用字体查看工具（如FontForge）确认字体支持的特性列表，再调整启用的特性项。
• 确保字体文件路径正确，避免因找不到字体导致的异常。

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