データ構造

バイナリファイルでの基本的なデータ構造はレコードと呼ばれる．レコードの構造は以下のようになっている．

struct record
{
  // application specific tag to identify content type
  tag_id_type tag_id;
  // length of payload
  payload_length_type length;
  // Payload/content of the record
  bytepayload[ length ];
};

tag_id_type というのはヘッダのidtag_lengthによって決まる型で，file version が 0x 0000 1000のファイルにおいては，1バイトの符号なし整数値であり，同様にpayload_length_type というのはヘッダのlength_lengthによって決まる型で，file version が 0x 0000 1000のファイルにおいては，2byteの 符号なし整数値となる．

bytepayloadは，tag_idの値によって中身の解釈が変わるレコードのデータそのもので length バイトにわたって続く．

ペイロードにレコードが入ることもある

ファイル構造

ファイルの先頭は以下の形式になる．

    +——–+——–+——–+——–+
    |   file version number (32bit)     |
    +——–+——–+——–+——–+
    |   app. version number (32bit)     |
    +——–+——–+——–+——–+
    |   idtag_length  |  length_length  |
    +——–+——–+——–+——–+

file version number

ファイル形式のバージョンをあらわす 32bit の値．現行のフォーマットでは 0x 0000 1000. このうち，上位20bitがメジャーバージョン，下位12bitが マイナーバージョンを表す．

古いソフトがファイルをうまく読めなくなるほどに形式が変わったときにはメジャーバージョンが変わる(？)．ソフトウェアが読めるメジャーバージョンと違うバージョンなら読んではいけない． Changes in the minor version must not be used if the file format is changed in such a manner that older versions of the software cannot read the file successfully. If the major version number is newer (or older) than the application can read, it must not read the file.

app. version number

扱うファイルやソフトで解釈される値．32bit．

idtag_length

レコードでの tag_id が何バイトで表されるかを示す16bitの値．今のところ 0x0001

length_length

レコードでの長さのフィールドが何バイトで表されるかを示す16bitの値．今のところ0x0002

idtag_lengthlength_lengthなどの整数値のサイズはメジャーバージョンに対して固定とされている．

この96128bitのヘッダの後に，レコードがぞろぞろと書かれることになる．