2 * common.h -- Common definitions for X and Windows NT versions of XBoard
4 * Copyright 1991 by Digital Equipment Corporation, Maynard,
5 * Massachusetts. Enhancements Copyright
6 * 1992-2001,2002,2003,2004,2005,2006,2007,2008,2009 Free Software
9 * The following terms apply to Digital Equipment Corporation's copyright
11 * ------------------------------------------------------------------------
14 * Permission to use, copy, modify, and distribute this software and its
15 * documentation for any purpose and without fee is hereby granted,
16 * provided that the above copyright notice appear in all copies and that
17 * both that copyright notice and this permission notice appear in
18 * supporting documentation, and that the name of Digital not be
19 * used in advertising or publicity pertaining to distribution of the
20 * software without specific, written prior permission.
22 * DIGITAL DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING
23 * ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL
24 * DIGITAL BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR
25 * ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
26 * WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION,
27 * ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS
29 * ------------------------------------------------------------------------
31 * The following terms apply to the enhanced version of XBoard
32 * distributed by the Free Software Foundation:
33 * ------------------------------------------------------------------------
35 * GNU XBoard is free software: you can redistribute it and/or modify
36 * it under the terms of the GNU General Public License as published by
37 * the Free Software Foundation, either version 3 of the License, or (at
38 * your option) any later version.
40 * GNU XBoard is distributed in the hope that it will be useful, but
41 * WITHOUT ANY WARRANTY; without even the implied warranty of
42 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
43 * General Public License for more details.
45 * You should have received a copy of the GNU General Public License
46 * along with this program. If not, see http://www.gnu.org/licenses/. *
48 *------------------------------------------------------------------------
49 ** See the file ChangeLog for a revision history. */
55 /* Begin compatibility grunge */
57 #if defined(__STDC__) || defined(WIN32) || defined(_amigados)
59 typedef void *VOIDSTAR;
62 typedef char *VOIDSTAR;
69 #define pclose _pclose
72 #ifdef _amigados /* It is important, that these types have */
73 typedef int Boolean; /* a length of 4 bytes each, as we are */
74 typedef char *String; /* using ReadArgs() for argument parsing. */
76 FILE *popen(const char *, const char *);
81 #include <X11/Intrinsic.h>
91 #define UNKNOWN -1 /* [HGM] nps */
95 # define srandom srand48
96 # define random lrand48
97 # else /* not HAVE_RAND48 */
98 # define srandom srand
100 # endif /* not HAVE_RAND48 */
101 #endif /* !HAVE_RANDOM */
103 /* End compatibility grunge */
105 #define PROTOVER 2 /* engine protocol version */
107 // [HGM] license: Messages that engines must print to satisfy their license requirements for patented variants
108 #define GOTHIC "Gothic Chess (see www.GothicChess.com) is licensed under U.S. Patent #6,481,716 by Ed Trice"
109 #define NOFALCON "Falcon Chess (see www.chessvariants.com) is licensed under U.S. Patent #5,690,334 by George W. Duke"
111 /* [HGM] Some notes about board sizes:
112 In games that allow piece drops, the holdings are considered part of the
113 board, in the leftmost and rightmost two files. This way they are
114 automatically part of the game-history states, and enjoy all display
115 functions (including drag-drop and click-click moves to the regular part
116 of the board). The drawback of this is that the internal numbering of
117 files starts at 2 for the a-file if holdings are displayed. To ensure
118 consistency, this shifted numbering system is used _everywhere_ in the
119 code, and conversion to the 'normal' system only takes place when the
120 file number is converted to or from ASCII (by redefining the character
121 constant 'a'). This works because Winboard only communicates with the
122 outside world in ASCII. In a similar way, the different rank numbering
123 systems (starting at rank 0 or 1) are implemented by redefining '1'.
125 #define BOARD_SIZE 16 /* [HGM] for in declarations */
126 #define BOARD_HEIGHT (gameInfo.boardHeight) // [HGM] made user adjustable
127 #define BOARD_WIDTH (gameInfo.boardWidth + 2*gameInfo.holdingsWidth)
128 #define BOARD_LEFT (gameInfo.holdingsWidth) // [HGM] play-board edges
129 #define BOARD_RGHT (gameInfo.boardWidth + gameInfo.holdingsWidth)
130 #define ONE ('1'-(BOARD_HEIGHT>9)) // [HGM] foremost board rank
131 #define AAA ('a'-BOARD_LEFT) // [HGM] leftmost board file
133 #define MAX_MOVES 1000
135 #define DIALOG_SIZE 256
136 #define STAR_MATCH_N 16
138 #define TIME_CONTROL "5" /* in minutes */
139 #define TIME_DELAY_QUOTE "1.0" /* seconds between moves */
140 #define TIME_DELAY ((float) 1.0)
141 #define MOVES_PER_SESSION 40 /* moves per TIME_CONTROL */
142 #define TIME_INCREMENT -1 /* if >= 0, MOVES_PER_SESSION unused */
143 #define WhiteOnMove(move) (((move) % 2) == 0)
144 #define ICS_HOST "chessclub.com"
145 #define ICS_PORT "5000"
146 #define ICS_COMM_PORT ""
147 #define FIRST_HOST "localhost"
148 #define SECOND_HOST "localhost"
149 #define TELNET_PROGRAM "telnet"
150 #define DEF_BITMAP_DIR "/usr/share/games/xboard/bitmaps.xchess" /* AP: shouldn't be hardcoded directory, but better than nothing at the moment */
151 #define MATCH_MODE "False"
152 #define INIT_STRING "new\nrandom\n"
153 #define WHITE_STRING "white\ngo\n"
154 #define BLACK_STRING "black\ngo\n"
155 #define COMPUTER_STRING "computer\n"
156 #define REUSE_CHESS_PROGRAMS 1
157 #define WHITE_PIECE_COLOR "#FFFFCC"
158 #define BLACK_PIECE_COLOR "#202020"
159 #define LIGHT_SQUARE_COLOR "#C8C365"
160 #define DARK_SQUARE_COLOR "#77A26D"
161 #define JAIL_SQUARE_COLOR "#808080"
162 #define HIGHLIGHT_SQUARE_COLOR "#FFFF00"
163 #define PREMOVE_HIGHLIGHT_COLOR "#FF0000"
164 #define BELLCHAR '\007'
165 #define NULLCHAR '\000'
166 #define FEATURE_TIMEOUT 10000 /*ms*/
169 #define ZIPPY_TALK FALSE
170 #define ZIPPY_PLAY FALSE
171 #define ZIPPY_LINES "yow.lines"
172 #define ZIPPY_PINHEAD ""
173 #define ZIPPY_PASSWORD ""
174 #define ZIPPY_PASSWORD2 ""
175 #define ZIPPY_WRONG_PASSWORD ""
176 #define ZIPPY_ACCEPT_ONLY ""
177 #define ZIPPY_USE_I TRUE
178 #define ZIPPY_BUGHOUSE 0
179 #define ZIPPY_NOPLAY_CRAFTY FALSE
180 #define ZIPPY_GAME_END "gameend\n"
181 #define ZIPPY_GAME_START ""
182 #define ZIPPY_ADJOURN FALSE
183 #define ZIPPY_ABORT FALSE
184 #define ZIPPY_VARIANTS "normal,fischerandom,crazyhouse,losers,suicide,3checks,twokings,bughouse,shatranj"
185 #define ZIPPY_MAX_GAMES 0
186 #define ZIPPY_REPLAY_TIMEOUT 120
189 BeginningOfGame, MachinePlaysWhite, MachinePlaysBlack,
190 AnalyzeMode, AnalyzeFile, TwoMachinesPlay,
191 EditGame, PlayFromGameFile, EndOfGame, EditPosition, Training,
192 IcsIdle, IcsPlayingWhite, IcsPlayingBlack, IcsObserving,
197 /* [HGM] the order here is crucial for Crazyhouse & Shogi: */
198 /* only the first N pieces can go into the holdings, and */
199 /* promotions in those variants shift P-W to U-S */
200 WhitePawn, WhiteKnight, WhiteBishop, WhiteRook, WhiteQueen,
201 WhiteFerz, WhiteAlfil, WhiteAngel, WhiteMarshall, WhiteWazir, WhiteMan,
202 WhiteCannon, WhiteNightrider, WhiteCardinal, WhiteDragon, WhiteGrasshopper,
203 WhiteSilver, WhiteFalcon, WhiteLance, WhiteCobra, WhiteUnicorn, WhiteKing,
204 BlackPawn, BlackKnight, BlackBishop, BlackRook, BlackQueen,
205 BlackFerz, BlackAlfil, BlackAngel, BlackMarshall, BlackWazir, BlackMan,
206 BlackCannon, BlackNightrider, BlackCardinal, BlackDragon, BlackGrasshopper,
207 BlackSilver, BlackFalcon, BlackLance, BlackCobra, BlackUnicorn, BlackKing,
209 ClearBoard, WhitePlay, BlackPlay, PromotePiece, DemotePiece /*for use on EditPosition menus*/
212 /* [HGM] some macros that can be used as prefixes to convert piece types */
213 #define WHITE_TO_BLACK (int)BlackPawn - (int)WhitePawn + (int)
214 #define BLACK_TO_WHITE (int)WhitePawn - (int)BlackPawn + (int)
215 #define PROMOTED (int)WhiteDragon - (int)WhiteRook + (int)
216 #define DEMOTED (int)WhiteRook - (int)WhiteDragon + (int)
217 #define SHOGI (int)EmptySquare + (int)
220 typedef ChessSquare Board[BOARD_SIZE][BOARD_SIZE];
223 WhiteKingSideCastle = 1, WhiteQueenSideCastle,
224 WhiteKingSideCastleWild, WhiteQueenSideCastleWild,
225 WhiteHSideCastleFR, WhiteASideCastleFR,
226 BlackKingSideCastle, BlackQueenSideCastle,
227 BlackKingSideCastleWild, BlackQueenSideCastleWild,
228 BlackHSideCastleFR, BlackASideCastleFR,
229 WhitePromotionKnight, WhitePromotionBishop,
230 WhitePromotionRook, WhitePromotionQueen, WhitePromotionKing,
231 WhitePromotionChancellor, WhitePromotionArchbishop, WhitePromotionCentaur,
232 BlackPromotionKnight, BlackPromotionBishop,
233 BlackPromotionRook, BlackPromotionQueen, BlackPromotionKing,
234 BlackPromotionChancellor, BlackPromotionArchbishop, BlackPromotionCentaur,
235 WhiteCapturesEnPassant, BlackCapturesEnPassant,
236 WhiteDrop, BlackDrop,
237 NormalMove, AmbiguousMove, IllegalMove, ImpossibleMove,
238 WhiteWins, BlackWins, GameIsDrawn, GameUnfinished,
239 GNUChessGame, XBoardGame, MoveNumberOne,
240 Comment, PositionDiagram, ElapsedTime, PGNTag, NAG
244 ColorShout, ColorSShout, ColorChannel1, ColorChannel, ColorKibitz,
245 ColorTell, ColorChallenge, ColorRequest, ColorSeek, ColorNormal,
246 ColorNone, NColorClasses
250 SoundMove, SoundBell, SoundAlarm, SoundIcsWin, SoundIcsLoss,
251 SoundIcsDraw, SoundIcsUnfinished, NSoundClasses
254 /* Names for chess variants, not necessarily supported */
256 VariantNormal, /* Normal chess */
257 VariantLoadable, /* "loadgame" command allowed (not really a variant)*/
258 VariantWildCastle, /* Shuffle chess where king can castle from d file */
259 VariantNoCastle, /* Shuffle chess with no castling at all */
260 VariantFischeRandom, /* FischeRandom */
261 VariantBughouse, /* Bughouse, ICC/FICS rules */
262 VariantCrazyhouse, /* Crazyhouse, ICC/FICS rules */
263 VariantLosers, /* Try to lose all pieces or get mated (ICC wild 17)*/
264 VariantSuicide, /* Try to lose all pieces incl. king (FICS) */
265 VariantGiveaway, /* Try to have no legal moves left (ICC wild 26) */
266 VariantTwoKings, /* Weird ICC wild 9 */
267 VariantKriegspiel, /* Kriegspiel; pawns can capture invisible pieces */
268 VariantAtomic, /* Capturing piece explodes (ICC wild 27) */
269 Variant3Check, /* Win by giving check 3 times (ICC wild 25) */
270 VariantShatranj, /* Unsupported (ICC wild 28) */
271 Variant29, /* Temporary name for possible future ICC wild 29 */
272 Variant30, /* Temporary name for possible future ICC wild 30 */
273 Variant31, /* Temporary name for possible future ICC wild 31 */
274 Variant32, /* Temporary name for possible future ICC wild 32 */
275 Variant33, /* Temporary name for possible future ICC wild 33 */
276 Variant34, /* Temporary name for possible future ICC wild 34 */
277 Variant35, /* Temporary name for possible future ICC wild 35 */
278 Variant36, /* Temporary name for possible future ICC wild 36 */
279 VariantShogi, /* [HGM] added variants */
294 VariantUnknown /* Catchall for other unknown variants */
297 #define VARIANT_NAMES { \
340 #if !defined(_amigados)
341 char *whitePieceColor;
342 char *blackPieceColor;
343 char *lightSquareColor;
344 char *darkSquareColor;
345 char *jailSquareColor;
346 char *highlightSquareColor;
347 char *premoveHighlightColor;
351 int lightSquareColor;
354 int highlightSquareColor;
355 int premoveHighlightColor;
360 char *secondInitString;
361 char *firstComputerString;
362 char *secondComputerString;
363 char *firstChessProgram;
364 char *secondChessProgram;
365 char *firstDirectory;
366 char *secondDirectory;
367 Boolean firstPlaysBlack;
368 Boolean noChessProgram;
371 char *bitmapDirectory;
379 char *icsCommPort; /* if set, use serial port instead of tcp host/port */
380 char *icsLogon; /* Hack to permit variable logon scripts. */
387 int loadGameIndex; /* game # within file */
389 Boolean autoSaveGames;
390 char *loadPositionFile;
391 int loadPositionIndex; /* position # within file */
392 char *savePositionFile;
404 char *messageFont; /* WinBoard only */
406 char *font; /* xboard only: all other fonts */
407 char *tagsFont; /* WinBoard only */
408 char *commentFont; /* WinBoard only */
409 char *icsFont; /* WinBoard only */
410 Boolean ringBellAfterMoves;
411 Boolean autoCallFlag;
413 Boolean autoFlipView;
414 char *cmailGameName; /* xboard only */
415 Boolean alwaysPromoteToQueen;
416 Boolean oldSaveStyle;
418 Boolean showThinking;
419 Boolean ponderNextMove;
420 Boolean periodicUpdates;
424 Boolean testLegality;
425 int borderXoffset; /* xboard only */
426 int borderYoffset; /* xboard only */
427 Boolean titleInWindow; /* xboard only */
428 Boolean localLineEditing; /* WinBoard only */
431 int flashCount; /* Number of times to flash (xboard only) */
432 int flashRate; /* Flashes per second (xboard only) */
433 char *pixmapDirectory; /* Path to XPM/XIM files to use (xboard only) */
434 int msLoginDelay; /* Delay per character (in msec) while sending
435 ICS logon script (xboard only) */
436 Boolean colorize; /* If True, use the following colors to color text */
437 /* Strings for colors, as "fg, bg, bold" (strings used in xboard only) */
444 char *colorChallenge;
448 char *soundProgram; /* sound-playing program */
455 char *soundChallenge;
462 char *soundIcsUnfinished;
466 Boolean animateDragging; /* If True, animate mouse dragging of pieces */
467 Boolean animate; /* If True, animate non-mouse moves */
468 int animSpeed; /* Delay in milliseconds between animation frames */
469 Boolean popupMoveErrors;
470 Boolean popupExitMessage;
472 Boolean highlightLastMove;
473 Boolean highlightDragging;
474 Boolean blindfold; /* if true, no pieces are drawn */
475 Boolean premove; /* true if premove feature enabled */
476 Boolean premoveWhite; /* true if premoving White first move */
477 char *premoveWhiteText; /* text of White premove 1 */
478 Boolean premoveBlack; /* true if premoving Black first move */
479 char *premoveBlackText; /* text of Black premove 1 */
480 Boolean icsAlarm; /* true if sounding alarm at a certain time */
481 int icsAlarmTime; /* time to sound alarm, in milliseconds */
482 Boolean autoRaiseBoard;
483 int fontSizeTolerance; /* xboard only */
486 int firstProtocolVersion;
487 int secondProtocolVersion;
488 Boolean showButtonBar;
489 Boolean icsEngineAnalyze;
491 /* [AS] New properties (down to the "ZIPPY" part) */
492 Boolean firstScoreIsAbsolute; /* If true, engine score is always from white side */
493 Boolean secondScoreIsAbsolute; /* If true, engine score is always from white side */
494 Boolean saveExtendedInfoInPGN; /* If true, saved PGN games contain extended info */
495 Boolean hideThinkingFromHuman; /* If true, program thinking is generated but not displayed in human/computer matches */
496 char * liteBackTextureFile; /* Name of texture bitmap for lite squares */
497 char * darkBackTextureFile; /* Name of texture bitmap for dark squares */
498 int liteBackTextureMode;
499 int darkBackTextureMode;
500 char * renderPiecesWithFont; /* Name of font for rendering chess pieces */
501 char * fontToPieceTable; /* Map to translate font character to chess pieces */
502 int fontBackColorWhite;
503 int fontForeColorWhite;
504 int fontBackColorBlack;
505 int fontForeColorBlack;
506 int fontPieceSize; /* Size of font relative to square (percentage) */
507 int overrideLineGap; /* If >= 0 overrides the lineGap value of the board size properties */
508 int adjudicateLossThreshold; /* Adjudicate a two-machine game if both engines agree the score is below this for 6 plies */
511 char * nameOfDebugFile;
512 char * pgnEventHeader;
513 int defaultFrcPosition;
515 Boolean saveOutOfBookInfo;
516 Boolean showEvalInMoveHistory;
517 int evalHistColorWhite;
518 int evalHistColorBlack;
519 Boolean highlightMoveWithArrow;
520 int highlightArrowColor;
521 Boolean useStickyWindows;
522 int adjudicateDrawMoves;
523 Boolean autoDisplayComment;
524 Boolean autoDisplayTags;
527 Boolean firstHasOwnBookUCI;
528 Boolean secondHasOwnBookUCI;
530 Boolean usePolyglotBook;
533 int defaultCacheSizeEGTB;
534 char * defaultPathEGTB;
536 /* [HGM] Board size */
541 char * pieceToCharTable;
547 Boolean materialDraws;
548 Boolean trivialDraws;
556 char *zippyPassword2;
557 char *zippyWrongPassword;
558 char *zippyAcceptOnly;
561 int zippyNoplayCrafty;
563 char *zippyGameStart;
568 int zippyReplayTimeout; /*seconds*/
569 int zippyShortGame; /* [HGM] aborter */
571 Boolean lowTimeWarning; /* [HGM] low time */
572 char *lowTimeWarningColor;
574 char *serverMovesName;
575 Boolean suppressLoadMoves;
580 int firstAccumulateTC;
581 int secondAccumulateTC;
587 int rewindIndex; /* [HGM] autoinc */
588 int sameColorGames; /* [HGM] alternate */
589 int smpCores; /* [HGM] SMP */
591 int niceEngines; /* [HGM] nice */
592 char *firstLogo; /* [HGM] logo */
595 Boolean noGUI; /* [HGM] fast: suppress all display updates */
596 char *firstOptions; /* [HGM] options */
600 } AppData, *AppDataPtr;
602 /* [AS] PGN tags (for showing in the game list) */
603 #define GLT_EVENT 'e'
606 #define GLT_ROUND 'o'
607 #define GLT_PLAYERS 'p' /* I.e. white "-" black */
608 #define GLT_RESULT 'r'
609 #define GLT_WHITE_ELO 'w'
610 #define GLT_BLACK_ELO 'b'
611 #define GLT_TIME_CONTROL 't'
612 #define GLT_VARIANT 'v'
613 #define GLT_OUT_OF_BOOK 'a'
615 #define GLT_DEFAULT_TAGS "eprd" /* Event, players, result, date */
617 #define GLT_ALL_TAGS "esdoprwbtva"
619 #define PGN_OUT_OF_BOOK "Annotator"
621 extern AppData appData;
632 /* Additional info */
633 char *fen; /* NULL or FEN for starting position; input only */
636 char *extraTags; /* NULL or "[Tag \"Value\"]\n", etc. */
637 int whiteRating; /* -1 if unknown */
638 int blackRating; /* -1 if unknown */
639 VariantClass variant;
640 char *outOfBook; /* [AS] Move and score when engine went out of book */
641 int boardWidth; /* [HGM] adjustable board size */
643 /* [HGM] For Shogi and Crazyhouse: */
644 int holdingsSize; /* number of different piece types in holdings */
645 int holdingsWidth; /* number of files left and right of board, 0 or 2 */