*This project is unmaintained*

AGSBMFontRenderer

The AGS Plugin for display UTF-8 text with Bitmap Font.

require

• AGS 3.3.3+
• AngelCode's BMFont (Bitmap Font Generator)
• UTF-8 supported text editor. (Note: AGS's text editor hasn't support UTF-8)
• Change System Locale to English(United State?) if your system locale isn't english. But buildEXE is not affected by system locale.

current limitations

Text:

• UTF-8 WITHOUT-bom only

BMFont:

• text format (.fnt) only
• 8bit texture only

recommend font settings of BMFont

• enable Match char height
• disable Font smoothing

NOTE

AngelCode's BMFont supports select characters from UTF-8/UTF-16 text file. this file must be WITH-bom.

---

Download

download AGSBMFontRenderer.dll from a latest successfull build's artifact. check build/artifacts or history.

Script API

void SetBMFont(String file, int fontNumber);

Example

add your_font.fnt and your_font0.tga to Compiled folder.

create [New Font] from [Fonts] in AGS Editor. change it propertis:

• OutlineFont => self id.
• OutlineStyle => automatic.

set room events:

• Enters room after fade in => room_AfterFadeIn
• First time enters room => room_FirstLoad

edit room1.asc with text editor(Not AGS's text editor). then save to UTF-8 WITHOUT-bom.

// room script file

function room_FirstLoad()
{
  SetBMFont("unifont.fnt", 3);
  Game.SpeechFont = 3;
}

function room_AfterFadeIn()
{
  cEgo.Say("外国語の学習と教授 Language Learning and Teaching Изучение и обучение иностранных языков Tere 語文教學・语文教学 ქართული ენის შესწავლა და სწავლება 말배우기와 가르치기 Γλωσσική Εκμὰθηση και Διδασκαλία");
}

License

AGSBMFontRenderer is licensed under Boost Software License v1.0

Third Party License

AGSBMFontRenderer is using some library. these library has own license. see official repository.

• agsplugin.h https://github.com/adventuregamestudio/ags
• stb_image.h https://github.com/nothings/stb
• utf8-cpp http://sourceforge.net/projects/utfcpp/