Differences

This shows you the differences between two versions of the page.

--- falcon4:file_formats:cam_trn_tac:cmp_file [2009/02/14 20:30] – lightning
+++ falcon4:file_formats:cam_trn_tac:cmp_file [2024/07/31 08:35] (current) – links added. snakeman
@@ Line 1: / Line 1: @@
-====== .CMP file ======
+====== Falcon 4 .CMP file ======
+[[https://www.pmctactical.org/forum/viewforum.php?f=47|Falcon 4.0 Forum]], [[:falcon4|Falcon 4 Home]], [[falcon4:campaign|Falcon 4 Campaign]], [[falcon4:cockpits|Falcon 4 Cockpits]], [[falcon4:database|Falcon 4 Database]], [[falcon4:file_formats|Falcon 4 File Formats]], [[falcon4:srtm|Falcon 4 SRTM Terrain]], [[falcon4:terrain|Falcon 4 Terrain]], [[falcon4:textures|Falcon 4 Textures]], [[falcon4:tools|Falcon 4 Tools]]
 The .CMP file is one of the files embedded within a .CAM/.TRN/.TAC file.  The CMP file has most of the basic data for the campaign. It is loaded by the campaign engine to show an overview of the file you have selected,
 so contains some information that is more correctly found in other files, but also copied into this file for convenience.
@@ Line 7: / Line 10: @@
 ==== Raw format (compressed contents) ====
 ^Field^Data Type^Width (in bytes)^Description^
-|CompressedSize |DWORD|4|Size, in bytes, of the compressed file to follow (includes 4 bytes for the "Uncompressed Size" field at the start of the data)|
+|CompressedSize |signed 32-bit integer|4|Size, in bytes, of the compressed file to follow (includes 4 bytes for the "Uncompressed Size" field at the start of the data)|
-|UncompressedSize|DWORD|4|Size, in bytes, of the content that follows, when it's uncompressed|
+|UncompressedSize|signed 32-bit integer|4|Size, in bytes, of the content that follows, when it's uncompressed|
-|DATA|byte[]|(CompressedSize-4)|LZSS-compressed binary data.|
+|DATA|byte[]|(CompressedSize-4)|[[falcon4:file_formats:cam_trn_tac:lzss_compression|LZSS-compressed]] binary data.|
 ==== Uncompressed contents of the DATA field ====
@@ Line 48: / Line 51: @@
 |BullseyeX|Signed 16-bit integer|2| |All|
 |BullseyeY|Signed 16-bit integer|2| |All|
-|TheaterName|TCHAR[40]|40| |All|
+|TheaterName|_TCHAR[40]|40| |All|
-|Scenario|TCHAR[40]|40| |All|
+|Scenario|_TCHAR[40]|40| |All|
-|SaveFile|TCHAR[40]|40| |All|
+|SaveFile|_TCHAR[40]|40| |All|
-|UIName|TCHAR[40]|40| |All|
+|UIName|_TCHAR[40]|40| |All|
 |PlayerSquadronID|VU_ID|8| |All|
 |NumRecentEventEntries|Signed 16-bit integer|2| |All|
@@ Line 58: / Line 61: @@
 |PriorityEventEntries[]|EventNode[NumPriorityEventEntries]|sizeof(EventNode)*NumPriorityEventEntries| |All|
 |CampMapSize|Signed 16-bit integer|2| |All|
-|CampMap[]|byte[CampMapSize]|CampMapSize| |All|
+|CampMap[]|byte[CampMapSize]|(CampMapSize) bytes| |All|
 |LastIndexNum|Signed 16-bit integer|2| |All|
 |NumAvailableSquadrons|Signed 16-bit integer|2| |All|
@@ Line 73: / Line 76: @@
 |teamFlag|byte|1| |
 |teamColor|byte|1| |
-|teamName|T_CHAR[20]|20| |
+|teamName|_TCHAR[20]|20| |
-|teamMotto|T_CHAR[200]|200| |
+|teamMotto|_TCHAR[200]|200| |
 ==== VU_ID structure====
@@ Line 93: / Line 96: @@
 |currentStrength|byte|1| |All|
 |country|byte|1| |All|
-|airbaseName|TCHAR[40]|40| |All|
+|airbaseName|_TCHAR[40]|40| |All|
-|airbaseNameExt|TCHAR[40]|40| |<42|
+|airbaseNameExt|_TCHAR[40]|40|additional 40 characters of airbaseName (only supported in earlier versions) |<42|
-|padding|byte|1| |All|needed for the structure's fields to align on an Int32 boundary
+|padding|byte|1|needed for the structure's fields to align on an Int32 boundary|All|
 ==== EventNode structure====
@@ Line 104: / Line 107: @@
 |flags|byte|1| |
 |Team|byte|1| |
-|padding|byte|2| |needed for the structure's fields to align on an Int32 boundary
+|padding|byte|2|needed for the structure's fields to align on an Int32 boundary |
-|EventText|Int32 pointer|4| |only useful in-memory
+|EventText|Int32 pointer|4|as a pointer, this field is only useful in-memory and is meaningless when restored from disk |
-|UiEventNode|Int32 pointer|4| |only useful in-memory
+|UiEventNode|Int32 pointer|4|as a pointer, this field is only useful in-memory and is meaningless when restored from disk |
 |eventTextSize|unsigned 16-bit integer|2| |
-|eventText|TCHAR[eventTextSize]|eventTextSize| |
+|eventText|_TCHAR[eventTextSize]|eventTextSize| |