First version.
git-svn-id: svn://svn.code.sf.net/p/sc2/code/trunk@130 8092fc87-c524-0410-9efc-e669fe64eaf9
This commit is contained in:
meep-eep
@@ -0,0 +1,106 @@
|
||||
The .pkg/.ndx format as used for Starcon.pkg on the 3DO cd.
|
||||
Acquired directly from the source.
|
||||
|
||||
Everything is stored LSB first.
|
||||
|
||||
Main header: (resinit.c, _GetResFileData())
|
||||
position length meaning
|
||||
0x00 2 Whether or not the file is packaged (res_flags)
|
||||
(has all files in the .pkg file itself)
|
||||
0 - the .pkg file is not packaged
|
||||
else - the .pkg file is packaged
|
||||
0x02 4 offset from the beginning of the file where the list
|
||||
of package information is stored (packmem_list_offs)
|
||||
0x06 4 offset from the beginning of the file where the list
|
||||
of pathnames is stored (path_list_offs)
|
||||
0x0a 4 offset from the beginning of the file where the list
|
||||
of filenames is stored (file_list_offs)
|
||||
0x0e 2 number of packages in the file (num_packages)
|
||||
0x10 2 number of types of packages present in the file (num_types)
|
||||
0x12 4 length of this header. (index_info.header_len)
|
||||
(unused if the .pkg file is not packaged)
|
||||
0x16 8*num_packages:
|
||||
On position i the information for package i + 1 is
|
||||
stored. There is no package 0.
|
||||
4 p.packmem_info
|
||||
bits 0-7: number of resource types
|
||||
bits 8-20: number of resource instances
|
||||
bits 21-31: index in file_list_offs of the file name for
|
||||
this resource (only for packaged files)
|
||||
4 p.flags_and_data_loc
|
||||
(MSB is flags, rest is data_loc,
|
||||
if MSB == 0, then of the data_loc only the low 16 bits
|
||||
are used as a MEM_HANDLE (only in memory),
|
||||
if MSB == 0xff, then the data_loc is an offset in the
|
||||
file)
|
||||
0x16+8*num_packages Type information
|
||||
2*num_types
|
||||
t.instance_count
|
||||
The number of instances there are of this type.
|
||||
On position i the instance count for type i + 1 is
|
||||
stored. There's no type 0.
|
||||
packmem_list_offs (should be directly after the index info):
|
||||
for each of the num_packages packages:
|
||||
for each of the resource types for this package
|
||||
(as in p.packmem_info):
|
||||
4 bits 0-7: The type number for this type. What that
|
||||
number means isn't specified, and may
|
||||
vary per .pkg file.
|
||||
For the 3DO SC2 starcon.pkg file these are:
|
||||
0 - not a type
|
||||
1 - Graphics data (GFXRES)
|
||||
2 - String data (STRTAB)
|
||||
3 - Music data (MUSICRES)
|
||||
4 - Resource index (RES_INDEX)
|
||||
5 - Code (CODE)
|
||||
bits 8-20: The instance number of the first instance
|
||||
of this type in this package. Every
|
||||
following instance has a number 1 higher
|
||||
than the one before.
|
||||
bits 21-31: number of resources of this type in the
|
||||
package
|
||||
for each of the resource instances for this package
|
||||
(as in p.packmem_info):
|
||||
2 if this is a packaged file: multiply by 4 to get
|
||||
the length of this package.
|
||||
if this is a file that is not packaged:
|
||||
(the same position is in memory used as a
|
||||
MEM_HANDLE to the actual data)
|
||||
path_list_offs (should be directly after the packmem list)
|
||||
? null terminated path strings, indexed from the file list
|
||||
table
|
||||
file_list_offs (should be directly after the path list)
|
||||
? A number of file info structures. For packaged files,
|
||||
these are indexed from the p.packmem_info (so (at most)
|
||||
one per package). For non-packaged files, these are
|
||||
indexed from an entry for an instance from
|
||||
p.packmem_list (so possibly more per package)
|
||||
These structures are in this form:
|
||||
13 file info:
|
||||
2 location relative to path_list_offs of the
|
||||
the path to this file, or 0xffff if no path.
|
||||
8 filename (8 chars or null-terminated)
|
||||
3 extension (3 chars or null-terminated)
|
||||
|
||||
|
||||
|
||||
Resources with type 'resource index' (type 4 in the 3DO sc2 starcon.pkg file)
|
||||
are files with the same format as this .pkg file itself.
|
||||
|
||||
|
||||
For music resources: (type 3 in the 3DO sc2 starcon.pkg file)
|
||||
If the first 3 characters are 'CDA', from the next character to the first
|
||||
nul char, or 3 characters after the first period (whatever comes first) is
|
||||
used as a filename with aif audio data to play. (CDA stands for CD-audio.
|
||||
The source code mentions 'red book', but it's not (red book is the standard
|
||||
for audio CD's)). The rest of the file (just a few more chars) seems to be
|
||||
garbage.
|
||||
If the first 3 characters are something else, the entire file (including the
|
||||
first 3 characters) are used as a MOD file. (As the mod file uses those char
|
||||
as the title of the song, a mod file with the title beginning with 'CDA'
|
||||
will go wrong).
|
||||
|
||||
|
||||
|
||||
Initial version of this file 2002-10-10 by Serge van den Boom.
|
||||
|
||||
Reference in New Issue
Block a user