fheroes2项目中的地图编辑器文件对话框翻译支持问题解析

背景介绍

fheroes2是一款开源的英雄无敌2游戏引擎重制项目，在开发过程中，团队发现地图编辑器的文件对话框中的按钮文本（如"MAIN MENU"和"START MAP"）无法正常使用翻译功能。这个问题涉及到游戏UI系统的多语言支持机制。

问题分析

在fheroes2项目中，按钮文本的翻译功能主要通过两种方式实现：

1. gettext_noop()函数：仅标记需要翻译的字符串，供翻译工具识别
2. _()函数：实际调用翻译函数，在运行时进行文本转换

当前问题出现在makeButtonSprites()函数中，该函数负责创建按钮的精灵图像。函数内部没有检查当前字体是否支持翻译后的文本，导致即使PO文件提供了翻译，这些翻译也无法被实际使用。

技术细节

现有实现的问题

在现有代码中，按钮文本渲染流程如下：

1. 获取按钮文本
2. 创建按钮精灵图像
3. 渲染文本到按钮上

但缺少了关键步骤：在渲染前检查字体是否支持翻译后的文本。这导致以下问题：

• 翻译后的文本可能无法正确显示
• 特殊按钮（如Shift键）可能显示为空白

解决方案探讨

开发团队提出了几种解决方案：

1. 直接使用翻译函数： 简单地在makeButtonSprites()中添加_(text)调用，但会忽略字体支持检查

2. 改进字体支持检查： 在渲染前先检查翻译后的文本是否被当前字体支持，如果不支持则回退到原始文本

3. 重构按钮创建逻辑： 将现有分散在不同文件中的按钮创建函数统一，建立更健壮的翻译支持机制

最终解决方案

经过讨论，团队决定采用分阶段解决方案：

1. 短期方案：

   • 将createNormalButton()函数从agg_image.cpp移动到ui_button.cpp
   • 为StandardWindow类添加新方法，使用改进后的按钮创建逻辑
   • 在editor_interface.cpp中调用新方法处理特殊按钮

2. 长期规划：

   • 统一项目中分散的按钮创建函数
   • 完善字体支持检查机制
   • 建立更健壮的多语言支持框架

技术实现要点

在具体实现上，需要注意以下几点：

1. 文本处理：

   std::string translatedText = _( text );
   std::string supportedText = fheroes2::isFontAvailable( translatedText, { fheroes2::FontSize::BUTTON_RELEASED, fontColor } ) ? translatedText : text;
   

2. 字体兼容性检查： 必须确保翻译后的文本在当前字体中可用，否则回退到原始文本

3. 特殊字符处理： 对于包含特殊符号（如"|"）的按钮文本，需要特殊处理以避免显示问题

总结与展望

fheroes2项目中的多语言支持是一个持续改进的过程。本次地图编辑器文件对话框的翻译问题揭示了项目中UI系统的一些设计缺陷，也为未来的代码重构指明了方向。

团队计划在后续版本中：

1. 统一按钮创建逻辑
2. 完善字体支持检查机制
3. 优化多语言支持框架

这些改进将使fheroes2的国际化和本地化支持更加完善，为全球玩家提供更好的游戏体验。