adam/cobm
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Some added information, including SC1 info.

Browse Source 
git-svn-id: svn://svn.code.sf.net/p/sc2/code/trunk@2728 8092fc87-c524-0410-9efc-e669fe64eaf9
This commit is contained in:
Meep-Eep
2007-04-08 04:10:00 +00:00
parent b462ad8ad1
commit f6f09fecbf
1 changed files with 42 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files
sc2/doc/devel/pkgformat
+39 -5
View File
@@ -7,10 +7,17 @@ mentioned below in square brackets.
Everything is stored LSB first. Everything is stored LSB first.
This document talks about packaged files.
Packaged files have multiple resources stored in one file. All the resources
in one package are stored in a single file, whose name is specified in
p.packmem. The name may be '\0', in which case the package file itself
is used.
Non-packaged files have one resource per file. The name is specified
in each resource instance info field.
Main header: (resinit.c, _GetResFileData()) Main header: (resinit.c, _GetResFileData())
position length meaning position length meaning
0x00 2 Whether or not the file is packaged (res_flags) 0x00 2 Whether or not the file is packaged (res_flags)
(has all files in the .pkg file itself)
bit 0: 0 - the .pkg file is not packaged bit 0: 0 - the .pkg file is not packaged
1 - the .pkg file is packaged 1 - the .pkg file is packaged
0x02 4 offset from the beginning of the file where the list 0x02 4 offset from the beginning of the file where the list
@@ -29,8 +36,10 @@ position length meaning
4 p.packmem_info 4 p.packmem_info
bits 0-7: number of resource types bits 0-7: number of resource types
bits 8-20: number of resource instances bits 8-20: number of resource instances
bits 21-31: index in file_list_offs of the file name for bits 21-31:
this resource (only for packaged files) For packaged files: index in file_list_offs of the
file name for this resource
For non-packaged files: unused (0)
4 p.flags_and_data_loc 4 p.flags_and_data_loc
MSB is flags, rest is data_loc, MSB is flags, rest is data_loc,
if MSB == 0, then of the data_loc only the low 16 bits if MSB == 0, then of the data_loc only the low 16 bits
@@ -68,8 +77,10 @@ packmem_list_offs (should be directly after the index info):
2 if this is a packaged file: multiply by 4 to get 2 if this is a packaged file: multiply by 4 to get
the length of this package. the length of this package.
if this is a file that is not packaged: if this is a file that is not packaged:
[the same position is in memory used as a index in file_list_offs of the file name for
MEM_HANDLE to the actual data] this resource.
[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) path_list_offs (should be directly after the packmem list)
? null terminated path strings, indexed from the file list ? null terminated path strings, indexed from the file list
table table
@@ -86,6 +97,9 @@ file_list_offs (should be directly after the path list)
8 file name (8 chars or null-terminated) 8 file name (8 chars or null-terminated)
3 extension (3 chars or null-terminated) 3 extension (3 chars or null-terminated)
The following section is present in the package only for packaged files.
For non-packaged files, the fields below exist in the external file indicated
by p.packmem_info.file_index.
For each package p: For each package p:
p.data_loc for each type p.t: p.data_loc for each type p.t:
for each instance p.t.i: for each instance p.t.i:
@@ -100,6 +114,26 @@ 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. are files with the same format as this .pkg file itself.
The information above is gathered from the resource library sources itself.
The information below is induced from the packed files themselves.
The format used in SC1 is somewhat different. The differences are listed
here:
0x02 4 offset from the beginning of the file where the list
of pathnames is stored (path_list_offs)
0x06 4 offset from the beginning of the file where the list
of file names is stored (file_list_offs)
0x0a 4 offset from the beginning of the file where the list
of package information is stored (packmem_list_offs)
0x0e 2 number of types of packages present in the file (num_types)
0x10 2 ?
0x12 2 number of packages in the file (num_packages)
0x14 2 ?
packmem_list_offs
4 as above
2 if this is a packaged file: multiply by 4 to get
the length of this package.
Initial version of this file 2002-10-10 by Serge van den Boom. Initial version of this file 2002-10-10 by Serge van den Boom.