これはFlashAirで日本語フォントを扱うためのライブラリです。
EUC-JP文字に対応するビットマップデータを、UTF-8やShift-JIS、EUC-JPコードで取得できます。
2019/08/01 rev.0.12
ISO 10646(Unicode)でエンコードされたBDF形式のビットマップフォントに対応しました。
2019/06/01 rev.0.11
文字コード変換の変換可能文字数を緩和しました。
2019/05/30 rev.0.10
Utf8Euc_jp.tblの指定を不要にしました。
フォントファイルはカレントフォルダとカレント/font/をサーチするようにしました。
フォント本体は収録していませんので、BDF形式のビットマップフォントを別途ご用意ください。
縦×横が32dot x 32dot以下のBDFフォントを想定して作成しています。
等幅フォントだけでなく、プロポーショナルフォントにも対応しています。
エンコーディングは、
- ISO10646 （半角フォント、全角フォントの両方を含むことが多い）
- JISX02xx.xxxx (全角フォントまたは半角フォント）
- iso8859（全角フォントまたは半角フォント、半角カタカナ含まず）
を想定しています。
半角カタカナを使用する場合は、半角カタカナに対応したフォントをお選びください。
デバッグに使用したフォントは以下の通りです。
misaki_4x8_iso8859.bdf *1)
misaki_4x8_jisx0201.bdf *1)
3x8.bdf *2)
k6x10.bdf *3)
mplus_q06r.bdf *4) (可変幅)
misaki_gothic.bdf *1)
misaki_gothic_2nd.bdf *1)
misaki_mincho.bdf *1)
k6x8.bdf *2)
k12x10.bdf *3)
shnmk12p.bdf *5) (可変幅)
*1) 8×8 ドット日本語フォント「美咲フォント」
http://littlelimit.net/misaki.htm
X11 BDF 形式：misaki_bdf_2012-06-03.tar.gz (210,238 bytes)
*2) 6×8 ドット日本語フォント「k6x8」
http://littlelimit.net/k6x8.htm
X11 BDF形式：k6x8bb02.tar.gz (86,333 bytes)
*3) 漢字12x10ドットフォント - k12x10
http://z.apps.atjp.jp/k12x10/
X11 bdf形式 (k12x10bdf.tar.gz, 155Kbyte)
*4) M+ BITMAP FONTS
http://mplus-fonts.osdn.jp/mplus-bitmap-fonts/design/index.html
*5) 東雲 ビットマップフォント
http://openlab.ring.gr.jp/efont/shinonome/
lib/SlibJfont.lua -- ライブラリ
lib/Utf8Euc_jp.tbl -- UTF-8をEUC-JPに変換する際の変換テーブル
font/bdf2sef.lua -- ファイル形式変換プログラム
sample.lua -- UTF-8サンプルプログラム
sample_sjis.lua -- Shift-JISサンプルプログラム
sample_sjis.txt -- Shift-JISプログラム
上記をFlashAir内の好きな場所においてください
ビットマップフォントデータは、列ごとに配列に格納されます。
bitmapの要素数とフォントの幅は一致しています。
各列は文字の上端がLSB、下端がMSBを表します。
例えば、4x8ドットの”F"
@@@.
@...
@...
@@@.
@...
@...
@...
....
であれば、下記のように格納されます。
bitmap = {}
bitmap[1] = 0xFE -- 11111110
bitmap[2] = 0x90 -- 10010000
bitmap[3] = 0x90 -- 10010000
bitmap[4] = 0x00 -- 00000000
アプリ実行時にBDFファイルを直接扱うのは効率が悪いので、事前にFlashAirで扱いやすい形式に変換しておきます。
BDFファイル(拡張子 .bdf)をfontフォルダに置き、ファイル形式変換プログラム bdf2sef.lua の末尾に
convBdf2Bin("BDFファイル名")
を１行追加して bdf2sef.lua を実行します。
追加する行の例：
convBdf2Bin("k6x10.bdf")
変換が終わると 独自形式のフォントファイル(拡張子 .sef)が生成されます。
全角文字の変換には 数分かかります。
FTLE 6) 上で実行すると「Break(F8)」で中断、「GetMsg(F9)」で残り時間を確認することができます。
変換後のフォントの高さは全ての文字で共通の高さになります。幅は元のフォントの情報を維持します。
6) FlashTools Lua Editor
https://sites.google.com/site/gpsnmeajp/tools/flashair_tiny_lua_editer
| 関数 | 説明 |
|---|---|
| ret,mes= convBdf2Bin(srcFname,dstFname) |
BDF形式のビットマップフォントファイルを独自形式に変換します ret: 実行結果、変換に成功したら"OK"、失敗したら nil mes: エラーメッセージ srcFname: BDFファイル名またはフルパス dstFname: 出力ファイル名またはフルパス 省略時はBDFファイルの拡張子を".sef"に変えて出力します |
| 関数 | 説明 |
|---|---|
| strEUC, ank_cnt= SlibJfont:sjis2euc(strSJIS) |
Shit-JISコード文字列をEUC-JPコードに変換します strEUC: EUC文字列 ank_cnt: 半角文字単位で数えた文字数 strSJIS: Shift-JIS文字列 |
| strEUC, ank_cnt= SlibJfont:utf82euc(strUTF8) |
UTF-8コード文字列をEUC-JPコードに変換します strEUC: EUC文字列 ank_cnt: 半角文字単位で数えた文字数 strUTF8: UTF-8文字列 |
| font,mes = SlibJfont:open(fontPath) | フォントファイルをオープンし、管理情報を取得します font: フォント管理情報、ファイルオープンに失敗した場合は nil mes: エラーメッセージ fontPath: .sef形式のフォントファイル名またはパス名 見つからない場合はカレント/font/の下をさがします |
| SlibJfont:close(font) | フォントファイルをクローズします font: フォント管理情報、省略すると全てクローズ |
| SlibJfont:setFont(font1,font2) | getFont()で使用するフォントを指定します font1: 半角文字用フォント管理情報、変更しないときは省略可 font2: 全角文字用フォント管理情報、変更しないときは省略可 半角文字と全角文字の両方を含むフォントでは同じ管理情報を指定することができます。 |
| bitmap, fh, fw, next_p = SlibJfont:getFont(euc, p) |
指定したEUC-JPコード文字列に対応するビットマップを取得します bitmap: ビットマップ fh: フォントの高さ fw: フォントの幅 next_p: 次の文字の位置 euc: EUC-JPコード文字列 p: 文字の位置(1～#euc)、省略時は1（先頭） |
UTF-8コードからEUC-JPコードに変換する関数は、mgo-tecさんの"SD_UTF8toSJIS"をアレンジさせていただきました。
JIS第一水準、第二水準、１３区、半角カナが変換可能です。
lib/SlibJfont.lua -- ライブラリ
lib/Utf8Euc_jp.tbl -- UTF-8をEUC-JPに変換する際の変換テーブル
font/bdf2sef.lua -- ファイル形式変換プログラム
sample.lua -- UTF-8サンプルプログラム
sample_sjis.lua -- Shift-JISサンプルプログラム
sample_sjis.txt -- Shift-JISプログラム
BDFフォントファイル "k6x10.bdf" と "k12x10.bdf" を 3) から入手して
font/ の下に置き、bdf2sef.lua の末尾に
convBdf2Bin("k6x10.bdf")
convBdf2Bin("k12x10.bdf")
を追加してください。
bdf2sef.lua を実行すると、font/ の下に"k6x10.sef" と "k12x10.sef" が生成されます。
.sef ファイルがある状態で、sample.lua または、sample_sjis.lua を実行すると、
文字列に対応したバナーが sample_out.txt ファイルに出力されます。