font.getGlyphID处理非英语Unicode字符触发KeyError的解决方法

一、先解决当前的KeyError问题 #

1. 核心原因：字体不支持目标字符 #

你遇到的KeyError: 'ম'本质是当前加载的字体没有包含孟加拉语字符“ম”的字形。绝大多数默认英文字体（如Arial、Times New Roman）仅覆盖拉丁字符集，对南亚文字（如孟加拉语）无支持。

解决方法：

• 加载支持孟加拉语的字体，比如：
  • Noto Sans Bengali（Google开源多语言字体，覆盖几乎全Unicode字符）
  • SolaimanLipi（常用孟加拉语字体）
• 代码中指定字体路径示例：

  from fontTools.ttLib import TTFont
  
  # 替换为你的孟加拉语字体本地路径
  font_path = "NotoSansBengali-Regular.ttf"
  font = TTFont(font_path)
  

2. 正确获取字形ID的姿势 #

部分复杂文字（如孟加拉语这类天城文系文字，存在连字、变音组合）不能直接用单个字符作为key获取字形ID，需借助Unicode映射工具：

• 使用fontTools.unicode模块的mapUnicodeToGlyph方法处理字符到字形的映射：

  from fontTools.unicode import mapUnicodeToGlyph
  
  unicode_char = "ম"
  glyph_name = mapUnicodeToGlyph(font, ord(unicode_char))
  glyph_index = font.getGlyphID(glyph_name)
  

  该方法会自动读取字体的Unicode映射表，避免直接用字符作为key的报错问题。

二、实现任意Unicode字符的SVG渲染 #

要覆盖多语言、复杂字符（如阿拉伯语、印度语、emoji等），需要完善以下几个核心环节：

1. 构建字体 fallback 链 #

单字体无法覆盖所有Unicode字符，需构建优先级 fallback 链：优先尝试自定义字体，若找不到字形则依次尝试通用多语言字体。示例逻辑：

def get_font_for_text(text, font_paths):
    for path in font_paths:
        font = TTFont(path)
        all_glyphs_exist = True
        for char in text:
            glyph_name = mapUnicodeToGlyph(font, ord(char))
            if glyph_name == ".notdef":  # .notdef是字体无对应字形的默认占位符
                all_glyphs_exist = False
                break
        if all_glyphs_exist:
            return font, path
    raise ValueError(f"No font supports all characters in: {text}")

# 示例fallback链：自定义字体 → 孟加拉语专用字体 → 通用多语言字体
font_paths = ["my_custom_font.ttf", "NotoSansBengali-Regular.ttf", "NotoSans-Regular.ttf"]
font, font_path = get_font_for_text("ম Hello", font_paths)

2. 处理复杂文字的上下文布局 #

孟加拉语、阿拉伯语等文字存在上下文相关字形变化（连写、字母变形），直接渲染单个字形会显示异常。需用专业布局引擎处理：

• 使用uharfbuzz（harfbuzz的Python绑定）生成正确的字形序列和位置：

  import uharfbuzz as hb
  
  def get_shaped_glyphs(font_path, text, font_size=48):
      face = hb.Face(open(font_path, "rb"))
      font_hb = hb.Font(face)
      font_hb.scale = (font_size * 64, font_size * 64)  # harfbuzz采用64倍缩放精度
      
      buf = hb.Buffer()
      buf.add_str(text)
      buf.guess_segment_properties()
      hb.shape(font_hb, buf)
      
      return buf.glyph_infos, buf.glyph_positions
  

  该方法输出的字形信息已经过上下文布局处理，确保复杂文字显示符合语言规范。

3. 完整SVG渲染代码示例 #

结合上述步骤，完整的多语言SVG渲染代码：

from fontTools.ttLib import TTFont
from fontTools.unicode import mapUnicodeToGlyph
import uharfbuzz as hb
import svgwrite

def render_text_to_svg(text, font_paths, output_path, font_size=48):
    # 获取支持当前文本的字体
    def get_valid_font():
        for path in font_paths:
            font = TTFont(path)
            has_all_glyphs = True
            for char in text:
                glyph_name = mapUnicodeToGlyph(font, ord(char))
                if glyph_name == ".notdef":
                    has_all_glyphs = False
                    break
            if has_all_glyphs:
                return font, path
        raise ValueError("No font supports all characters in the text")
    
    font, font_path = get_valid_font()
    # 用harfbuzz处理文字布局
    glyph_infos, glyph_positions = get_shaped_glyphs(font_path, text, font_size)
    
    # 计算SVG画布尺寸
    total_width = sum(pos.x_advance for pos in glyph_positions) / 64
    total_height = font_size * 1.2  # 预留行高
    
    # 创建SVG文件
    dwg = svgwrite.Drawing(output_path, size=(total_width, total_height), profile="tiny")
    baseline_y = font_size  # 文字基线位置
    
    current_x = 0
    for info, pos in zip(glyph_infos, glyph_positions):
        glyph_name = font.getGlyphName(info.codepoint)
        glyph = font["glyf"][glyph_name]
        
        # 获取字形的SVG路径并绘制
        if hasattr(glyph, 'getSVGPath'):
            path = glyph.getSVGPath(font["hmtx"], font_size)
            if path:
                dwg.add(dwg.path(d=path, fill="black", transform=f"translate({current_x}, {baseline_y})"))
        
        current_x += pos.x_advance / 64
    
    dwg.save()

# 使用示例：支持孟加拉语、英文、emoji
font_paths = [
    "NotoSansBengali-Regular.ttf", 
    "NotoSans-Regular.ttf", 
    "NotoSansSymbols-Regular.ttf"
]
render_text_to_svg("ম Hello 🌍", font_paths, "multi_lang_output.svg")

4. 依赖与注意事项 #

• 安装依赖：pip install fonttools uharfbuzz svgwrite
• 对于emoji字符，需使用支持emoji的字体（如Noto Color Emoji），彩色emoji的渲染需额外读取字体的sbix表提取颜色矢量数据。

内容的提问来源于stack exchange，提问作者Maifee Ul Asad