本仕様書は、MSX2版『ファイナルファンタジー』(マイクロキャビン移植)で使用されている画像アーカイブ形式(拡張子 .PIC)のデータ構造、展開・圧縮アルゴリズムの仕様、および操作ツール FFPicTool の実装仕様を定義するものである。
ファイルは 固定48バイト(0x30)のヘッダ と、それに続く 可変長の圧縮ピクセルストリーム で構成される。
+0x00 +0x10 +0x30 終端
+------------+----------------------+------------------------------------+--------+
| 制御ヘッダ | パレットデータ | RLE圧縮ピクセルストリーム |Padding |
| (16バイト) | (32バイト: 16色×2B) | (可変長) |(0x00) |
+------------+----------------------+------------------------------------+--------+
|<------------------------------- 512バイト境界 --------------------------------->|
0x00〜0x0F:16バイト)MSX2のVDP(V9938)のグラフィックレジスタおよび矩形転送コマンド(HMMC等)に直結したパラメータ群である。数値はすべてリトルエンディアンで格納される。
| オフセット | サイズ | フィールド名 | 内容・解説 |
|---|---|---|---|
+0x00〜+0x01 |
2バイト | ScreenMode |
画面モード指定。全ファイル共通で 0x0005(MSX SCREEN 5: 256×212ドット、16色)。 |
+0x02〜+0x03 |
2バイト | DX |
転送先VRAM X座標(ドット位置)。全データ共通で 0x0000(X=0)。 |
+0x04〜+0x05 |
2バイト | DY |
転送先VRAM Y走査線番号(0〜255)。 |
+0x06〜+0x07 |
2バイト | NX (rowSize) |
転送幅(バイト数)。ピクセル数はこの2倍。 ・画面全幅: 0x0080(128バイト = 256ピクセル)・差分メニュー: 0x0058(88バイト = 176ピクセル) |
+0x08〜+0x09 |
2バイト | NY (rowCount) |
転送高さ(ライン数)。実ライン数がそのまま格納される(0オリジンではなく実数)。 |
+0x0A〜+0x0F |
6バイト | Reserved |
予約領域。内容未定義(不定値)。当時の開発環境におけるRAMバッファの残骸データがそのまま出力されており、実機の描画ルーチンでは参照されない。 |
SCREEN 5における1走査線のサイズは128バイト(0x80)である。ヘッダの DY からVRAM物理オフセットが一意に定まる。
\(\text{VRAM物理アドレス} = \text{VRAMページベース} + (DY \times 128) + (DX \div 2)\)
DY = 200 (0x00C8)0x18000)へ展開される場合:
\(0x18000 + (200 \times 128) = 0x18000 + 0x6400 = \mathbf{0x0001E400}\)| ファイル名 | DX (X) | DY (Y) | NX (幅) | NY (高) | 用途と配置意図 |
|---|---|---|---|---|---|
MENU_L1 |
0 | 0 (0x00) |
88バイト (176ピクセル) | 72行 (0x48) |
メニュー画面パーツ1。クラスチェンジ前のキャラ |
MENU_L2 |
0 | 0 (0x00) |
128バイト(256ピクセル) | 72行 (0x48) |
メニュー画面パーツ2。クラスチェンジ後のキャラ |
JOBS_L1 |
0 | 192 (0xC0) |
128バイト(256ピクセル) | 48行 (0x30) |
ジョブ別16×16歩行キャラ。クラスチェンジ前 |
JOBS_L2 |
0 | 192 (0xC0) |
128バイト(256ピクセル) | 48行 (0x30) |
ジョブ別16×16歩行キャラ。クラスチェンジ後 |
FONT |
0 | 200 (0xC8) |
128バイト(256ピクセル) | 40行 (0x28) |
8×8フォント(文字・記号・枠線)通常 |
FONT2 |
0 | 128 (0x80) |
128バイト(256ピクセル) | 40行 (0x28) |
8×8フォント(文字・記号・枠線)アルファベット |
0x10〜0x2F:32バイト)MSX2 VDP(V9938)のパレットレジスタ(16色 × 各色2バイト)がそのまま格納されている。
0 R2 R1 R0 0 B2 B1 B0(赤: 3bit、青: 3bit、各0〜7)0 0 0 0 0 G2 G1 G0(緑: 3bit、0〜7)同一バイトの2連続を契機としてラン長を展開する、同値2バイト連続検出型のランレングス圧縮(RLE)である。
実機の圧縮データは走査線単位(1行=$NX$ バイト)で完結するように圧縮されており、走査線境界を跨いでランが継続することはない。展開処理は各走査線ごとに独立して実行する。
各走査線(行)について、行内出力カウンタ(rowBytes)を 0 に初期化して以下を行う。
Byte1)。rowBytes を +1 する。rowBytes が行幅($NX$)に達した場合、その行の展開を完了して次の行の処理へ進む(ストリームの次のバイトは次行の先頭バイトとして処理される)。Byte2)を参照する。
Byte2 != Byte1 の場合:Byte1 は単独バイトとして確定(すでに1バイト出力済み)。Byte2 は消費せず、次のループの Byte1 として扱う。Byte2 == Byte1 の場合:ランモードへ移行。Byte2 をストリームから消費し、続く3バイト目から ラン長(count) を読み込む。Byte1)を 残り count - 1 回 繰り返し出力する(rowBytes をその分加算する)。rowBytes が行幅($NX$)に達するまで 1. 〜 4. を繰り返す。0x6B(107バイト) とする。0x6B(107バイト)を超える場合は、一度 0x6B でランを打ち切り、残余分は後続のデータとして改めてエンコードする(残余が2バイト以上なら再度ランを形成し、1バイトなら単独バイトとして出力する)。AA AA 02)。DSKIO)は、すべてセクタ単位(512バイト=0x200)で入出力を行う。0x200 の倍数まで 0x00 でパディングされる。Say DOS Version 1.A0 と表示されるファイルシステム)にある単体ファイル(FONT.PIC 等)だけでなく、プログラムバイナリ(BATTLE.COM 等)のアセンブラ内にセクタ番号が直接ハードコードされて配置されているグラフィックが存在する。address)を指定する機能を備える。ヘッダは、MSX2 VDP(V9938)の画面モード(SCREEN 5)、CPU-VRAM間高速矩形転送コマンド(HMMC)の転送先座標・サイズパラメータ、パレットレジスタ設定値で構成されていて、MSXで扱いやすい形になっている。
NX)と高さ(NY)が明記されているため、展開データは $NX \times NY$ バイトのリニア配列 である。FFPicTool の構成仕様本ツールは 「可逆圧縮・展開を行う純粋なアーカイバ」 として設計する。
プログラム内部では「制御ヘッダ」「パレット」「ピクセルデータ」の3つの要素に分けられる。データ構造は以下のように定義する。
[PicAsset Object]
├── Header
│ ├── ScreenMode : uint16 (0x0005: SCREEN 5)
│ ├── DestX : uint16 (DX: 通常 0)
│ ├── DestY : uint16 (DY: VRAM走査線位置)
│ ├── WidthBytes : uint16 (NX: 1行のバイト幅。ピクセル幅 = NX × 2)
│ ├── HeightLines : uint16 (NY: ライン数)
│ └── ReservedBytes : 6バイト (制御ヘッダ生データ維持用)
├── Palette[16] : 16色の配列
│ ├── Raw : uint16 (V9938生データ: 0RRR0BBB 00000GGG)
│ ├── RGB333 : [R: 0-7, G: 0-7, B: 0-7]
│ └── RGB888 : [R: 0-255, G: 0-255, B: 0-255]
└── Pixels : byte[] (サイズ: WidthBytes × HeightLines)
出力形式:
展開したデータは、「制御ヘッダ」「パレット」「ピクセルデータ」の各要素を用途に合わせて以下のファイルへ分けて出力する。
なお、アドレス指定オプション(-a)を指定して展開した場合は、ファイル名衝突の防止および抽出元アドレス特定の利便性のため、ベースファイル名末尾に _0x{0埋め5桁揃え16進数アドレス} を自動付加する(例: hoge.pic -a 0x200 の場合、hoge_0x00200.png、hoge_0x00200.json、hoge_0x00200.bin を出力。アドレス値が0であってもオプションが指定された場合は付加する)。
*.bin)(出力内容: 制御ヘッダ、パレット、ピクセルデータ):
*.json)(出力内容: 制御ヘッダ、パレット):
raw(16進数文字列)、rgb333: [R, G, B](MSX2 V9938パレットレジスタ準拠の3bit値: 0〜7)、rgb888: [R, G, B](24bitカラー換算値: 0〜255)の形式で記述し、各色成分を個別の独立フィールドに細分化せず配列として保持する。rgb333 および rgb888 などの短い数値配列は要素ごとに改行せず、[R, G, B] のように1行(インライン形式)で整形して出力する。入力形式と各要素の取得方法: 入力するファイルの形式に応じて、「制御ヘッダ」「パレット」「ピクセルデータ」を以下のように取得する。
*.json(メタデータ)が存在すればそこから取得する。コマンドライン引数(-x, -y 等)や --keep-header による既存PICファイルまたは非圧縮バイナリからの引継ぎ指定があればそれを最優先で反映する。いずれの指定もない場合は $DX=0, DY=0, Reserved=0x00 \times 6$ で初期化する。*.bin)を入力とする場合:
Byte Byte Count)。0x6B(107バイト) とし、連続バイト数がこれを超える場合は一度 0x6B でランを打ち切り、残余分を後続のデータとして改めて処理する。02 を付加して出力する(AA AA 02)。-unlimited-run)を設ける(ただし行境界を跨がない制約は維持する)。0x200)の倍数になるよう、末尾を 0x00 でパディングする。既存の C# 版ツール「FF MSX GFX」(final-fantasy-msx2-de-compressor)における実装上の不具合および動作解析をメモにまとめた。
C#版の DumpAllGeneral では、解凍処理 FFMSXFont.Decompress の戻り値(ピクセルバイト配列のみ)をそのままファイルに書き出していた。これにより、先頭48バイトに存在した「サイズ(NX, NY)」「VRAM配置座標(DX, DY)」「パレット」がすべて破棄され、展開後の .bin ファイルから元の画像構成を再現することが不可能になっていた。
C#版の Decompress ルーチンでは、実機の仕様通り行内カウンタ d = rowSize を用いて走査線境界を管理していた。しかし、幅が128バイト未満のデータに対して画面全幅(128バイト)へ引き伸ばそうとする空ループ(for (int i = rowSize; i < maxRowSize; i++) decompSize++;)を誤って挿入していた。
さらに、RLE展開ループ(do { output.Add(a); decompSize++; d--; b--; } while (b > 0);)の内部で行内カウンタ d のゼロ判定を行っていなかったため、もしデータ内で行境界を跨ぐようなランが存在した場合に d がアンダーフロー(0 -> 255)を起こす構造的欠陥を抱えていた。その結果、行末判定がスキップされてループの歩進が狂い、展開処理が規定サイズで停止せずファイル末尾を突き抜けて肥大化したゴミデータを出力していた。
C#版では展開終了サイズの算出に (rowCount + 0x1) * maxRowSize を用いており、ヘッダのライン数に対して意図的に 1 行多くループを回していた。
さらにラン展開ループ内に総サイズ超過判定がなかったため、最後のランが展開された際に規定サイズを突き抜け、例えば 40 ラインのデータ(FONT.PIC: 本来 5,120 バイト)に対して 42 ライン分(5,376 バイト)まで余計に出力されていた。
C#版 Compress ルーチンの 122 行目付近にある連続バイト数算出処理において、ループ終了判定が以下のように記述されていた。
if (j+1 < uncompressed.Length || uncompressed[j] != uncompressed[j+1]) break;
条件が ||(OR)で結合されていたため、1 回目のループ(j+1 < uncompressed.Length が真)で必ず break してしまい、変数 totalFill は常に 1 となっていた。このため、直後に記述されていた端数調整式 (totalFill % 0x6a == fillLength) は一切機能せず、実質的には fillLength == 0x6b の強制ブレークのみによってラン分割が行われていた。
C#版の Compress(uncompressed, destBytes) は、第2引数として既存の圧縮ファイル(destBytes)を要求し、その先頭48バイトをそのままコピーして使い回していた。このため、画像サイズの変更やパレットの編集、新規グラフィックの作成をツール単体で行うことができなかった。