M5PaperでSPIFFSに日本語TTFファイルを置いて描画する
data/ ディレクトリを作り、その中へTTFファイルを入れる。ツール → ESP32 Sketch Data Upload から実行できる)。ツール → ESP32 Sketch Data Upload を実行して data/ の中身をSPIFFSへ書き込む。M5EPD の canvas は loadFont() でファイルパスを渡すと、そのTTFで描画できる。日本語フォントは数MBになるため、SPIFFSの容量(M5Paperは16MBフラッシュの一部)に収まるサイズを選ぶ。収まらない場合はSDカードから読む手もある。
#include <M5EPD.h>
M5EPD_Canvas canvas(&M5.EPD);
void setup() {
M5.begin();
M5.EPD.SetRotation(90);
canvas.createCanvas(540, 960);
if (!SPIFFS.begin(true)) {
Serial.println("SPIFFS mount failed");
}
canvas.loadFont("/NotoSansJP-Regular.ttf", SPIFFS);
canvas.createRender(48, 256); // サイズ48のレンダリングバッファを作る
canvas.setTextSize(48);
canvas.drawString("日本語のテスト", 20, 100);
canvas.pushCanvas(0, 0, UPDATE_MODE_GC16);
}
void loop() {}
createRender(size, bufSize) は指定サイズのレンダリング用バッファを確保する。大きいサイズや画数の多い漢字ほどバッファを多く取る必要がある。メソッド名はM5EPDのバージョンで変わるため、付属サンプル(M5Paper_Font など)を基準にする。
loadFont のパスが合わないと読み込めない。先頭に / を付けたルートからのパスで指定する。createRender の第2引数)が足りず、文字が欠ける。バッファは余裕を持って取る。Q. フォントは何MBまで置ける?
A. M5Paperのフラッシュは16MBで、SPIFFSに割ける領域はパーティション構成で決まる。数MBの日本語TTFは入るが、スケッチ本体と合わせて容量を超えないよう確認する。足りない場合はSDカードを使う。
Q. SDカードからでも同じように読める?
A. 読める。SDをマウントして loadFont にSD側のパスを渡す。SPIFFSに書き込む手間を省けるぶん、フォントを差し替えるときはSDのほうが楽だ。
Q. 日本語が四角(豆腐)になる。
A. フォントの読み込みに失敗しているか、そのサイズのグリフが無い。loadFont の戻り値とパスを確認し、createRender のバッファを増やして再確認する。
🛒 Amazon: M5Stack M5Paper を探す
※ 本ページのAmazonリンクにはアフィリエイトタグ(toobf6-22)が付いている。
🤖 このページにはAIエージェント(ノア)による編集・加筆が含まれます。内容の正確性は保証できないため、重要な判断は一次情報でご確認ください。