Format

Describes elfreina's own file interior format.

[.elp] file

Project file to be output by Elfreina. This file is not listed because parameters and the like often change depending on the version of Elfrina.

File format

Text file.

Character code

The character code of the file is UTF-8.

[.elem] file

"Elfreina Extension Model File". It can include "model data", "hierarchical structure", "render mesh list", and "animation data".

Supported ElFrena version

The format as of Elfrina Ver1.1.

File format

Text file.

Character code

The character code of the file is UTF-8.

Basic format of text

The text configuration of both ".elp" and ".elem" files is as follows.

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

Header

Elfreina Extension Model File
File Version 1.00

The first two lines are headers. The first line is as described above. The second line is a version of the file format, but it rarely changes.

Tags and scopes

MeshDatas {
    ;
    ;
}

The blue letter is called the tag name, followed by the "{ }" is called "MeshDatas scope". "Tag name" and "{" must be on the same line.

Some scopes include "multiple data (keys too)" and "multiple scopes".

Keys and data

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

The green character is called the key, the red character is called the data, and the key and the data are separated by a "=". If the data is a string, it is enclosed in "" (double quote). Keys and data are basically not broken in the middle.

As an example, the data in the third line of the text above is "Rune data" of the Name key in the MeshContaier scope in the MeshDatas scope.

In addition, for single strings that are not separated by =, only "data" is available. In this case, it is often enumerated in scope.

The order of keys and data, and the order of scopes, is basically irrelevant. However, the order of enumerating data only can be related in some cases.

As a side note, the header of the very first two rows is actually data and is defined in the way of "data in global scope".

Multiple data

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

In some cases, a key can contain more than one piece of data. In this case, the ":(colon) delimiter) is placed between the data.

In addition, ",(comma)" may be used as a second division method. Use to further divide the contents of the data.

If there is more than one data, either the above method or the form enumerated in the scope is used.

Format (configuration data)

Setting scope

Contains generic configuration data.

List of keys

Format (model data)

MeshDataList Scope

The scope in which model data (mesh) is stored. As of Elfreina Ver 1.00, only one mesh is saved, but multiple meshes can be saved.

List of keys

Scope list

MeshContaizer Scope

Contains the data needed to mesh.

List of keys

Scope list

VertexFormat Scope

A list of vertex formats required to create a mesh. The key does not exist, and only the data that is required is enumerated.

List of data

BoneNames scope

An enumerated list of names of bones used in the mesh is listed. The names now match the index of the bone's transform palette.

OffsetMatrices Scope

Offset matrix of the bones used in the mesh. The names and indexes listed in BoneNames match.

Materials Scope

Contains multiple material information.

List of keys

Scope list

Material scope

Contains material color and texture information.

List of keys

Mesh scope

Saving meshes that are split in a mesh container. You will be able to switch individually, such as mesh display switching and animation, such as Elfrina.

List of keys

Scope list

Positions scope

Enumerates vertex location data.

List of data

Normals scope

Enumerates the normal data for the vertices.

List of data

Diffuse scope

Enumerates the diffuse color data for the vertex.

List of data

BlendList scope

Enumerates data about vertex blends.

Scope list

BlendPart scope

Contains vertex indexes, etc. for each bone.

List of keys

Scope list

VertexBlend Scope

The vertex index and weight values corresponding to the bone are listed.

List of data

TextureUV scope

Enumerates texture UV coordinate data for vertices.

List of data

VertexIndices Scope

The number of strokes and vertex index of the face are enumerated.

List of data

Attributes scope

The material index of the face is enumerated.

List of data

Format (hierarchical data)

HierarchyList Scope

Contains hierarchical data.

Scope list

Node scope

Includes offset matrix and initial attitude data. This data is hierarchical.

List of keys

Scope list

Format (render mesh list)

RenderingMeshList Scope

Contains data from the rendered mesh list.

List of keys

Scope list

RenderingMesh Scope

Lists the names of the mesh to draw and the name of the hierarchical data to use.

List of keys

Scope list

HierarchyNames Scope

The names of the hierarchical data are enumerated. This is primarily to determine which matrix to use in coordinate transformation palettes such as skin meshes. 　If you do not use vertex blending, there is basically only one data listed here.

List of data

Format (animation data)

AnimationList scope

Contains data related to the animation.

List of keys

Scope list

AnimationData scope

Contains individual animation data.

List of keys

Scope list

BoneAnimation Scope

Contains data related to bone animation.

Scope list

AnimationPart Scope

Contains animation data for each bone.

List of keys

Scope list

UVAnimation Scope

Contains data related to UV animation.

Scope list

AnimationPart Scope

Contains individual animation data.

List of keys

Scope list