1

/* $Id$ */

     2

     3

/** @file company_manager_face.h Functionality related to the company manager's face */

     4

     5

#ifndef COMPANY_MANAGER_FACE_H

     6

#define COMPANY_MANAGER_FACE_H

     7

     8

#include "core/random_func.hpp"

     9

#include "core/bitmath_func.hpp"

    10

    11

/** The gender/race combinations that we have faces for */

    12

enum GenderEthnicity {

    13

	GENDER_FEMALE    = 0, ///< This bit set means a female, otherwise male

    14

	ETHNICITY_BLACK  = 1, ///< This bit set means black, otherwise white

    15

    16

	GE_WM = 0,                                         ///< A male of Caucasian origin (white)

    17

	GE_WF = 1 << GENDER_FEMALE,                        ///< A female of Caucasian origin (white)

    18

	GE_BM = 1 << ETHNICITY_BLACK,                      ///< A male of African origin (black)

    19

	GE_BF = 1 << ETHNICITY_BLACK | 1 << GENDER_FEMALE, ///< A female of African origin (black)

    20

	GE_END,

    21

};

    22

DECLARE_ENUM_AS_BIT_SET(GenderEthnicity); ///< See GenderRace as a bitset

    23

    24

/** Bitgroups of the CompanyManagerFace variable */

    25

enum CompanyManagerFaceVariable {

    26

	CMFV_GENDER,

    27

	CMFV_ETHNICITY,

    28

	CMFV_GEN_ETHN,

    29

	CMFV_HAS_MOUSTACHE,

    30

	CMFV_HAS_TIE_EARRING,

    31

	CMFV_HAS_GLASSES,

    32

	CMFV_EYE_COLOUR,

    33

	CMFV_CHEEKS,

    34

	CMFV_CHIN,

    35

	CMFV_EYEBROWS,

    36

	CMFV_MOUSTACHE,

    37

	CMFV_LIPS,

    38

	CMFV_NOSE,

    39

	CMFV_HAIR,

    40

	CMFV_JACKET,

    41

	CMFV_COLLAR,

    42

	CMFV_TIE_EARRING,

    43

	CMFV_GLASSES,

    44

	CMFV_END

    45

};

    46

DECLARE_POSTFIX_INCREMENT(CompanyManagerFaceVariable);

    47

    48

/** Information about the valid values of CompanyManagerFace bitgroups as well as the sprites to draw */

    49

struct CompanyManagerFaceBitsInfo {

    50

	byte     offset;               ///< Offset in bits into the CompanyManagerFace

    51

	byte     length;               ///< Number of bits used in the CompanyManagerFace

    52

	byte     valid_values[GE_END]; ///< The number of valid values per gender/ethnicity

    53

	SpriteID first_sprite[GE_END]; ///< The first sprite per gender/ethnicity

    54

};

    55

    56

/** Lookup table for indices into the CompanyManagerFace, valid ranges and sprites */

    57

static const CompanyManagerFaceBitsInfo _cmf_info[] = {

    58

	/* Index                   off len   WM  WF  BM  BF         WM     WF     BM     BF */

    59

	/* CMFV_GENDER          */ {  0, 1, {  2,  2,  2,  2 }, {     0,     0,     0,     0 } }, ///< 0 = male, 1 = female

    60

	/* CMFV_ETHNICITY       */ {  1, 2, {  2,  2,  2,  2 }, {     0,     0,     0,     0 } }, ///< 0 = (Western-)Caucasian, 1 = African(-American)/Black

    61

	/* CMFV_GEN_ETHN        */ {  0, 3, {  4,  4,  4,  4 }, {     0,     0,     0,     0 } }, ///< Shortcut to get/set gender _and_ ethnicity

    62

	/* CMFV_HAS_MOUSTACHE   */ {  3, 1, {  2,  0,  2,  0 }, {     0,     0,     0,     0 } }, ///< Females do not have a moustache

    63

	/* CMFV_HAS_TIE_EARRING */ {  3, 1, {  0,  2,  0,  2 }, {     0,     0,     0,     0 } }, ///< Draw the earring for females or not. For males the tie is always drawn.

    64

	/* CMFV_HAS_GLASSES     */ {  4, 1, {  2,  2,  2,  2 }, {     0,     0,     0,     0 } }, ///< Whether to draw glasses or not

    65

	/* CMFV_EYE_COLOUR      */ {  5, 2, {  3,  3,  1,  1 }, {     0,     0,     0,     0 } }, ///< Palette modification

    66

	/* CMFV_CHEEKS          */ {  0, 0, {  1,  1,  1,  1 }, { 0x325, 0x326, 0x390, 0x3B0 } }, ///< Cheeks are only indexed by their gender/ethnicity

    67

	/* CMFV_CHIN            */ {  7, 2, {  4,  1,  2,  2 }, { 0x327, 0x327, 0x391, 0x3B1 } },

    68

	/* CMFV_EYEBROWS        */ {  9, 4, { 12, 16, 11, 16 }, { 0x32B, 0x337, 0x39A, 0x3B8 } },

    69

	/* CMFV_MOUSTACHE       */ { 13, 2, {  3,  0,  3,  0 }, { 0x367,     0, 0x397,     0 } }, ///< Depends on CMFV_HAS_MOUSTACHE

    70

	/* CMFV_LIPS            */ { 13, 4, { 12, 10,  9,  9 }, { 0x35B, 0x351, 0x3A5, 0x3C8 } }, ///< Depends on !CMFV_HAS_MOUSTACHE

    71

	/* CMFV_NOSE            */ { 17, 3, {  8,  4,  4,  5 }, { 0x349, 0x34C, 0x393, 0x3B3 } }, ///< Depends on !CMFV_HAS_MOUSTACHE

    72

	/* CMFV_HAIR            */ { 20, 4, {  9,  5,  5,  4 }, { 0x382, 0x38B, 0x3D4, 0x3D9 } },

    73

	/* CMFV_JACKET          */ { 24, 2, {  3,  3,  3,  3 }, { 0x36B, 0x378, 0x36B, 0x378 } },

    74

	/* CMFV_COLLAR          */ { 26, 2, {  4,  4,  4,  4 }, { 0x36E, 0x37B, 0x36E, 0x37B } },

    75

	/* CMFV_TIE_EARRING     */ { 28, 3, {  6,  3,  6,  3 }, { 0x372, 0x37F, 0x372, 0x3D1 } }, ///< Depends on CMFV_HAS_TIE_EARRING

    76

	/* CMFV_GLASSES         */ { 31, 1, {  2,  2,  2,  2 }, { 0x347, 0x347, 0x3AE, 0x3AE } }  ///< Depends on CMFV_HAS_GLASSES

    77

};

    78

