aboutsummaryrefslogtreecommitdiff
path: root/engines/cine/pal.h
blob: 58d23e5bf077e1fbee3778bb88ad9561a0d30b99 (plain)
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
/* 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 CINE_PAL_H
#define CINE_PAL_H

#include "graphics/pixelformat.h"

namespace Cine {

/**
 * Endian types. Used at least by Palette class's load and save functions.
 * TODO: Move somewhere more general as this is definitely not Cine-engine specific
 *
 * NOTE: It seems LITTLE_ENDIAN and/or BIG_ENDIAN were defined already on some platforms so
 * therefore renamed the enumerations to something not clashing by giving them "CINE_"-prefixes.
 */
enum EndianType {
	CINE_NATIVE_ENDIAN,
	CINE_LITTLE_ENDIAN,
	CINE_BIG_ENDIAN
};

struct PalEntry {
	char name[10];
	byte pal1[16];
	byte pal2[16];
};

void loadPal(const char *fileName);

void loadRelatedPalette(const char *fileName);

/**
 * A class for handling Cine-engine's palettes.
 * TODO: Test a bit more
 */
class Palette {
public:
	struct Color {
		uint8 r, g, b;
	};

	/**
	 * Create an initially black palette with the given color format and number of colors.
	 * @param format Color format
	 * @param numColors Number of colors
	 * @note For the default constructed object (i.e. no parameters given) this will hold: empty() && !isValid()
	 */
	Palette(const Graphics::PixelFormat format = Graphics::PixelFormat(), const uint numColors = 0);

	/**
	 * Clear the palette (Set color count to zero, release memory, overwrite color format with default value).
	 * @note This is very different from using fillWithBlack-function which fills the palette with black.
	 */
	Palette &clear();

	/**
	 * Load palette from buffer with given color format, endianness and number of colors.
	 * @param buf Input buffer
	 * @param size Input buffer size in bytes
	 * @param format Input color format
	 * @param numColors Number of colors to load
	 * @param endian The endianness of the colors in the input buffer
	 */
	Palette &load(const byte *buf, const uint size, const Graphics::PixelFormat format, const uint numColors, const EndianType endian);

	/**
	 * Save the whole palette to buffer in original color format using defined endianness.
	 * @param buf Output buffer
	 * @param size Output buffer size in bytes
	 * @param endian The endian type to use
	 */
	byte *save(byte *buf, const uint size, const EndianType endian) const;

	/**
	 * Save the whole palette to buffer in given color format using defined endianness.
	 * @param buf Output buffer
	 * @param size Output buffer size in bytes
	 * @param format Output color format
	 * @param endian The endian type to use
	 */
	byte *save(byte *buf, const uint size, const Graphics::PixelFormat format, const EndianType endian) const;

	/**
	 * Save (partial) palette to buffer in given color format using defined endianness.
	 * @param buf Output buffer
	 * @param size Output buffer size in bytes
	 * @param format Output color format
	 * @param numColors Number of colors to save
	 * @param endian The endian type to use
	 * @param firstIndex Starting color index (from which onwards to save the colors)
	 */
	byte *save(byte *buf, const uint size, const Graphics::PixelFormat format, const uint numColors, const EndianType endian, const byte firstIndex = 0) const;

	/**
	 * Rotate the palette in color range [firstIndex, lastIndex] to the right by the specified rotation amount.
	 * @param rotationAmount Amount to rotate the sub-palette to the right. Only values 0 and 1 are currently supported!
	 */
	Palette &rotateRight(byte firstIndex, byte lastIndex, signed rotationAmount = 1);
	Palette &saturatedAddColor(Palette &output, byte firstIndex, byte lastIndex, signed r, signed g, signed b) const;

	/**
	 * Saturated add an RGB color in given color format to current palette's subset and save the modified colors in the given output palette.
	 * @param output The output palette (Only this palette is modified)
	 * @param firstIndex First color index of the palette's subset (Inclusive range)
	 * @param lastIndex Last color index of the palette's subset (Inclusive range)
	 * @param rSource The red color component in the source color format
	 * @param gSource The green color component in the source color format
	 * @param bSource The blue color component in the source color format
	 * @param sourceFormat The source color format (i.e. the color format of the given RGB color)
	 * @note This function basically converts the given color to the palette's internal color format
	 * and adds that using the normal saturatedAddColor-function.
	 */
	Palette &saturatedAddColor(Palette &output, byte firstIndex, byte lastIndex, signed rSource, signed gSource, signed bSource, const Graphics::PixelFormat &sourceFormat) const;

	/**
	 * Saturated add a normalized gray value to current palette's subset and save the modified colors in the given output palette.
	 * @param output The output palette (Only this palette is modified)
	 * @param firstIndex First color index of the palette's subset (Inclusive range)
	 * @param lastIndex Last color index of the palette's subset (Inclusive range)
	 * @param grayDividend Dividend of the normalized gray value
	 * @param grayDenominator Denominator of the normalized gray value
	 * @note The normalized gray value (i.e. in range [-1, +1]) is given as a fractional number
	 * (i.e. the normalized gray value is calculated by dividing grayDividend by grayDenominator).
	 */
	Palette &saturatedAddNormalizedGray(Palette &output, byte firstIndex, byte lastIndex, signed grayDividend, signed grayDenominator) const;

	bool empty() const;
	uint colorCount() const;

	Palette &fillWithBlack();

	/** Is the palette valid? (Mostly just checks the color format for correctness) */
	bool isValid() const;

	/** The original color format in which this palette was loaded. */
	const Graphics::PixelFormat &colorFormat() const;

	/** Sets current palette to global OSystem's palette using g_system->getPaletteManager()->setPalette. */
	void setGlobalOSystemPalette() const;

	/** Get the color at the given palette index. */
	Color getColor(byte index) const;

	/** Get the red color component of the color at the given palette index. */
	uint8 getR(byte index) const;

	/** Get the green color component of the color at the given palette index. */
	uint8 getG(byte index) const;

	/** Get the blue color component of the color at the given palette index. */
	uint8 getB(byte index) const;

private:
	void setColorFormat(const Graphics::PixelFormat format);

	// WORKAROUND: Using a reference to a result here instead of returning an Color object.
	// This is needed because when using a Color as return value, this would crash Chrilith's
	// compiler for PalmOS.
	// TODO: Add more information about the compiler.
	void saturatedAddColor(Color &result, const Color &baseColor, signed r, signed g, signed b) const;

private:
	Graphics::PixelFormat _format; ///< The used source color format
	Common::Array<Color> _colors;  ///< The actual palette data
};

} // End of namespace Cine

#endif