author | Ryan C. Gordon <icculus@icculus.org> |
Tue, 20 Mar 2012 15:38:12 -0400 | |
changeset 1240 | 22d4d1bd4e21 |
parent 1203 | 55f147714ce2 |
child 1258 | 074d08049aa7 |
permissions | -rw-r--r-- |
609 | 1 |
/* |
2 |
* WAD support routines for PhysicsFS. |
|
3 |
* |
|
4 |
* This driver handles DOOM engine archives ("wads"). |
|
5 |
* This format (but not this driver) was designed by id Software for use |
|
6 |
* with the DOOM engine. |
|
7 |
* The specs of the format are from the unofficial doom specs v1.666 |
|
8 |
* found here: http://www.gamers.org/dhs/helpdocs/dmsp1666.html |
|
9 |
* The format of the archive: (from the specs) |
|
10 |
* |
|
11 |
* A WAD file has three parts: |
|
12 |
* (1) a twelve-byte header |
|
13 |
* (2) one or more "lumps" |
|
14 |
* (3) a directory or "info table" that contains the names, offsets, and |
|
15 |
* sizes of all the lumps in the WAD |
|
16 |
* |
|
17 |
* The header consists of three four-byte parts: |
|
18 |
* (a) an ASCII string which must be either "IWAD" or "PWAD" |
|
19 |
* (b) a 4-byte (long) integer which is the number of lumps in the wad |
|
20 |
* (c) a long integer which is the file offset to the start of |
|
21 |
* the directory |
|
22 |
* |
|
23 |
* The directory has one 16-byte entry for every lump. Each entry consists |
|
24 |
* of three parts: |
|
25 |
* |
|
26 |
* (a) a long integer, the file offset to the start of the lump |
|
27 |
* (b) a long integer, the size of the lump in bytes |
|
28 |
* (c) an 8-byte ASCII string, the name of the lump, padded with zeros. |
|
29 |
* For example, the "DEMO1" entry in hexadecimal would be |
|
30 |
* (44 45 4D 4F 31 00 00 00) |
|
31 |
* |
|
32 |
* Note that there is no way to tell if an opened WAD archive is a |
|
33 |
* IWAD or PWAD with this archiver. |
|
34 |
* I couldn't think of a way to provide that information, without being too |
|
35 |
* hacky. |
|
36 |
* I don't think it's really that important though. |
|
37 |
* |
|
38 |
* |
|
809
116b8fe30371
Renamed LICENSE to LICENSE.txt
Ryan C. Gordon <icculus@icculus.org>
parents:
808
diff
changeset
|
39 |
* Please see the file LICENSE.txt in the source's root directory. |
609 | 40 |
* |
41 |
* This file written by Travis Wells, based on the GRP archiver by |
|
42 |
* Ryan C. Gordon. |
|
43 |
*/ |
|
44 |
||
45 |
#if (defined PHYSFS_SUPPORTS_WAD) |
|
46 |
||
47 |
#define __PHYSICSFS_INTERNAL__ |
|
48 |
#include "physfs_internal.h" |
|
49 |
||
1128
067d8e76261e
Moved most the cut-and-paste between simple archivers to one file.
Ryan C. Gordon <icculus@icculus.org>
parents:
1125
diff
changeset
|
50 |
static UNPKentry *wadLoadEntries(PHYSFS_Io *io, PHYSFS_uint32 fileCount) |
609 | 51 |
{ |
52 |
PHYSFS_uint32 directoryOffset; |
|
1128
067d8e76261e
Moved most the cut-and-paste between simple archivers to one file.
Ryan C. Gordon <icculus@icculus.org>
parents:
1125
diff
changeset
|
53 |
UNPKentry *entries = NULL; |
067d8e76261e
Moved most the cut-and-paste between simple archivers to one file.
Ryan C. Gordon <icculus@icculus.org>
parents:
1125
diff
changeset
|
54 |
UNPKentry *entry = NULL; |
610 | 55 |
|
1240
22d4d1bd4e21
Reworked the error reporting API. Now we use error codes instead of strings.
Ryan C. Gordon <icculus@icculus.org>
parents:
1203
diff
changeset
|
56 |
BAIL_IF_MACRO(!__PHYSFS_readAll(io, &directoryOffset, 4), ERRPASS, 0); |
1118
2e09fc635fdd
Abstracted file i/o into PHYSFS_Io interface.
Ryan C. Gordon <icculus@icculus.org>
parents:
1115
diff
changeset
|
57 |
directoryOffset = PHYSFS_swapULE32(directoryOffset); |
609 | 58 |
|
1240
22d4d1bd4e21
Reworked the error reporting API. Now we use error codes instead of strings.
Ryan C. Gordon <icculus@icculus.org>
parents:
1203
diff
changeset
|
59 |
BAIL_IF_MACRO(!io->seek(io, directoryOffset), ERRPASS, 0); |
609 | 60 |
|
1128
067d8e76261e
Moved most the cut-and-paste between simple archivers to one file.
Ryan C. Gordon <icculus@icculus.org>
parents:
1125
diff
changeset
|
61 |
entries = (UNPKentry *) allocator.Malloc(sizeof (UNPKentry) * fileCount); |
1240
22d4d1bd4e21
Reworked the error reporting API. Now we use error codes instead of strings.
Ryan C. Gordon <icculus@icculus.org>
parents:
1203
diff
changeset
|
62 |
BAIL_IF_MACRO(!entries, PHYSFS_ERR_OUT_OF_MEMORY, NULL); |
1128
067d8e76261e
Moved most the cut-and-paste between simple archivers to one file.
Ryan C. Gordon <icculus@icculus.org>
parents:
1125
diff
changeset
|
63 |
|
067d8e76261e
Moved most the cut-and-paste between simple archivers to one file.
Ryan C. Gordon <icculus@icculus.org>
parents:
1125
diff
changeset
|
64 |
for (entry = entries; fileCount > 0; fileCount--, entry++) |
609 | 65 |
{ |
1240
22d4d1bd4e21
Reworked the error reporting API. Now we use error codes instead of strings.
Ryan C. Gordon <icculus@icculus.org>
parents:
1203
diff
changeset
|
66 |
if (!__PHYSFS_readAll(io, &entry->startPos, 4)) goto failed; |
22d4d1bd4e21
Reworked the error reporting API. Now we use error codes instead of strings.
Ryan C. Gordon <icculus@icculus.org>
parents:
1203
diff
changeset
|
67 |
if (!__PHYSFS_readAll(io, &entry->size, 4)) goto failed; |
22d4d1bd4e21
Reworked the error reporting API. Now we use error codes instead of strings.
Ryan C. Gordon <icculus@icculus.org>
parents:
1203
diff
changeset
|
68 |
if (!__PHYSFS_readAll(io, &entry->name, 8)) goto failed; |
609 | 69 |
|
70 |
entry->name[8] = '\0'; /* name might not be null-terminated in file. */ |
|
71 |
entry->size = PHYSFS_swapULE32(entry->size); |
|
72 |
entry->startPos = PHYSFS_swapULE32(entry->startPos); |
|
73 |
} /* for */ |
|
74 |
||
1128
067d8e76261e
Moved most the cut-and-paste between simple archivers to one file.
Ryan C. Gordon <icculus@icculus.org>
parents:
1125
diff
changeset
|
75 |
return entries; |
067d8e76261e
Moved most the cut-and-paste between simple archivers to one file.
Ryan C. Gordon <icculus@icculus.org>
parents:
1125
diff
changeset
|
76 |
|
1203
55f147714ce2
Cleaned up all the readAll() cut and paste.
Ryan C. Gordon <icculus@icculus.org>
parents:
1129
diff
changeset
|
77 |
failed: |
1128
067d8e76261e
Moved most the cut-and-paste between simple archivers to one file.
Ryan C. Gordon <icculus@icculus.org>
parents:
1125
diff
changeset
|
78 |
allocator.Free(entries); |
067d8e76261e
Moved most the cut-and-paste between simple archivers to one file.
Ryan C. Gordon <icculus@icculus.org>
parents:
1125
diff
changeset
|
79 |
return NULL; |
067d8e76261e
Moved most the cut-and-paste between simple archivers to one file.
Ryan C. Gordon <icculus@icculus.org>
parents:
1125
diff
changeset
|
80 |
} /* wadLoadEntries */ |
609 | 81 |
|
82 |
||
1118
2e09fc635fdd
Abstracted file i/o into PHYSFS_Io interface.
Ryan C. Gordon <icculus@icculus.org>
parents:
1115
diff
changeset
|
83 |
static void *WAD_openArchive(PHYSFS_Io *io, const char *name, int forWriting) |
609 | 84 |
{ |
1118
2e09fc635fdd
Abstracted file i/o into PHYSFS_Io interface.
Ryan C. Gordon <icculus@icculus.org>
parents:
1115
diff
changeset
|
85 |
PHYSFS_uint8 buf[4]; |
1128
067d8e76261e
Moved most the cut-and-paste between simple archivers to one file.
Ryan C. Gordon <icculus@icculus.org>
parents:
1125
diff
changeset
|
86 |
UNPKentry *entries = NULL; |
1203
55f147714ce2
Cleaned up all the readAll() cut and paste.
Ryan C. Gordon <icculus@icculus.org>
parents:
1129
diff
changeset
|
87 |
PHYSFS_uint32 count = 0; |
609 | 88 |
|
1118
2e09fc635fdd
Abstracted file i/o into PHYSFS_Io interface.
Ryan C. Gordon <icculus@icculus.org>
parents:
1115
diff
changeset
|
89 |
assert(io != NULL); /* shouldn't ever happen. */ |
2e09fc635fdd
Abstracted file i/o into PHYSFS_Io interface.
Ryan C. Gordon <icculus@icculus.org>
parents:
1115
diff
changeset
|
90 |
|
1240
22d4d1bd4e21
Reworked the error reporting API. Now we use error codes instead of strings.
Ryan C. Gordon <icculus@icculus.org>
parents:
1203
diff
changeset
|
91 |
BAIL_IF_MACRO(forWriting, PHYSFS_ERR_READ_ONLY, NULL); |
22d4d1bd4e21
Reworked the error reporting API. Now we use error codes instead of strings.
Ryan C. Gordon <icculus@icculus.org>
parents:
1203
diff
changeset
|
92 |
BAIL_IF_MACRO(!__PHYSFS_readAll(io, buf, sizeof (buf)), ERRPASS, NULL); |
1118
2e09fc635fdd
Abstracted file i/o into PHYSFS_Io interface.
Ryan C. Gordon <icculus@icculus.org>
parents:
1115
diff
changeset
|
93 |
if ((memcmp(buf, "IWAD", 4) != 0) && (memcmp(buf, "PWAD", 4) != 0)) |
1240
22d4d1bd4e21
Reworked the error reporting API. Now we use error codes instead of strings.
Ryan C. Gordon <icculus@icculus.org>
parents:
1203
diff
changeset
|
94 |
BAIL_MACRO(PHYSFS_ERR_UNSUPPORTED, NULL); |
609 | 95 |
|
1240
22d4d1bd4e21
Reworked the error reporting API. Now we use error codes instead of strings.
Ryan C. Gordon <icculus@icculus.org>
parents:
1203
diff
changeset
|
96 |
BAIL_IF_MACRO(!__PHYSFS_readAll(io, &count, sizeof (count)), ERRPASS, NULL); |
1203
55f147714ce2
Cleaned up all the readAll() cut and paste.
Ryan C. Gordon <icculus@icculus.org>
parents:
1129
diff
changeset
|
97 |
count = PHYSFS_swapULE32(count); |
609 | 98 |
|
1203
55f147714ce2
Cleaned up all the readAll() cut and paste.
Ryan C. Gordon <icculus@icculus.org>
parents:
1129
diff
changeset
|
99 |
entries = wadLoadEntries(io, count); |
1240
22d4d1bd4e21
Reworked the error reporting API. Now we use error codes instead of strings.
Ryan C. Gordon <icculus@icculus.org>
parents:
1203
diff
changeset
|
100 |
BAIL_IF_MACRO(!entries, ERRPASS, NULL); |
1203
55f147714ce2
Cleaned up all the readAll() cut and paste.
Ryan C. Gordon <icculus@icculus.org>
parents:
1129
diff
changeset
|
101 |
return UNPK_openArchive(io, entries, count); |
1128
067d8e76261e
Moved most the cut-and-paste between simple archivers to one file.
Ryan C. Gordon <icculus@icculus.org>
parents:
1125
diff
changeset
|
102 |
} /* WAD_openArchive */ |
1054
57f4af811ffb
THIS is Christoph's PHYSFS_stat() work.
Ryan C. Gordon <icculus@icculus.org>
parents:
1053
diff
changeset
|
103 |
|
57f4af811ffb
THIS is Christoph's PHYSFS_stat() work.
Ryan C. Gordon <icculus@icculus.org>
parents:
1053
diff
changeset
|
104 |
|
658
1981818c6170
Removed all the forward declaration cruft from the archivers.
Ryan C. Gordon <icculus@icculus.org>
parents:
657
diff
changeset
|
105 |
const PHYSFS_ArchiveInfo __PHYSFS_ArchiveInfo_WAD = |
1981818c6170
Removed all the forward declaration cruft from the archivers.
Ryan C. Gordon <icculus@icculus.org>
parents:
657
diff
changeset
|
106 |
{ |
1981818c6170
Removed all the forward declaration cruft from the archivers.
Ryan C. Gordon <icculus@icculus.org>
parents:
657
diff
changeset
|
107 |
"WAD", |
694
80bc8858b4ab
Added translation for WAD file type.
Ryan C. Gordon <icculus@icculus.org>
parents:
691
diff
changeset
|
108 |
WAD_ARCHIVE_DESCRIPTION, |
658
1981818c6170
Removed all the forward declaration cruft from the archivers.
Ryan C. Gordon <icculus@icculus.org>
parents:
657
diff
changeset
|
109 |
"Travis Wells <traviswells@mchsi.com>", |
1981818c6170
Removed all the forward declaration cruft from the archivers.
Ryan C. Gordon <icculus@icculus.org>
parents:
657
diff
changeset
|
110 |
"http://www.3dmm2.com/doom/", |
1981818c6170
Removed all the forward declaration cruft from the archivers.
Ryan C. Gordon <icculus@icculus.org>
parents:
657
diff
changeset
|
111 |
}; |
1981818c6170
Removed all the forward declaration cruft from the archivers.
Ryan C. Gordon <icculus@icculus.org>
parents:
657
diff
changeset
|
112 |
|
1981818c6170
Removed all the forward declaration cruft from the archivers.
Ryan C. Gordon <icculus@icculus.org>
parents:
657
diff
changeset
|
113 |
|
1981818c6170
Removed all the forward declaration cruft from the archivers.
Ryan C. Gordon <icculus@icculus.org>
parents:
657
diff
changeset
|
114 |
const PHYSFS_Archiver __PHYSFS_Archiver_WAD = |
1981818c6170
Removed all the forward declaration cruft from the archivers.
Ryan C. Gordon <icculus@icculus.org>
parents:
657
diff
changeset
|
115 |
{ |
1981818c6170
Removed all the forward declaration cruft from the archivers.
Ryan C. Gordon <icculus@icculus.org>
parents:
657
diff
changeset
|
116 |
&__PHYSFS_ArchiveInfo_WAD, |
1981818c6170
Removed all the forward declaration cruft from the archivers.
Ryan C. Gordon <icculus@icculus.org>
parents:
657
diff
changeset
|
117 |
WAD_openArchive, /* openArchive() method */ |
1128
067d8e76261e
Moved most the cut-and-paste between simple archivers to one file.
Ryan C. Gordon <icculus@icculus.org>
parents:
1125
diff
changeset
|
118 |
UNPK_enumerateFiles, /* enumerateFiles() method */ |
067d8e76261e
Moved most the cut-and-paste between simple archivers to one file.
Ryan C. Gordon <icculus@icculus.org>
parents:
1125
diff
changeset
|
119 |
UNPK_openRead, /* openRead() method */ |
067d8e76261e
Moved most the cut-and-paste between simple archivers to one file.
Ryan C. Gordon <icculus@icculus.org>
parents:
1125
diff
changeset
|
120 |
UNPK_openWrite, /* openWrite() method */ |
067d8e76261e
Moved most the cut-and-paste between simple archivers to one file.
Ryan C. Gordon <icculus@icculus.org>
parents:
1125
diff
changeset
|
121 |
UNPK_openAppend, /* openAppend() method */ |
067d8e76261e
Moved most the cut-and-paste between simple archivers to one file.
Ryan C. Gordon <icculus@icculus.org>
parents:
1125
diff
changeset
|
122 |
UNPK_remove, /* remove() method */ |
067d8e76261e
Moved most the cut-and-paste between simple archivers to one file.
Ryan C. Gordon <icculus@icculus.org>
parents:
1125
diff
changeset
|
123 |
UNPK_mkdir, /* mkdir() method */ |
067d8e76261e
Moved most the cut-and-paste between simple archivers to one file.
Ryan C. Gordon <icculus@icculus.org>
parents:
1125
diff
changeset
|
124 |
UNPK_dirClose, /* dirClose() method */ |
067d8e76261e
Moved most the cut-and-paste between simple archivers to one file.
Ryan C. Gordon <icculus@icculus.org>
parents:
1125
diff
changeset
|
125 |
UNPK_stat /* stat() method */ |
658
1981818c6170
Removed all the forward declaration cruft from the archivers.
Ryan C. Gordon <icculus@icculus.org>
parents:
657
diff
changeset
|
126 |
}; |
1981818c6170
Removed all the forward declaration cruft from the archivers.
Ryan C. Gordon <icculus@icculus.org>
parents:
657
diff
changeset
|
127 |
|
609 | 128 |
#endif /* defined PHYSFS_SUPPORTS_WAD */ |
129 |
||
130 |
/* end of wad.c ... */ |
|
131 |