MapInfo (File Format)
Jump to navigation
Jump to search
The MapInfo file (Component List type 'mapi') contains initial information about the map, such the map dimensions, camera bounds, loading screen, and some flags.
Format
The MapInfo file doesn't seem to follow a static structure; instead, information seems to be sequentially dumped into the file. The Version field indicates changes in certain values. The '0x15', '0x17', '0x18' columns indicate if that field is present in that version.
Fields of type "Int" are four-byte values. "Words" are two-byte values. "Strings" are null-terminated arrays of bytes. An empty string is one null byte. "[]" indicates that a field is a non-string array.
| Type | Name | 0x15 | 0x17 | 0x18 | Description |
|---|---|---|---|---|---|
| Int | Magic Number | Y | Y | Y | 0x4D617049, or "IpaM" |
| Int | Version | Y | Y | Y | Indicates which MapInfo format to use. |
| Int | Unknown | N | N | Y | Unknown? |
| Int | Unknown | N | N | Y | Unknown? |
| Int | Width | Y | Y | Y | Total width of the map. |
| Int | Height | Y | Y | Y | Total height of the map. |
| Int | Unknown | Y | N | N | Presumably this is the same as Preview Image in 0x17? If it is, the next value will be a string if this is 2. (And if it is, combine them here) |
| Int | Small Preview Image | N | Y | Y | Indicates the small preview image. 0 indicates that no preview is used; 1 uses a minimap image; and 2 uses a custom image.
|
| String | Custom Image | N | Y | Y | This value only exists if Small Preview Image is 2.
|
| Int | Large Preview Image | N | Y | Y | Indicates the large preview image. 0 indicates that no preview is used; 1 uses a minimap image; and 2 uses a custom image.
|
| String | Custom Image | N | Y | Y | This value only exists if Large Preview Image is 2.
|
| Int | Unknown | Y | Y | Y | Unknown. (In 0x15 there is a chance that this would be the second preview image, but I don't have any evidence to support this.) |
| String | Fog of War ID | Y | Y | Y | Indicates the ID of the Fog of War the map uses. |
| String | Texture Set ID | Y | Y | Y | Indicates the ID of the Texture Set the map uses. |
| Int | Camera Bound Left | Y | Y | Y | This value is 7 less than the value shown in the editor. (A value of 0 would be interpreted as 7) |
| Int | Camera Bound Bottom | Y | Y | Y | This value is 4 less than the value shown in the editor. (A value of 0 would be interpreted as 4) |
| Int | Camera Bound Right | Y | Y | Y | This value is 7 more than the value shown in the editor. (A value of 0 would be interpreted as -7) |
| Int | Camera Bound Top | Y | Y | Y | This value is 4 more than the value shown in the editor. (A value of 0 would be interpreted as -4) |
| Int | Base Height | Y | Y | Y | This value is 4096*Base Height in the editor (giving a decimal value). |
| Int | Loading Screen Type | Y | Y | Y | Use 0 for the Melee (Default) loading screen. Use 1 for a custom loading screen. |
| String | Loading Screen Image | Y | Y | Y | MPQ path to the image. |
| Word? | Unknown | N | Y | Y | Seems to be 0? |
| Int | Image Scaling | Y | Y | Y | Indicates how the loading screen is scaled. 0 uses normal scaling, 1 uses aspect scaling, and 2 stretches the image.
|
| Int | Text Position | Y | Y | Y |
-1 = (Default) 0 = Top Left 1 = Top 2 = Top Right 3 = Left 4 = Center 5 = Right 6 = Bottom Left 7 = Bottom 8 = Bottom Right |
| Int | Text Position Offset X | Y | Y | Y | |
| Int | Text Position Offset Y | Y | Y | Y | |
| Int | Text Position Size X | Y | Y | Y | |
| Int | Text Position Size Y | Y | Y | Y | |
| Int | Flags | Y | Y | Y | Can be any combination of the following values:
0x00000001 = Disable Replay Recording 0x00000002 = Wait for Key (Loading Screen) 0x00000004 = Disable Trigger Preloading 0x00000008 = Enable Story Mode Preloading 0x00000010 = Use Horizontal Field of View |
| Int | Unknown | Y | Y | Y | Unknown |
| Int | Player Count | Y | Y | Y | How many players have been set. Specifically, how many times the next entry exists. |
| See Below[] | Player Info | Y | Y | Y | One data structure for each player in Player Count. |
| Int | Basic Team Start Locations | Y | Y | Y | How many start locations are used in Basic Team Settings. Specifically, how many of the next field exists. |
| Int[] | Point Indexes | Y | Y | Y | One point index for each start location used. The editor limits these to only Start Locations and not regular points. |
| Int | Start Location Count | Y | Y | Y | Additionally indicates how many start locations are used? |
| Int | Number of Bits | Y | Y | Y | Indicates how many bits the next field contains. (Number of Bits = (Start Location Count * (Start Location Count + 1)) / 2) |
| Variable | Alliance Flags | Y | Y | Y | The size of this field is ceil(Number of Bits / 8).
A set bit (1) indicates that the pair of Start Locations are to be allied. bit = 1; // Set up a bitmask
// i will be the first Start Location in the Point Indexes array
// j will the the Start Location after i
for(i=0;i< Start Location Count;i++){
for(j=i+1;j < Start Location Count;j++){ // set j, and then iterate through the rest
bit <<= 1; // Shift left to move the mask to the next bit.
if((Team Enemy Flags & bit) != 0) { // These start locations are allies
// Add more to compensate for byte boundaries. This array can get big.
}
}
}
|
| Int | Advanced Team Start Locations | Y | Y | Y | How many start locations are used in Advanced Team Settings. Specifically, how many of the next field exists. |
| Int[] | Point Indexes | Y | Y | Y | One point index for each start location used. |
| Int | Team Count | Y | Y | Y | How many teams are used in Advanced Team Settings. Specifically, how many of the next field exists. |
| Int[] | Team Members | Y | Y | Y | One set for each team. Each bit corresponds with the Point Indexes array index (i.e., bit 0 is PointIndexes[0], bit1 is PointIndex[1], etc.). If the bit is set, that start location is a part of that team. |
| Int | Team Count 2 | Y | Y | Y | Additionally indicates how many teams exist? |
| Int | Number of Bits | Y | Y | Y | Indicates how many bits the next field contains. (Number of Bits = (Team Count * (Team Count + 1)) / 2) |
| Variable | Team Enemy Flags | Y | Y | Y | The size of this field is ceil(Number of Bits / 8).
A set bit (1) indicates that the pair of teams are to be enemies. bit = 1; // Set up a bitmask
// i will be the first Team in the Team Members array.
// j will be the Team that comes after i
for(i=0;i< Team Count;i++){
for(j=i+1;j < Team Count;j++){ // set j, and then iterate through the rest
bit <<= 1; // Shift left to move the mask to the next bit.
if((Team Enemy Flags & bit) != 0) { // These teams are enemies
// Add more code to compensate for byte boundaries.
}
}
}
|
Player information data structure
This data structure contains all of the information about the players. Multiple copies of these exist in the MapInfo file (one for each player).
| Type | Name | Description |
|---|---|---|
| Byte | Player | Number identifying the player. |
| Int | Control | Indicates the type of player.
0 = Default? 1 = User 2 = Computer 3 = Neutral 4 = Hostile More? |
| Int | Color | Indicates the color of the player.
-1 = (Any) 0 = White 1 = Red 2 = Blue 3 = Teal 4 = Purple 5 = Yellow 6 = Orange 7 = Green 8 = Pink 9 = Violet 10 = Light Grey 11 = Dark Green 12 = Brown 13 = Light Green 14 = Dark Grey 15 = Lavender |
| String | Race | Indicates the race ID. |
| Int | Unknown | Unknown? |
| Int | Start Location | Indicates which point index is the Start Location (Any point is valid, even if it is not of a Start Loation type). 0 means random. |
| Int | AI | Indicates which AI to use.
0 = (Default) 0x436F6D70, or "Comp" = Computer AI |
| Int | Decal | Path to the decal to use. |