assert_compile(lengthof(_cmf_info) == CMFV_END);

    79

    80

/**

    81

 * Gets the company manager's face bits for the given company manager's face variable

    82

 * @param cmf  the face to extract the bits from

    83

 * @param cmfv the face variable to get the data of

    84

 * @param ge   the gender and ethnicity of the face

    85

 * @pre _cmf_info[cmfv].valid_values[ge] != 0

    86

 * @return the requested bits

    87

 */

    88

static inline uint GetCompanyManagerFaceBits(CompanyManagerFace cmf, CompanyManagerFaceVariable cmfv, GenderEthnicity ge)

    89

{

    90

	assert(_cmf_info[cmfv].valid_values[ge] != 0);

    91

    92

	return GB(cmf, _cmf_info[cmfv].offset, _cmf_info[cmfv].length);

    93

}

    94

    95

/**

    96

 * Sets the company manager's face bits for the given company manager's face variable

    97

 * @param cmf  the face to write the bits to

    98

 * @param cmfv the face variable to write the data of

    99

 * @param ge   the gender and ethnicity of the face

   100

 * @param val  the new value

   101

 * @pre val < _cmf_info[cmfv].valid_values[ge]

   102

 */

   103

static inline void SetCompanyManagerFaceBits(CompanyManagerFace &cmf, CompanyManagerFaceVariable cmfv, GenderEthnicity ge, uint val)

   104

{

   105

	assert(val < _cmf_info[cmfv].valid_values[ge]);

   106

   107

	SB(cmf, _cmf_info[cmfv].offset, _cmf_info[cmfv].length, val);

   108

}

   109

   110

/**

   111

 * Increase/Decrease the company manager's face variable by the given amount.

   112

 * If the new value greater than the max value for this variable it will be set to 0.

   113

 * Or is it negativ (< 0) it will be set to max value.

   114

 *

   115

 * @param cmf    the company manager face to write the bits to

   116

 * @param cmfv   the company manager face variable to write the data of

   117

 * @param ge     the gender and ethnicity of the company manager's face

   118

 * @param amount the amount which change the value

   119

 *

   120

 * @pre 0 <= val < _cmf_info[cmfv].valid_values[ge]

   121

 */

   122

static inline void IncreaseCompanyManagerFaceBits(CompanyManagerFace &cmf, CompanyManagerFaceVariable cmfv, GenderEthnicity ge, int8 amount)

   123

{

   124

	int8 val = GetCompanyManagerFaceBits(cmf, cmfv, ge) + amount; // the new value for the cmfv

   125

   126

	/* scales the new value to the correct scope */

   127

	if (val >= _cmf_info[cmfv].valid_values[ge]) {

   128

		val = 0;

   129

	} else if (val < 0) {

   130

		val = _cmf_info[cmfv].valid_values[ge] - 1;

   131

	}

   132

   133

	SetCompanyManagerFaceBits(cmf, cmfv, ge, val); // save the new value

   134

}

   135

   136

/**

   137

 * Checks whether the company manager's face bits have a valid range

   138

 * @param cmf  the face to extract the bits from

   139

 * @param cmfv the face variable to get the data of

   140

 * @param ge   the gender and ethnicity of the face

   141

 * @return true if and only if the bits are valid

   142

 */

   143

static inline bool AreCompanyManagerFaceBitsValid(CompanyManagerFace cmf, CompanyManagerFaceVariable cmfv, GenderEthnicity ge)

   144

