Difference between revisions of "SA SCM"

From GTAMods Wiki
Jump to navigation Jump to search
m (we need a general, more detailed (text) SCM file format article)
Line 3: Line 3:
  
 
  (02 00 01)h + 32 bit int    Jump to second segment
 
  (02 00 01)h + 32 bit int    Jump to second segment
  byte                        Padding
+
  byte                        Padding (always 73h)
 
   (Global vars)              Space for variable saving
 
   (Global vars)              Space for variable saving
 
  (02 00 01)h + 32 bit int    Jump to third segment
 
  (02 00 01)h + 32 bit int    Jump to third segment
 
  byte                        Segment id
 
  byte                        Segment id
 
   32 bit int                Number of models
 
   32 bit int                Number of models
   (model names)              24 byte model names * number of models(model 0 not used)
+
   (model names)              24 byte model names * number of models (model 0 name is empty and therefore unused)
 
  (02 00 01)h + 32 bit int    Jump to fourth segment
 
  (02 00 01)h + 32 bit int    Jump to fourth segment
 
  byte                        Segment id
 
  byte                        Segment id
Line 26: Line 26:
 
  (02 00 01)h + 32 bit int    Jump to sixth segment
 
  (02 00 01)h + 32 bit int    Jump to sixth segment
 
  byte                        Segment id
 
  byte                        Segment id
   32 bit int                (Unused)
+
   32 bit int                (Unused, always 0)
 
  (02 00 01)h + 32 bit int    Jump to seventh segment
 
  (02 00 01)h + 32 bit int    Jump to seventh segment
 
  byte                        Segment id
 
  byte                        Segment id
 
   32 bit int                Size of global var space
 
   32 bit int                Size of global var space
   32 bit int                (Unused)
+
    8 bit int                Number of allocated externals (with [[07D3]], [[0884]], [[0928]] or [[0929]])? (unused, always 3Eh)
 +
    8 bit int                Number of unused externals ('''HOME_BRAINS''' and '''AAA''')? (unused, always 2)
 +
   16 bit int                (Unused, always 0)
 
  (MAIN code)                  MAIN section, equal to size defined earlier
 
  (MAIN code)                  MAIN section, equal to size defined earlier
 
  (mission code)              The mission data, missions stored at offsets defined earlier
 
  (mission code)              The mission data, missions stored at offsets defined earlier
 +
 +
The '''AAA''' external script is very odd as the sixth segment is copied inside. The following bytes are just padding to align the file size to the nearest 2KB, like also in the working externals.
  
 
{{Script-stub}}
 
{{Script-stub}}
  
 
[[Category:Mission Script]] [[Category:File Formats]]
 
[[Category:Mission Script]] [[Category:File Formats]]

Revision as of 12:23, 29 August 2012

40px-Ambox rewrite orange.svg.png This article may need to be rewritten.
Please help improve this article. The discussion page may contain suggestions.

A scm file is a binary file with certain structure. The common information about what this file is for can be found here. The scm file structure looks like the following:

(02 00 01)h + 32 bit int     Jump to second segment
byte                         Padding (always 73h)
  (Global vars)              Space for variable saving
(02 00 01)h + 32 bit int     Jump to third segment
byte                         Segment id
  32 bit int                 Number of models
  (model names)              24 byte model names * number of models (model 0 name is empty and therefore unused)
(02 00 01)h + 32 bit int     Jump to fourth segment
byte                         Segment id
  32 bit int                 MAIN size
  32 bit int                 Largest mission size
  32 bit int                 Number of missions
  32 bit int                 Highest number of locals used in mission/exernal
  (mission addresses)        32 bit addresses * number of missions
(02 00 01)h + 32 bit int     Jump to fifth segment
byte                         Segment id
  32 bit int                 Largest external size
  32 bit int                 Number of externals
  (external data):           28 byte external data * number of externals
    20 bytes                 Name of external
    32 bit int               Offset of external
    32 bit int               Size of external
(02 00 01)h + 32 bit int     Jump to sixth segment
byte                         Segment id
  32 bit int                 (Unused, always 0)
(02 00 01)h + 32 bit int     Jump to seventh segment
byte                         Segment id
  32 bit int                 Size of global var space
   8 bit int                 Number of allocated externals (with 07D3, 0884, 0928 or 0929)? (unused, always 3Eh)
   8 bit int                 Number of unused externals (HOME_BRAINS and AAA)? (unused, always 2)
  16 bit int                 (Unused, always 0)
(MAIN code)                  MAIN section, equal to size defined earlier
(mission code)               The mission data, missions stored at offsets defined earlier

The AAA external script is very odd as the sixth segment is copied inside. The following bytes are just padding to align the file size to the nearest 2KB, like also in the working externals.