メッセージバイナリフォーマット

ここでは、メッセージバイナリファイル(*.msbt)のフォーマットを解説します。 ブロックフォーマットに基づいて構成されるので、その解説も合わせてご覧ください。 メッセージバイナリファイルは、言語設定ごとに分かれてリソース化されます。 従って、ファイルを読み込むタイミングで言語設定にあわせたファイルをロードすることで、その言語に対応するモードでゲームを起動することが可能です。

通常、このページに書かれている内容を気にする必要はありませんが、libmsを利用する上での理解の助けとなります。 バイナリフォーマットへアクセスする場合はlibmsのAPIを利用することで簡単に取得することが可能です。

ラベルブロック(LBL1)

ラベルブロック(LBL1)は、ラベルと、それに対応したインデックス番号の関連付けが可能なブロックです。 インデックス番号とは、後述するテキストブロック(TXT2)における、メッセージの格納順序を表す連続した番号のことです。 インデックス番号は0から開始されます。

ラベル番号は、ASCIIコード範囲において255文字以内でつけることが可能で、MessageStudio上で設定することが可能です。 詳しくはメッセージ編集の基本操作をご覧ください。 このブロックは、ラベル文字列のハッシュ値によってルックアップするため、ラベルの数が増えても検索効率がそんなに変わりません。

ラベルブロックは、ブロックヘッダの後に以下のようなデータ構造を持ちます。

上述の部分が終わった直後から、ラベルとインデックス番号の対応表のリストが記述されます。 プログラムは、ハッシュ値からブロック上のオフセットを求めた上で、この領域へアクセスします。

上記のラベルとテキストインデックスの組み合わせは、順番にテキストの数だけ出現します。 求めたオフセット位置の直下に違うラベル情報が存在している場合があります。 これは、特定のハッシュ値に対して複数のラベルが登録されているからです。 その場合は読み飛ばして次のラベルと一致するかを確認します。

テキストブロック(TXT2)

テキストブロックには、ユーザーが実際に入力したテキスト情報が記述されます。 テキスト情報にはタグが含まれることがあります。 中身については別のページにまとめましたのでそちらをご覧ください。

属性ブロック(ATR1)

テキストごとの属性情報を保存するためのブロックです。 ひとつのテキスト情報ごとに固定長の構造体としてデータを取得可能です。 データはプロジェクト設定ごとに異なるため、属性定義ヘッダファイル(*.h)か プロジェクトバイナリファイル(*.msbp)を出力してデータにアクセスしてください。

プロジェクトの属性情報の中に、NULL終端文字列型として定義されているものがあった場合、 可変長の文字列の代わりにその部分に4バイトの情報が入ります。 この値は、ブロック開始位置から文字列開始位置へのオフセットが保存されます。