ファイルフォーマット

エルフレイナ独自のファイル内部の形式を説明します。

[.elp]ファイル

エルフレイナで出力するプロジェクトファイルです。このファイルはエルフレイナのバージョンによってパラメータなどが変わることが多いので載せていません。

ファイル形式

テキストファイルです。

文字コード

ファイルの文字コードは「UTF-8」です。

[.elem]ファイル

「エルフレイナ拡張モデルファイル」です。「モデルデータ」「階層構造」「レンダリングメッシュリスト」「アニメーションデータ」を含むことが出来ます。

対応エルフレイナバージョン

エルフレイナ Ver1.1 時点でのフォーマットです。

ファイル形式

テキストファイルです。

文字コード

ファイルの文字コードは「UTF-8」です。

テキストの基本形式

「.elp」「.elem」ファイルともにテキストの構成は下のようになっています。

Elfreina Extension Model File
File Version 1.00
MeshDatas {
    MeshContainerCount=1
    MeshContainer {
        Name="ルーン"
        MeshCount=12
        VertexFormat {
            "Position"
            "Normal"
            "Texture1"
        }
    }
}

ヘッダ

Elfreina Extension Model File
File Version 1.00

最初の２行はヘッダです。１行目は上記の通りです。２行目はファイルフォーマットのバージョンですが、変わることはめったにありません。

タグとスコープ

MeshDatas {
    ;
    ;
}

青文字がタグ名と呼ばれ、そのあとにある「{ }」の間を「MeshDatas のスコープ」と呼びます。「タグ名」と「{」は同じ行になければいけません。

スコープの中には「複数のデータ（キーも）」「複数のスコープ」が含まれます。

キーとデータ

MeshContainerCount=1
MeshContainer {
    Name="ルーン"
    MeshCount=12
    VertexFormat {
        "Position"
        "Normal"
        "Texture1"
    }
}

緑の文字がキー、赤の文字がデータとよばれ、キーとデータの間は「=」で区切られます。データが文字列の場合は「""（ダブルクォーテーション）」で囲まれます。 キーやデータが途中で改行されることは基本的にありません。

例として、上のテキストの３行目のデータは「MeshDatas スコープ内の MeshContainer スコープ内の Name キーの "ルーン" データ」となります。

また、= で区切られていない単体文字列の場合は「データ」のみとなります。この場合は、スコープ内に列挙されることが多いです。

キーとデータの並び順、またスコープの並び順は基本的に関係ありません。ただし、データのみの列挙は場合により並び順が関係することがあります。

補足ですが、一番最初の２行のヘッダは、実はデータであり「グローバルスコープ内のデータ」という風に定義されています。

複数のデータ

Ambient=0.43:0.43:0.43:0.43
3,0:1:2

場合によってはひとつのキーに複数のデータが含まれることがあります。この場合は、データとデータの間に「:（コロン）」の区切り文字が入ります。

また、第２分割方法として、「,（コンマ）」が使用されることがあります。データの内容をより分割する場合に使用します。

複数のデータがある場合は、上の方法かスコープで列挙される形のどちらかが使用されます。

フォーマット（設定データ）

Setting スコープ

汎用設定データが含まれます。

キー一覧

フォーマット（モデルデータ）

MeshDataList スコープ

モデルデータ（メッシュ）を保存しているスコープです。エルフレイナ Ver 1.00 時点ではひとつのメッシュしか保存されませんが、複数のメッシュを保存させることも出来ます。

キー一覧

スコープ一覧

MeshContainer スコープ

メッシュ作成に必要なデータが含まれています。

キー一覧

スコープ一覧

VertexFormat スコープ

メッシュを作成するときに必要な頂点フォーマットの一覧です。キーは存在せず、必要なデータのみが列挙されます。

データ一覧

BoneNames スコープ

メッシュで使用されるボーンの名前リストが列挙されています。名前の並びはボーンの座標変換パレットのインデックスと一致するようになります。

OffsetMatrices スコープ

メッシュで使用されるボーンのオフセットマトリックスです。BoneNames に列挙されている名前とインデックスが一致されています。

Materials スコープ

複数のマテリアル情報が含まれています。

キー一覧

スコープ一覧

Material スコープ

材質色やテクスチャー情報が含まれています。

キー一覧

Mesh スコープ

メッシュコンテナ内で分割されているメッシュを保存しています。エルフレイナなどでメッシュ表示切替やアニメーションなどで個別に切り替えが出来るようになります。

キー一覧

スコープ一覧

Positions スコープ

頂点の位置データが列挙されます。

データ一覧

Normals スコープ

頂点の法線データが列挙されます。

データ一覧

Diffuse スコープ

頂点のディフューズ色データが列挙されます。

データ一覧

BlendList スコープ

頂点ブレンドに関するデータが列挙されます。

スコープ一覧

BlendPart スコープ

各ボーンに対応した頂点インデックスなどが格納されています。

キー一覧

スコープ一覧

VertexBlend スコープ

ボーンに対応した頂点インデックスとウエイト値が列挙されています。

データ一覧

TextureUV スコープ

頂点のテクスチャ ＵＶ座標データが列挙されます。

データ一覧

VertexIndices スコープ

面の画数、頂点インデックスが列挙されます。

データ一覧

Attributes スコープ

面のマテリアルインデックスが列挙されます。

データ一覧

フォーマット（階層構造データ）

HierarchyList スコープ

階層データが含まれています。

スコープ一覧

Node スコープ

オフセットマトリックスや、初期姿勢データが含まれています。このデータは階層化されています。

キー一覧

スコープ一覧

フォーマット（レンダリングメッシュリスト）

RenderingMeshList スコープ

レンダリングメッシュリストのデータが含まれています。

キー一覧

スコープ一覧

RenderingMesh スコープ

描画するメッシュの名前と、使用する階層データの名前が列挙されています。

キー一覧

スコープ一覧

HierarchyNames スコープ

階層データの名前が列挙されています。これは主にスキンメッシュなどの座標変換パレットでどのマトリックスを使用するかを決めるためにあります。 　頂点ブレンドを使用しない場合は、基本的にここに列挙されるデータは１つのみになります。

データ一覧

フォーマット（アニメーションデータ）

AnimationList スコープ

アニメーションに関係するデータが含まれています。

キー一覧

スコープ一覧

AnimationData スコープ

個々のアニメーションデータが含まれます。

キー一覧

スコープ一覧

BoneAnimation スコープ

ボーンアニメーションに関わるデータが含まれます。

スコープ一覧

AnimationPart スコープ

ボーンごとのアニメーションデータが含まれます。

キー一覧

スコープ一覧

UVAnimation スコープ

UVアニメーションに関わるデータが含まれます。

スコープ一覧

AnimationPart スコープ

個々のアニメーションデータが含まれます。

キー一覧

スコープ一覧