2015年7月1日投稿
/ 投稿者 : ほしけん
/ タグ : 投稿プログラム ツール ライブラリ 漢字
概要
プチコンでグラフィック画面に漢字を表示するためのライブラリです。
プチコン Ver.3.2 から「美咲フォント 」で漢字表示できるようになったじゃん!! と言われれば確かにその通りですし、過去に「美咲フォント」や「東雲(しののめ)フォント 」を搭載した漢字ライブラリが他の方の手によって公開されているので (下記参照)、だいぶ車輪の再発明 感があります。
サイトに埋め込まれた状態でMiiverseの投稿をみるには、JavaScriptの動く環境が必要です。 Miiverseで投稿をみる。 とはいえ、先に作られた上記とただ似たようなものを作ったわけでもなく、このライブラリならではの特長があります。
自家製ドットフォントシリーズ とKHドットフォントシリーズ 、および「美咲フォント」の作者の方が作られたフォント から、思い切って46書体をまとめてプチコン用にコンバートしたので、お好みに応じていろいろなフォントを表示することができます。どのフォントもJIS第1水準漢字 、JIS第2水準漢字 まで入っています。フォントデータは実質的に1ビットのデータになるように長い文字列に詰め込んだので、折り返し表示さえしなければ数行しかありません。これにより、プログラムの中にフォントデータをコピペして埋め込んだりすることがとても簡単にできます。
使いたい文字だけを抜き出して、ものすごく小さくしたフォントデータを作る「サブセット化」ができます。
フォントデータの半分近くを占めているJIS第2水準漢字のデータがいらない場合でも、フォントデータのうちの1行 (GKNJDEF 3. 〜 で始まる行) を消すだけで簡単に省く事ができます。
フォントデータが大きくてもメモリ (FREEMEM) を消費しすぎないような作りになっています。
ちょっとだけ文字の描画が速いんじゃないかと思います。 使い方
サンプルプログラムやデモが入っているので、まずは実行してみてください。
KNJLIB_DEMO … RPG風のコマンド選択ウインドウと会話ウインドウのデモ
KNJLIB_FONTLST … 全フォントをプレビューできます
KNJLIB_SAMPLE … 文字の表示の使い方に絞ったサンプルプログラムです。 ライブラリの初期化
KNJLIB というファイルがライブラリの本体です。これを自分のプログラムのプロジェクトにコピーするか、自分のプログラムの末尾にコピペしてください。
漢字ライブラリを使用するには、まず初期化が必要です。
PRG1 (または 2, 3) スロットにライブラリを読み込んで初期化する
または
ＬＯＡＤ ”ＰＲＧ１：ＫＮＪＬＩＢ”，ＦＡＬＳＥ：ＵＳＥ １：ＧＯＳＵＢ ”１：＠ＫＮＪＬＩＢ＿ＩＮＩＴ” 自分のプログラムにコピペする
自分のプログラムの末尾にコピペしても動きます。PRGファイルいっこで済ませたい場合や、スロットを節約したい場合はこの方法を使ってみてください。この場合も最初に1回初期化が必要です。
文字を描画する
初期化すれば、以降 GKNJ で始まる拡張命令を使うことができるようになります。たとえば、以下で左上に「こんにちは!」と表示します。
フォントデータは別の巨大な PRG ファイルとしてありますが、ライブラリ本体にも、6つのフォントのJIS第1水準漢字までが内蔵されています。GKNJFONT という命令を使えば、この内蔵のフォントを使うことができます。
GKNJFONT 0: k8x12 - 8×12ドットでスーファミ風味
GKNJFONT 1: k8x12L - 漢字以外がより大きい
GKNJFONT 2: k8x12L - 漢字以外がより小さい
GKNJFONT 3: k6x8 - 美咲フォントよりも小さい6×8ドットフォント
GKNJFONT 4: M+ BITMAP FONTS 10 - 10×11ドットで小ささと読みやすさのバランスがいい
GKNJFONT 5: M+ BITMAP FONTS 12 - 12×13ドットで非常に読みやすい ＧＫＮＪＦＯＮＴ ５：ＧＫＮＪＰＲＩＮＴ ０，０，”こんにちは！” その他、文字の色を変えたり、別のファイルからフォントを読み込んだりできます。詳しくは、サンプルプログラム「KNJLIB_SAMPLE」を見てみるか、ライブラリ本体「KNJLIB」の各ユーザー定義命令の前についたコメントを読んでみてください。Wiki 上の説明は今後もっと詳しくしていきたいと思います。
ライブラリによって追加される関数(おおよそ)
GKNJZENKAKU SET%
入力した内容を全角に変換するかを設定する
TRUEで全角 GKNJTABLEINIT
GKNJTABLE BANK%, TBL$
フォントデータ文字テーブルの設定
サブセット化したフォントデータを設定したい時に使う
BANK%：種別。(0=半角, 1=全角非漢字, 2=JIS第1水準漢字, 3=JIS第2水準漢字)
TBL$：文字の並び文字列 GKNJDEFINIT W%, H%
GKNJDEF BANK%, PAT$
フォントデータを直接設定
BANK%：種別。数値はGKNJZENKAKUを参照
PAT$：すごく長い文字列 GKNJEFF EFF%
文字のエフェクト設定
1=影付き, 2=しっかりとした影付き, 4=縁取り, 8=しっかりとした縁取り
上記の数値は足し合わせることが可能 GKNJCOLOR COL%
GKNJEFFCOLOR COL%
GKNJBGCOLOR COL%
GKNJSCALE SCX%, SCY
文字の拡大率をXYそれぞれに指定
文字を拡大すると、文字エフェクトは影付きしか使えなくなる GKNJMGN CHARMGN%, LINEMGN%
GKNJCMGN CHARMGN% とGKNJLMGN LINEMGN%
GKNJPRINT X%, Y%, S$
GKNJPUT(X%, Y%, C$)
GKNJPRINTAA X%, Y%, S$
アンチエイリアスをかけて文字列を描画する
低速 & エフェクト使用不可 GKNJPUTAA(X%, Y%, C$)
アンチエイリアスをかけて文字を描画、1文字専用
描画した文字を返す GKNJW() とGKNJH()
サブセット化ツールについて
フォントデータはこのままではとても大きいので、フォントをサブセット化するツール「KNJLIB_SUBTOOL」が含まれています。サブセット化とは、フォントデータから自分のプログラムで使いたい文字だけを選んで抽出することです。決まったメッセージしか表示しない場合は、これにより大幅にサイズを小さくできます。
「KNJLIB_SUBTOOL」を開き、フォントデータの指定、および抽出する文字の指定をプログラムを直接書き換える事で行います。抽出する文字は重複したものは自動で省くので、ゲーム中で使用する文章をそのまま渡しても構いません。実行すると、漢字ライブラリの命令にデータを渡すプログラムの形式で、サブセット化されたフォントデータが生成されます。
フォントデータのライセンスについて
ライブラリに添付されているフォントデータ (KNJLIB_FONTS1〜5) はさまざまな方の手によって作られたもので、それぞれにライセンス (使用条件) があります。
「ナガ10 」というフォントは、非営利 (つまり通常のプチコン作品など) での利用には「何の制限もありません」が、営利目的の場合は作者のかたに相談 (連絡) する必要があります。しかも、このフォントを配布しているサイトの最終更新は15年前であり、現在は連絡先が無効となっており、連絡できません。したがって、プチコンマガジン など、販売される機会がある場合は、ライブラリ内蔵の「M+ BITMAP FONTS 10」(GKNJFONT 4 で使える) に置き換えるなどしてください。
その他のフォントデータのライセンスは、以下のいずれかに該当します。どれに該当するかは、フォントデータの前にコメントで記載しています。
パブリックドメイン … 制作者により著作権の放棄、および一切の権利を行使しないことが宣言されているため、無条件で自由に使えます。M+ FONTS LICENSE … 著作権は制作者が保持していますが、制約なしに自由に使って OK とされています。SIL Open Font License 1.1 … ライセンス本文ではいくつかの条件が挙げられていますが、プチコンのプログラムに組み込んで使う分には特に気にすることはなく、自由に使えます。ライセンスを厳密に解釈すると、使用の際、フォントデータの前にある著作権表示と「SILオープンライセンス」と書かれたコメントを、フォントデータとセットでプログラムにコピーしておくとより好ましいと思われます。「jiskan16」「jiskan24」の半角文字 … ソニーに著作権がありますが、自由に使えます。フォントデータをコピーする際は、データの前にある「Copyright 1989 by Sony 〜」で始まるコメント1行も一緒にコピーしておいたほうが良いようです。 また、自家製ドットフォントシリーズ のうち、「ぱうフォント」と「恵梨沙フォント」は使用条件的に扱いづらいため含んでいません。それ以外は全部プチコン向けにコンバートしたデータがプロジェクト内に入っています。
スクリーンショット・動画
サイトに埋め込まれた状態でMiiverseの投稿をみるには、JavaScriptの動く環境が必要です。 Miiverseで投稿をみる。 公開キー
プチコン3号用の公開キーです。トップメニューの「作品公開とダウンロード」から公開キーを入力すると、作品をダウンロードすることができます。
この作品に対するコメントがあれば一言どうぞ。(作品に直接関係ない質問や雑談は掲示板 へ)
名無しさん : 怒涛の46種類！ ()hnakai : GKNJPRINTAA(アンチエイリアス漢字描画)でASCII文字以外の漢字やひらがなが描画できないようです。 ()プチコンまとめWiki管理人 : サンプルの通り「日比谷32」フォントでは描画できているので、フォントによるかもしれません。M+10/M+12のように縦か横のサイズ奇数だとエラーが出ます。それ以外にうまく動かない場合はそのフォントを教えてください。 ()MORIBU : これは素晴らしい！ありがたく使わせて下さい。 ()プチコンまとめWiki管理人 : どうぞご活用ください! どんな作品に使われるか楽しみにしてます! ()yuy@ : 事後報告となってしまいましたが、お借りしてこのようなプログラム を作らせていただきました。ありがとうございます！ ()スー : すごく便利ですありがとうございます！( ´ ▽ ` )ﾉ ところで確信は持てないのですけれど、KNJLIBの116行目、KNJTBL_TABLEDIRTY%って、KNJLIB_TABLEDIRTY%のことでしょうか？(・д・) ()スー : 追加なのですけれど、316行目のW＊Hは、W%＊H%かもしれません。また、VARで定義されていないローカル変数っぽいものが少しありました。OPTION STRICTを付けたプログラムに必要そうな部分だけコピペしてみたらエラーが出て、先ほど挙げたところを変えたらなんだか動くようになりましたので、一応ご報告だけ(・u・) ()スー : すみません！さらになのですけれど、332,349行目の色が#BLACK固定になっているので、エフェクトの色が反映されていない気がしました。そこをKNJLIB_EFFCOLOR%に変えたら反映されるようになったみたいです(u_u) ()natto- : 怒涛の公開キー６文字！ ()プチコンまとめWiki管理人 : スーさんごめんなさい、書き込みに今更気づきました。ご指摘いただいた点確認してみますね。ありがとうございます! ()まげ : 拙作「プチコロボの戦い」で使わせていただいたことを報告いたします。ありがとうございました。 ()カービィ★KIRBY : Miiverseのコメントにも書き込んでおいてあるのですが、これのフォントデータの構造がどのようになってるのかしっかり知りたいです。 簡単にコンバート出来るなら自分用にコンバートして使いたいのですが。 ()名無しさん : これって美咲フォントですか？ ()プチコンまとめWiki管理人 : 非常に遅い返信申し訳ありませんが、美咲フォント「も」入ってます。 ()プチコンまとめWiki管理人 : カービィ★KIRBYさんの質問の件、いまさらながらご本人に直接回答を差し上げましたが、気がむいたらWikiにも書きます。 ()直斗 : 管理人さんの漢字ライブラリー綺麗で凄いいいですそれに薬草など色々なアイテムのコメントが面白いです！ ()