Wartbed:Files/Formats
From Dark Omen Wiki
Description of WARTBED file formats.
Contents |
Geometry
.ZIP archive with .model extension. Archive containing the following file types and extensions (can conatin any number of all file types except meshes.desc).
(.zip archive)
| model.desc | text | (1) |
| filename.vertices | text | (2) |
| filename.indices | text | (3) |
| filename.bmp/jpg/png | bitmap | |
| filename.skeleton | ??? | |
| filename.animation | ??? |
Model description
(text file)
{
vertices : filename.vertices;
indices : filename.vertices;
offset : [x,y,z];
}
Mesh_2_name
{
...
Vertices
Space, tab, '[', ']' and ',' are all valid separators and can be exchanged for reabability. Separators should be able to follow each other (cross your fingers).
The first block is identified by the keyword "definition" (of rather, any character sequence starting with "def") and details the components are their order in a vertex. Valid tokens are "xy" for a two-float dataype, "xyz" for a three-float , "xyzw" for a four-float; and "argb", "bgra" and "rgba" for four-byte colours.
Valid field names are "position", "normal", "diffuse", "specular", "emissive" and "texture coordinate". There can be multiple fields of the same type in a vertex, however, it is not yet defined how WARTBED handles this.
The second block is identified as "vertices" (or "vtx"). Every vertex is numbered (though item identifiers are actually ignored when parsing). Multiple vertex blocks are appended into one consecutive vertex buffer (regardless of vertex numbering).
(text file)
{
xyz : position;
xyz : normal;
argb : diffuse;
argb : specular;
argb : emissive;
xy : texture coordinates;
}
vertices
{
0 : [1,2,3] [0,1,0] 0xFFFFFFFF, 0xF0F0F0F0, 0x10101010 [0,0];
1 : [4,5,6] [1,0,0] 0xFFFFFFFF, 0xF0F0F0F0, 0x10101010 [1,1];
Indices
As for vertices. space, tab, '[', ']' and ',' are all valid separators and can be exchanged for readability, and separators should be able to follow each other.
Each faces block is created in a new index buffer, depending on parsing parameters.
(text file)
textures
{
0 : texture1.png;
1 : texture2.jpg;
}
definition
{
123 : indices;
xyz : normal;
id : texture;
}
faces
{
0 : 1,2,3 [0,1,0] 0;
1 : 2,3,5 [0,0,1] 1;
}
faces //requesting creation in new index buffer
{
...
Sprites
A spritesheet it a texture where every frame of a sprite is laid out. A sprite may have several spritesheets. Notice that if frames are cropped to minimal rectangles their in-game size will vary. Size frames to reflect their in-game size.
| sprite.desc | text | (1) |
| spritesheet.bmp/jpg/png | bitmap | (2) |
Map
placeholder line
Items
Description of item (principally weapons and armour) definition format.
Units
Description of unit (races and classes) definitions format.
Army
Description of army definition. Armies are sets of regiments of units of a race, class and with equipment.
Mission
A mission is composed of a map, engagement parameters (zones and rules), armies and victory conditions.
Cutscene
A cutscene can be interactive or non-interactive. It can follow simple scripting.
Campaign
Campaigns are sequences of cutscenes and missions, the order of which are determined by simple scripting.