{

   145

	return GB(cmf, _cmf_info[cmfv].offset, _cmf_info[cmfv].length) < _cmf_info[cmfv].valid_values[ge];

   146

}

   147

   148

/**

   149

 * Scales a company manager's face bits variable to the correct scope

   150

 * @param cmfv the face variable to write the data of

   151

 * @param ge  the gender and ethnicity of the face

   152

 * @param val the to value to scale

   153

 * @pre val < (1U << _cmf_info[cmfv].length), i.e. val has a value of 0..2^(bits used for this variable)-1

   154

 * @return the scaled value

   155

 */

   156

static inline uint ScaleCompanyManagerFaceValue(CompanyManagerFaceVariable cmfv, GenderEthnicity ge, uint val)

   157

{

   158

	assert(val < (1U << _cmf_info[cmfv].length));

   159

   160

	return (val * _cmf_info[cmfv].valid_values[ge]) >> _cmf_info[cmfv].length;

   161

}

   162

   163

/**

   164

 * Scales all company manager's face bits to the correct scope

   165

 *

   166

 * @param cmf the company manager's face to write the bits to

   167

 */

   168

static inline void ScaleAllCompanyManagerFaceBits(CompanyManagerFace &cmf)

   169

{

   170

	IncreaseCompanyManagerFaceBits(cmf, CMFV_ETHNICITY, GE_WM, 0); // scales the ethnicity

   171

   172

	GenderEthnicity ge = (GenderEthnicity)GB(cmf, _cmf_info[CMFV_GEN_ETHN].offset, _cmf_info[CMFV_GEN_ETHN].length); // gender & ethnicity of the face

   173

   174

	/* Is a male face with moustache. Need to reduce CPU load in the loop. */

   175

	bool is_moust_male = !HasBit(ge, GENDER_FEMALE) && GetCompanyManagerFaceBits(cmf, CMFV_HAS_MOUSTACHE, ge) != 0;

   176

   177

	for (CompanyManagerFaceVariable cmfv = CMFV_EYE_COLOUR; cmfv < CMFV_END; cmfv++) { // scales all other variables

   178

   179

		/* The moustache variable will be scaled only if it is a male face with has a moustache */

   180

		if (cmfv != CMFV_MOUSTACHE || is_moust_male) {

   181

			IncreaseCompanyManagerFaceBits(cmf, cmfv, ge, 0);

   182

		}

   183

	}

   184

}

   185

   186

/**

   187

 * Make a random new face.

   188

 * If it is for the advanced company manager's face window then the new face have the same gender

   189

 * and ethnicity as the old one, else the gender is equal and the ethnicity is random.

   190

 *

   191

 * @param cmf the company manager's face to write the bits to

   192

 * @param ge  the gender and ethnicity of the old company manager's face

   193

 * @param adv if it for the advanced company manager's face window

   194

 *

   195

 * @pre scale 'ge' to a valid gender/ethnicity combination

   196

 */

   197

static inline void RandomCompanyManagerFaceBits(CompanyManagerFace &cmf, GenderEthnicity ge, bool adv)

   198

{

   199

	cmf = InteractiveRandom(); // random all company manager's face bits

   200

   201

	/* scale ge: 0 == GE_WM, 1 == GE_WF, 2 == GE_BM, 3 == GE_BF (and maybe in future: ...) */

   202

	ge = (GenderEthnicity)((uint)ge % GE_END);

   203

   204

	/* set the gender (and ethnicity) for the new company manager's face */

   205

	if (adv) {

   206

		SetCompanyManagerFaceBits(cmf, CMFV_GEN_ETHN, ge, ge);

   207

	} else {

   208

		SetCompanyManagerFaceBits(cmf, CMFV_GENDER, ge, HasBit(ge, GENDER_FEMALE));

   209

	}

   210

   211

	/* scales all company manager's face bits to the correct scope */

   212

	ScaleAllCompanyManagerFaceBits(cmf);

   213

}

   214

   215

/**

   216

 * Gets the sprite to draw for the given company manager's face variable

   217

 * @param cmf  the face to extract the data from

   218

 * @param cmfv the face variable to get the sprite of

   219

 * @param ge   the gender and ethnicity of the face

   220

 * @pre _cmf_info[cmfv].valid_values[ge] != 0

   221

 * @return sprite to draw

   222

 */

   223

static inline SpriteID GetCompanyManagerFaceSprite(CompanyManagerFace cmf, CompanyManagerFaceVariable cmfv, GenderEthnicity ge)

   224

{

   225

	assert(_cmf_info[cmfv].valid_values[ge] != 0);

   226

   227

	return _cmf_info[cmfv].first_sprite[ge] + GB(cmf, _cmf_info[cmfv].offset, _cmf_info[cmfv].length);

   228

}

   229

   230

void DrawCompanyManagerFace(CompanyManagerFace face, int color, int x, int y);

   231

CompanyManagerFace ConvertFromOldCompanyManagerFace(uint32 face);

   232

bool IsValidCompanyManagerFace(CompanyManagerFace cmf);

   233

   234

#endif /* COMPANY_MANAGER_FACE_H */