Watako-Lab さんの M5Stackで好きなフォントを使う を基にフリーの日本語フォント "源真ゴシック" で M5Stack の LCD で日本語表示するところまでをまとめました。
(6/4 更新)
最新の M5Stack ライブラリだと、TFT_eSPI の日本語表示ロジックが取り込まれてて、TFT_eSPI ライブラリを追加インストールしなくても良いみたいですー。
— Nochi (@shikarunochi) 2019年6月4日
ということで調べてみたら 取り込まれてた！！
だから M5.Lcd.loadFont() とか使えるようになってるのですねー。
準備
M5Stack 以外で必要なものは以下の通り。
- 2 GB 以上の micro SD カード
（というか、ファイルサイズ的には 10MB ぐらいですので、その程度のスペースがあれば OK です)
手順
Arduino IDE の M5Stack 開発環境のセットアップ (Windows / macOS) が終わっている前提で以下の作業を行います。
- フォントファイル(VLW ファイル)をダウンロード して micro SD カードに保存
※ micro SD カードは FAT でフォーマットしておいてください
実装
#include <M5Stack.h>
void setup() {
M5.begin();
M5.Lcd.clear();
M5.Lcd.fillScreen(BLACK);
M5.Lcd.setCursor(0, 0);
M5.Lcd.setTextColor(WHITE);
String f16 = "genshin-regular-16pt"; // without Ext
M5.Lcd.loadFont(f16, SD);
M5.Lcd.printf("16pt: Good-bye 平成\n");
M5.Lcd.printf("こんにちわ令和\n");
M5.Lcd.unloadFont();
String f24 = "genshin-regular-24pt"; // without Ext
M5.Lcd.loadFont(f24, SD);
M5.Lcd.printf("24pt: Good-bye 平成\n");
M5.Lcd.printf("こんにちわ令和\n");
M5.Lcd.unloadFont();
String f32 = "genshin-regular-32pt"; // without Ext
M5.Lcd.loadFont(f32, SD);
M5.Lcd.printf("32pt: Good-bye 平成\n");
M5.Lcd.printf("こんにちわ令和\n");
M5.Lcd.unloadFont();
}
void loop(){
}
解説
TFT_eSPI が M5.Lcd に追加するメソッド
(6/4 更新) 冒頭でも書いた通り TFT_eSPI は M5Stack ライブラリに取り込まれているので M5.Lcd で #loadFont() と #unloadFont() が使えるようになっています。
loadFont() の引数は (fontName, fs) です。
-
fsはフォントファイルの読み込み元デバイスの指定をします。SDを指定すると SD カードから読み込みます。(その他の方法は知らん) -
fontNameはfsをルートとしたフォントファイルのパス名を指定します。 -
fontfile.vlwならfontfileと、拡張子を除いて指定します。dir1/dir2/fontfileのようにディレクトリ内のパス指定が可能です。 - フォントファイルの読み込みには若干時間がかかります。
unloadFont() は引数指定はありません。
VLW ファイルの作成方法
Watako-Lab さんの「ライブラリ用フォントの作成手順」 で解説されていますが、要点は Processing を使って生成するということになります。
ちなみに Processing 以外での VLW ファイル作成は無理っぽいようです、残念。
- https://forum.processing.org/beta/num_1263293380.html
- https://forum.processing.org/beta/num_1153418127.html
TFT_eSPI ライブラリの調整は不要です
(6/4 更新) この章は、まるまる削除しました。
VLW 形式フォントファイル配布とライセンス
ダウンロードは以下から可能です。
- 源真ゴシック Regular VLW 形式フォントファイル
- フォントサイズ 16pt; genshin-regular-16pt.vlw (3.5 MB)
- フォントサイズ 20pt; genshin-regular-20pt.vlw (5.0 MB)
- フォントサイズ 24pt; genshin-regular-24pt.vlw (6.8 MB)
- フォントサイズ 28pt; genshin-regular-28pt.vlw (9.2 MB)
- フォントサイズ 32pt; genshin-regular-32pt.vlw (11.6 MB)
収録文字
Unicode コードポイントの以下の範囲を収録しています。
ザクっというと、ASCII, ひらがな, カタカナ(半角含む), 漢字が入ってます。
- 0x0021, 0x007E, //Basic Latin, 128, 128, Latin (52 characters), Common (76 characters)
- 0x3000, 0x303F, //CJK Symbols and Punctuation, 64, 64, Han (15 characters), Hangul (2 characters), Common (43 characters), Inherited (4 characters)
- 0x3040, 0x309F, //Hiragana, 96, 93, Hiragana (89 characters), Common (2 characters), Inherited (2 characters)
- 0x30A0, 0x30FF, //Katakana, 96, 96, Katakana (93 characters), Common (3 characters)
- 0x4E00, 0x9FFF, //CJK Unified Ideographs, 20,992, 20,971, Han
- 0xFF00, 0xFFEF, //Halfwidth and Fullwidth Forms, 240, 225, Hangul (52 characters), Katakana (55 characters), Latin (52 characters), Common (66 characters)
ライセンス
http://jikasei.me/info/license.html に従い、VLW ファイルの公開と共にライセンス明記しておきます。
本ソフトでは表示フォントに「源真ゴシック」(http://jikasei.me/font/genshin/) を使用しています。
Licensed under SIL Open Font License 1.1 (http://scripts.sil.org/OFL)
© 2015 自家製フォント工房, © 2014, 2015 Adobe Systems Incorporated, © 2015 M+FONTS PROJECT
まとめ
VLW ファイルの作成が面倒ですね。
ライセンス的に NG だったらすぐ言ってください。（読解力に不安あり）
アンチエイリアスが効いていない気がするが、読めるので気にしないことにする。
EoT