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
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
|
/* 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.
*
*/
#ifndef SCI_GRAPHICS_PALETTE32_H
#define SCI_GRAPHICS_PALETTE32_H
#include "sci/graphics/palette.h"
namespace Sci {
enum PalCyclerDirection {
PalCycleBackward = 0,
PalCycleForward = 1
};
struct PalCycler {
/**
* The color index of the palette cycler. This value is effectively used as the ID for the
* cycler.
*/
uint8 fromColor;
/**
* The number of palette slots which are cycled by the palette cycler.
*/
uint16 numColorsToCycle;
/**
* The position of the cursor in its cycle.
*/
uint8 currentCycle;
/**
* The direction of the cycler.
*/
PalCyclerDirection direction;
/**
* The cycle tick at the last time the cycler’s currentCycle was updated.
* 795 days of game time ought to be enough for everyone? :)
*/
uint32 lastUpdateTick;
/**
* The amount of time in ticks each cycle should take to complete. In other words,
* the higher the delay, the slower the cycle animation. If delay is 0, the cycler
* does not automatically cycle and needs to be pumped manually with DoCycle.
*/
int16 delay;
/**
* The number of times this cycler has been paused.
*/
uint16 numTimesPaused;
};
class GfxPalette32 : public GfxPalette {
public:
GfxPalette32(ResourceManager *resMan, GfxScreen *screen);
~GfxPalette32();
private:
// NOTE: currentPalette in SCI engine is called _sysPalette
// here.
/**
* The palette revision version. Increments once per game
* loop that changes the source palette. TODO: Possibly
* other areas also change _version, double-check once it
* is all implemented.
*/
uint32 _version;
/**
* Whether or not the palette manager version was updated
* during this loop.
*/
bool _versionUpdated;
/**
* The unmodified source palette loaded by kPalette. Additional
* palette entries may be mixed into the source palette by
* CelObj objects, which contain their own palettes.
*/
Palette _sourcePalette;
/**
* The palette to be used when the hardware is next updated.
* On update, _nextPalette is transferred to _sysPalette.
*/
Palette _nextPalette;
bool createPaletteFromResourceInternal(const GuiResourceId paletteId, Palette *const out) const;
Palette getPaletteFromResourceInternal(const GuiResourceId paletteId) const;
public:
virtual void saveLoadWithSerializer(Common::Serializer &s) override;
inline const Palette &getNextPalette() const { return _nextPalette; };
inline const Palette &getCurrentPalette() const { return _sysPalette; };
bool kernelSetFromResource(GuiResourceId resourceId, bool force) override;
int16 kernelFindColor(uint16 r, uint16 g, uint16 b) override;
void set(Palette *newPalette, bool force, bool forceRealMerge = false) override;
/**
* Submits a palette to display. Entries marked as “used” in the
* submitted palette are merged into the existing entries of
* _sourcePalette.
*/
void submit(Palette &palette);
bool updateForFrame();
void updateFFrame();
void updateHardware();
void applyAll();
#pragma mark -
#pragma mark color look-up
private:
/**
* An optional lookup table used to remap RGB565 colors to a palette
* index. Used by Phantasmagoria 2 in 8-bit color environments.
*/
byte *_clutTable;
public:
bool loadClut(uint16 clutId);
byte matchClutColor(uint16 color);
void unloadClut();
#pragma mark -
#pragma mark Varying
private:
/**
* An optional palette used to describe the source colors used
* in a palette vary operation. If this palette is not specified,
* sourcePalette is used instead.
*/
Palette *_varyStartPalette;
/**
* An optional palette used to describe the target colors used
* in a palette vary operation.
*/
Palette *_varyTargetPalette;
/**
* The minimum palette index that has been varied from the
* source palette. 0–255
*/
uint8 _varyFromColor;
/**
* The maximum palette index that is has been varied from the
* source palette. 0-255
*/
uint8 _varyToColor;
/**
* The tick at the last time the palette vary was updated.
*/
uint32 _varyLastTick;
/**
* The amount of time to elapse, in ticks, between each cycle
* of a palette vary animation.
*/
int _varyTime;
/**
* The direction of change: -1, 0, or 1.
*/
int16 _varyDirection;
/**
* The amount, in percent, that the vary color is currently
* blended into the source color.
*/
int16 _varyPercent;
/**
* The target amount that a vary color will be blended into
* the source color.
*/
int16 _varyTargetPercent;
/**
* The number of time palette varying has been paused.
*/
uint16 _varyNumTimesPaused;
public:
void kernelPalVarySet(const GuiResourceId paletteId, const int16 percent, const int time, const int16 fromColor, const int16 toColor);
void kernelPalVaryMergeTarget(const GuiResourceId paletteId);
void kernelPalVarySetTarget(const GuiResourceId paletteId);
void kernelPalVarySetStart(const GuiResourceId paletteId);
void kernelPalVaryMergeStart(const GuiResourceId paletteId);
virtual void kernelPalVaryPause(bool pause) override;
void setVary(const Palette *const targetPalette, const int16 percent, const int time, const int16 fromColor, const int16 toColor);
void setVaryPercent(const int16 percent, const int time, const int16 fromColor, const int16 fromColorAlternate);
int16 getVaryPercent() const;
void varyOff();
void mergeTarget(const Palette *const palette);
void varyPause();
void varyOn();
void setVaryTime(const int time);
void setTarget(const Palette *const palette);
void setStart(const Palette *const palette);
void mergeStart(const Palette *const palette);
void setVaryTimeInternal(const int16 percent, const int time);
void applyVary();
#pragma mark -
#pragma mark Cycling
private:
// SQ6 defines 10 cyclers
PalCycler *_cyclers[10];
/**
* The cycle map is used to detect overlapping cyclers.
* According to SCI engine code, when two cyclers overlap,
* a fatal error has occurred and the engine will display
* an error and then exit.
*
* The cycle map is also by the color remapping system to
* avoid attempting to remap to palette entries that are
* cycling (so won't be the expected color once the cycler
* runs again).
*/
bool _cycleMap[256];
inline void clearCycleMap(uint16 fromColor, uint16 numColorsToClear);
inline void setCycleMap(uint16 fromColor, uint16 numColorsToClear);
inline PalCycler *getCycler(uint16 fromColor);
public:
void setCycle(const uint8 fromColor, const uint8 toColor, const int16 direction, const int16 delay);
void doCycle(const uint8 fromColor, const int16 speed);
void cycleOn(const uint8 fromColor);
void cyclePause(const uint8 fromColor);
void cycleAllOn();
void cycleAllPause();
void cycleOff(const uint8 fromColor);
void cycleAllOff();
void applyAllCycles();
void applyCycles();
inline const bool *getCycleMap() const { return _cycleMap; }
#pragma mark -
#pragma mark Fading
private:
/**
* The fade table records the expected intensity level of each pixel
* in the palette that will be displayed on the next frame.
*/
uint16 _fadeTable[256];
public:
/**
* Sets the intensity level for a range of palette
* entries. An intensity of zero indicates total
* darkness. Intensity may be set to over 100 percent.
*/
void setFade(const uint16 percent, const uint8 fromColor, const uint16 toColor);
void fadeOff();
void applyFade();
};
} // End of namespace Sci
#endif
|