1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
|
/* ScummVM - Graphic Adventure Engine
*
* ScummVM is the legal property of its developers, whose names
* are too numerous to list here. Please refer to the COPYRIGHT
* file distributed with this source distribution.
*
* This program is free software; you can redistribute it and/or
* modify it under the terms of the GNU General Public License
* as published by the Free Software Foundation; either version 2
* of the License, or (at your option) any later version.
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
* You should have received a copy of the GNU General Public License
* along with this program; if not, write to the Free Software
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*
* $URL$
* $Id$
*
*/
#ifndef COMMON_NE_EXE_H
#define COMMON_NE_EXE_H
#include "common/array.h"
#include "common/list.h"
namespace Common {
class MemoryReadStream;
class SeekableReadStream;
class String;
/** A New Executable cursor. */
class NECursor {
public:
NECursor();
~NECursor();
/** Return the cursor's width. */
uint16 getWidth() const;
/** Return the cursor's height. */
uint16 getHeight() const;
/** Return the cursor's hotspot's x coordinate. */
uint16 getHotspotX() const;
/** Return the cursor's hotspot's y coordinate. */
uint16 getHotspotY() const;
const byte *getSurface() const { return _surface; }
const byte *getPalette() const { return _palette; }
/** Set the cursor's dimensions. */
void setDimensions(uint16 width, uint16 height);
/** Set the cursor's hotspot. */
void setHotspot(uint16 x, uint16 y);
/** Read the cursor's data out of a stream. */
bool readCursor(SeekableReadStream &stream, uint32 count);
private:
byte *_surface;
byte _palette[256 * 3];
uint16 _width; ///< The cursor's width.
uint16 _height; ///< The cursor's height.
uint16 _hotspotX; ///< The cursor's hotspot's x coordinate.
uint16 _hotspotY; ///< The cursor's hotspot's y coordinate.
/** Clear the cursor. */
void clear();
};
class NEResourceID {
public:
NEResourceID() { _idType = kIDTypeNull; }
NEResourceID(String x) { _idType = kIDTypeString; _name = x; }
NEResourceID(uint16 x) { _idType = kIDTypeNumerical; _id = x; }
NEResourceID &operator=(String string);
NEResourceID &operator=(uint16 x);
bool operator==(const String &x) const;
bool operator==(const uint16 &x) const;
bool operator==(const NEResourceID &x) const;
String getString() const;
uint16 getID() const;
String toString() const;
private:
/** An ID Type. */
enum IDType {
kIDTypeNull, ///< No type set
kIDTypeNumerical, ///< A numerical ID.
kIDTypeString ///< A string ID.
} _idType;
String _name; ///< The resource's string ID.
uint16 _id; ///< The resource's numerical ID.
};
/** A New Executable cursor group. */
struct NECursorGroup {
NEResourceID id;
Array<NECursor *> cursors; ///< The cursors.
};
/** The default Windows resources. */
enum NEResourceType {
kNECursor = 0x8001,
kNEBitmap = 0x8002,
kNEIcon = 0x8003,
kNEMenu = 0x8004,
kNEDialog = 0x8005,
kNEString = 0x8006,
kNEFontDir = 0x8007,
kNEFont = 0x8008,
kNEAccelerator = 0x8009,
kNERCData = 0x800A,
kNEMessageTable = 0x800B,
kNEGroupCursor = 0x800C,
kNEGroupIcon = 0x800D,
kNEVersion = 0x8010,
kNEDlgInclude = 0x8011,
kNEPlugPlay = 0x8013,
kNEVXD = 0x8014,
kNEAniCursor = 0x8015,
kNEAniIcon = 0x8016,
kNEHTML = 0x8017,
kNEManifest = 0x8018
};
/**
* A class able to load resources from a Windows New Executable, such
* as cursors, bitmaps, and sounds.
*
* See http://en.wikipedia.org/wiki/New_Executable for more info.
*/
class NEResources {
public:
NEResources();
~NEResources();
/** Clear all information. */
void clear();
/** Load from an EXE file. */
bool loadFromEXE(const String &fileName);
/** Load from a Windows compressed EXE file. */
bool loadFromCompressedEXE(const String &fileName);
/** Load from a stream. */
bool loadFromEXE(SeekableReadStream *stream);
/** Get all cursor's read from the New Executable. */
const Array<NECursorGroup> &getCursors() const;
/** Return a list of resources for a given type. */
const Array<NEResourceID> getIDList(uint16 type) const;
/** Return a stream to the specified resource (or 0 if non-existent). */
SeekableReadStream *getResource(uint16 type, NEResourceID id);
private:
/** A resource. */
struct Resource {
NEResourceID id;
uint16 type; ///< Type of the resource.
uint32 offset; ///< Offset within the EXE.
uint32 size; ///< Size of the data.
uint16 flags;
uint16 handle;
uint16 usage;
};
SeekableReadStream *_exe; ///< Current file.
/** All resources. */
List<Resource> _resources;
/** All cursor resources. */
Array<NECursorGroup> _cursors;
/** Read the offset to the resource table. */
uint32 getResourceTableOffset();
/** Read the resource table. */
bool readResourceTable(uint32 offset);
// Cursor reading helpers
bool readCursors();
bool readCursorGroup(NECursorGroup &group, const Resource &resource);
bool readCursor(NECursor &cursor, const Resource &resource, uint32 size);
/** Find a specific resource. */
const Resource *findResource(uint16 type, NEResourceID id) const;
/** Read a resource string. */
static String getResourceString(SeekableReadStream &exe, uint32 offset);
};
} // End of namespace Common
#endif // COMMON_NE_EXE_H
|