ODFL File Format

struct String {
	ubyte length;
	char str[length]; // non null terminated
};
 
struct Vert {
	float x, y, z;
};
 
typedef Vert[3] Matrix;
 
struct Connect {
	ushort connect_id; // id to vertex at this connection
	float u;
	float v;
	ubyte alpha;
};
 
struct Face {
	ubyte connects;
	Connect[connects]; // edges of the faces
	sbyte portal_num; // -1 for no portal
	Vert normal;
	ushort lmi_handle;
};
 
// contains all faces in one room
struct FacesInRoom {
	uint num_faces;
	Face[num_faces]; // all faces in this room
}
 
struct TextureInfo {
	String name;
	float r,g,b, alpha; // emitted light. unused at the moment.
};
 
struct Material {
	ushort texture_id;
	short lightmap_id; // handle to the bitmap, -1 if lightmaps are not supported by format
	ushort num_faces;
	ushort face_ids[num_faces]; // indexes to faces with this Texture
};
 
struct Object {
	ubyte type;
	uint room_num; // TODO: ushort!!
	Vert position;
	Matrix orientation;
	String name;
};
 
struct LightMap {
	short width, height;
        ubyte xspacing, yspacing; // use not clear by now
        Vert upperleft; // upper left corner of lightmap (in 3D)
	ushort data[width*height];
};

struct header {
	char[4] ODFL;
	ubyte major_version; // for the current version, see the very top of this page.
	ubyte minor_version;
	String name;
	String notes;
	String designer;
	String copyright;
	ushort num_rooms;
};
 
struct verts {
	uint num_verts;
	Vert[num_verts];
};
 
struct faces {
	FacesInRoom[num_rooms]; // faces, sorted by rooms
};
 
struct textures {
	ushort num_textures;
	TextureInfo texture_names[num_textures];
	uint num_materials;
	Material materials[num_materials]; // ordered by rooms
};
 
struct objects {
	ushort num_objs;
	Object objs[num_objs];
};
 
struct lm_data {
	uint num_lightmaps; // zero if lightmaps are not supported. TODO: short better?
	LightMap lm[num_lightmaps];
};