]> git.sesse.net Git - stockfish/blob - src/value.h
Documentation fix
[stockfish] / src / value.h
1 /*
2   Stockfish, a UCI chess playing engine derived from Glaurung 2.1
3   Copyright (C) 2004-2008 Tord Romstad (Glaurung author)
4   Copyright (C) 2008-2010 Marco Costalba, Joona Kiiski, Tord Romstad
5
6   Stockfish is free software: you can redistribute it and/or modify
7   it under the terms of the GNU General Public License as published by
8   the Free Software Foundation, either version 3 of the License, or
9   (at your option) any later version.
10
11   Stockfish is distributed in the hope that it will be useful,
12   but WITHOUT ANY WARRANTY; without even the implied warranty of
13   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14   GNU General Public License for more details.
15
16   You should have received a copy of the GNU General Public License
17   along with this program.  If not, see <http://www.gnu.org/licenses/>.
18 */
19
20
21 #if !defined(VALUE_H_INCLUDED)
22 #define VALUE_H_INCLUDED
23
24 ////
25 //// Includes
26 ////
27
28 #include "piece.h"
29
30
31 ////
32 //// Types
33 ////
34
35 enum ValueType {
36   VALUE_TYPE_NONE  = 0,
37   VALUE_TYPE_UPPER = 1,  // Upper bound
38   VALUE_TYPE_LOWER = 2,  // Lower bound
39   VALUE_TYPE_EVAL  = 4,  // Static evaluation value
40
41   VALUE_TYPE_EXACT = VALUE_TYPE_UPPER | VALUE_TYPE_LOWER,
42   VALUE_TYPE_EV_UP = VALUE_TYPE_EVAL  | VALUE_TYPE_UPPER,
43   VALUE_TYPE_EV_LO = VALUE_TYPE_EVAL  | VALUE_TYPE_LOWER
44 };
45
46
47 enum Value {
48   VALUE_DRAW = 0,
49   VALUE_KNOWN_WIN = 15000,
50   VALUE_MATE = 30000,
51   VALUE_INFINITE = 30001,
52   VALUE_NONE = 30002,
53   VALUE_ENSURE_SIGNED = -1
54 };
55
56
57 /// Score enum keeps a midgame and an endgame value in a single
58 /// integer (enum), first LSB 16 bits are used to store endgame
59 /// value, while upper bits are used for midgame value.
60
61 // Compiler is free to choose the enum type as long as can keep
62 // its data, so ensure Score to be an integer type.
63 enum Score { ENSURE_32_BITS_SIZE_P = (1 << 16), ENSURE_32_BITS_SIZE_N = -(1 << 16)};
64
65 // Extracting the _signed_ lower and upper 16 bits it not so trivial
66 // because according to the standard a simple cast to short is
67 // implementation defined and so is a right shift of a signed integer.
68 inline Value mg_value(Score s) { return Value(((int(s) + 32768) & ~0xffff) / 0x10000); }
69
70 // Unfortunatly on Intel 64 bit we have a small speed regression, so use a faster code in
71 // this case, although not 100% standard compliant it seems to work for Intel and MSVC.
72 #if defined(IS_64BIT) && (!defined(__GNUC__) || defined(__INTEL_COMPILER))
73 inline Value eg_value(Score s) { return Value(int16_t(s & 0xffff)); }
74 #else
75 inline Value eg_value(Score s) { return Value((int)(unsigned(s) & 0x7fffu) - (int)(unsigned(s) & 0x8000u)); }
76 #endif
77
78 inline Score make_score(int mg, int eg) { return Score((mg << 16) + eg); }
79
80 inline Score operator-(Score s) { return Score(-int(s)); }
81 inline Score operator+(Score s1, Score s2) { return Score(int(s1) + int(s2)); }
82 inline Score operator-(Score s1, Score s2) { return Score(int(s1) - int(s2)); }
83 inline void operator+=(Score& s1, Score s2) { s1 = Score(int(s1) + int(s2)); }
84 inline void operator-=(Score& s1, Score s2) { s1 = Score(int(s1) - int(s2)); }
85 inline Score operator*(int i, Score s) { return Score(i * int(s)); }
86
87 // Division must be handled separately for each term
88 inline Score operator/(Score s, int i) { return make_score(mg_value(s) / i, eg_value(s) / i); }
89
90 // Only declared but not defined. We don't want to multiply two scores due to
91 // a very high risk of overflow. So user should explicitly convert to integer.
92 inline Score operator*(Score s1, Score s2);
93
94
95 ////
96 //// Constants and variables
97 ////
98
99 /// Piece values, middle game and endgame
100
101 /// Important: If the material values are changed, one must also
102 /// adjust the piece square tables, and the method game_phase() in the
103 /// Position class!
104 ///
105 /// Values modified by Joona Kiiski
106
107 const Value PawnValueMidgame   = Value(0x0C6);
108 const Value PawnValueEndgame   = Value(0x102);
109 const Value KnightValueMidgame = Value(0x331);
110 const Value KnightValueEndgame = Value(0x34E);
111 const Value BishopValueMidgame = Value(0x344);
112 const Value BishopValueEndgame = Value(0x359);
113 const Value RookValueMidgame   = Value(0x4F6);
114 const Value RookValueEndgame   = Value(0x4FE);
115 const Value QueenValueMidgame  = Value(0x9D9);
116 const Value QueenValueEndgame  = Value(0x9FE);
117
118 const Value PieceValueMidgame[17] = {
119   Value(0),
120   PawnValueMidgame, KnightValueMidgame, BishopValueMidgame,
121   RookValueMidgame, QueenValueMidgame,
122   Value(0), Value(0), Value(0),
123   PawnValueMidgame, KnightValueMidgame, BishopValueMidgame,
124   RookValueMidgame, QueenValueMidgame,
125   Value(0), Value(0), Value(0)
126 };
127
128 const Value PieceValueEndgame[17] = {
129   Value(0),
130   PawnValueEndgame, KnightValueEndgame, BishopValueEndgame,
131   RookValueEndgame, QueenValueEndgame,
132   Value(0), Value(0), Value(0),
133   PawnValueEndgame, KnightValueEndgame, BishopValueEndgame,
134   RookValueEndgame, QueenValueEndgame,
135   Value(0), Value(0), Value(0)
136 };
137
138 /// Bonus for having the side to move (modified by Joona Kiiski)
139
140 const Score TempoValue = make_score(48, 22);
141
142
143 ////
144 //// Inline functions
145 ////
146
147 inline Value operator+ (Value v, int i) { return Value(int(v) + i); }
148 inline Value operator+ (Value v1, Value v2) { return Value(int(v1) + int(v2)); }
149 inline void operator+= (Value &v1, Value v2) {
150   v1 = Value(int(v1) + int(v2));
151 }
152 inline Value operator- (Value v, int i) { return Value(int(v) - i); }
153 inline Value operator- (Value v) { return Value(-int(v)); }
154 inline Value operator- (Value v1, Value v2) { return Value(int(v1) - int(v2)); }
155 inline void operator-= (Value &v1, Value v2) {
156   v1 = Value(int(v1) - int(v2));
157 }
158 inline Value operator* (Value v, int i) { return Value(int(v) * i); }
159 inline void operator*= (Value &v, int i) { v = Value(int(v) * i); }
160 inline Value operator* (int i, Value v) { return Value(int(v) * i); }
161 inline Value operator/ (Value v, int i) { return Value(int(v) / i); }
162 inline void operator/= (Value &v, int i) { v = Value(int(v) / i); }
163
164
165 inline Value value_mate_in(int ply) {
166   return Value(VALUE_MATE - Value(ply));
167 }
168
169 inline Value value_mated_in(int ply) {
170   return Value(-VALUE_MATE + Value(ply));
171 }
172
173 inline bool is_upper_bound(ValueType vt) {
174   return (int(vt) & int(VALUE_TYPE_UPPER)) != 0;
175 }
176
177 inline bool is_lower_bound(ValueType vt) {
178   return (int(vt) & int(VALUE_TYPE_LOWER)) != 0;
179 }
180
181 inline Value piece_value_midgame(PieceType pt) {
182   return PieceValueMidgame[pt];
183 }
184
185 inline Value piece_value_endgame(PieceType pt) {
186   return PieceValueEndgame[pt];
187 }
188
189 inline Value piece_value_midgame(Piece p) {
190   return PieceValueMidgame[p];
191 }
192
193 inline Value piece_value_endgame(Piece p) {
194   return PieceValueEndgame[p];
195 }
196
197
198 ////
199 //// Prototypes
200 ////
201
202 extern Value value_to_tt(Value v, int ply);
203 extern Value value_from_tt(Value v, int ply);
204 extern int value_to_centipawns(Value v);
205 extern Value value_from_centipawns(int cp);
206 extern const std::string value_to_string(Value v);
207
208
209 #endif // !defined(VALUE_H_INCLUDED)