laqieer / gba-free-fonts

Free font resources for GBA game development

gba-free-fonts

Free font resources for GBA game development

This repo contains many free-to-use fonts which are ready-to-use in your GBA project.

Note: source code are under zlib license, fonts are under their own licenses.

Fonts & Licenses

Font	License	Characters	Preview
HanaMin(Hanazono Mincho) / 花園明朝 / 花园宋体	Hanazono Font License + SIL OFL 1.1	101912
GNU Unifont	GNU GPLv2+ with the GNU Font Embedding Exception + SIL OFL 1.1	78934
Unscii	GNU GPLv2+ with the GNU Font Embedding Exception	64315
BabelStone Han	Arphic Public License	59664
Source Han Serif(Noto Serif CJK) / 思源宋体 / 思源宋體 / 源ノ明朝 / 본명조	SIL OFL 1.1	44748
Source Han Sans(Noto Sans CJK) / 思源黑体 / 思源黑體 / 源ノ角ゴシック / 본고딕	SIL OFL 1.1	42222
Source Han Mono / 思源等宽 / 思源等寬 / 源ノ等幅 / 본모노	SIL OFL 1.1	44798
WQY(Wen Quan Yi)(Spring of Letters) Zen Hei / 文泉驿正黑	GPL	42285
WQY(Wen Quan Yi)(Spring of Letters) Micro Hei / 文泉驿微米黑	Apache License 2.0 + GNU GPLv3 with font embedding exceptions	34600

Guide

For Butano

This is an example to show how to use a font in your project.

1. Install Pillow

# For MSYS2/MinGW-w64 users
pacman -S mingw-w64-x86_64-python-pillow
# For WSL2/Ubuntu/Debian users
sudo apt-get install python3-pil
# For Mac users
brew install pillow
# For FreeBSD users
pkg install py38-pillow
# For CentOS users
yum install python3-pillow
# For Fedora Linux users
dnf install python3-pillow
# For Arch Linux users
pacman -S python37-pillow

2. Set path in Makefile

# FONTS is a list of directories containing font files.
FONTS       :=  
# TEXTS is a list of directories or filenames containing text files.
TEXTS       :=  

3. Bind it to a bn::sprite_text_generator in source code

#include "xxx_sprite_font.h"
bn::sprite_text_generator text_generator(xxx_sprite_font);

Others

Free-to-use 1bpp dot matrix fonts

History

This project starts here.

gba-free-fonts's Issues

Fonts without UTF8 characters do not compile

Whenever I use a font without utf8 characters, the assert at include/bn_sprite_font.h:119 fails at compile-time. It fixes itself if I add just a single utf8 character, so not a huge deal... but the assert message is very confusing, and it took me a bit to figure out what was happening, so figured I'd report.

To replicate, I've attached the font I'm using. Just drop in example project and the error will occur:
madou_futo_maru_gothic.zip

---

Attaching error message to help anyone with similar error search for this

in 'constexpr' expansion of '((bn::sprite_font*)this)->bn::sprite_font::sprite_font((* & item), (* & utf8_characters_ref), (* & character_widths_ref), 0)'
butano/include/bn_assert.h:133:25: error: call to non-'constexpr' function 'void __assert_func(const char*, int, const char*, const char*)'
  133 |                         assert(condition); \
      |                         ^~~~~~
butano/include/bn_sprite_font.h:119:9: note: in expansion of macro 'BN_ASSERT'
  119 |         BN_ASSERT(character_widths_ref.empty() ||
devkitARM/arm-none-eabi/include/assert.h:41:6: note: 'void __assert_func(const char*, int, const char*, const char*)' declared here
   41 | void __assert_func (const char *, int, const char *, const char *)
      |      ^~~~~~~~~~~~~
make[2]: *** [/devkitARM/base_rules:39: FontLoader.o] Error 1
make[1]: *** [/butano/butano.mak:207: build] Error 2
make: *** [/butano/butano.mak:202: all] Error 2