2 * frontend.h -- Interface exported by all XBoard front ends
4 * Copyright 1991 by Digital Equipment Corporation, Maynard,
7 * Enhancements Copyright 1992-2001, 2002, 2003, 2004, 2005, 2006,
8 * 2007, 2008, 2009, 2010, 2011 Free Software Foundation, Inc.
10 * Enhancements Copyright 2005 Alessandro Scotti
12 * The following terms apply to Digital Equipment Corporation's copyright
14 * ------------------------------------------------------------------------
17 * Permission to use, copy, modify, and distribute this software and its
18 * documentation for any purpose and without fee is hereby granted,
19 * provided that the above copyright notice appear in all copies and that
20 * both that copyright notice and this permission notice appear in
21 * supporting documentation, and that the name of Digital not be
22 * used in advertising or publicity pertaining to distribution of the
23 * software without specific, written prior permission.
25 * DIGITAL DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING
26 * ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL
27 * DIGITAL BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR
28 * ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
29 * WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION,
30 * ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS
32 * ------------------------------------------------------------------------
34 * The following terms apply to the enhanced version of XBoard
35 * distributed by the Free Software Foundation:
36 * ------------------------------------------------------------------------
38 * GNU XBoard is free software: you can redistribute it and/or modify
39 * it under the terms of the GNU General Public License as published by
40 * the Free Software Foundation, either version 3 of the License, or (at
41 * your option) any later version.
43 * GNU XBoard is distributed in the hope that it will be useful, but
44 * WITHOUT ANY WARRANTY; without even the implied warranty of
45 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
46 * General Public License for more details.
48 * You should have received a copy of the GNU General Public License
49 * along with this program. If not, see http://www.gnu.org/licenses/. *
51 *------------------------------------------------------------------------
52 ** See the file ChangeLog for a revision history. */
59 typedef VOIDSTAR ProcRef;
60 #define NoProc ((ProcRef) 0)
61 typedef VOIDSTAR InputSourceRef;
63 char *T_ P((char *s));
64 void ModeHighlight P((void));
65 void SetICSMode P((void));
66 void SetGNUMode P((void));
67 void SetNCPMode P((void));
68 void SetCmailMode P((void));
69 void SetTrainingModeOn P((void));
70 void SetTrainingModeOff P((void));
71 void SetUserThinkingEnables P((void));
72 void SetMachineThinkingEnables P((void));
73 void DisplayTitle P((String title));
74 void DisplayMessage P((String message, String extMessage));
75 void DisplayError P((String message, int error));
76 void DisplayMoveError P((String message));
78 /* If status == 0, we are exiting with a benign message, not an error */
79 void DisplayFatalError P((String message, int error, int status));
81 void DisplayInformation P((String message));
82 void DisplayNote P((String message));
83 void AskQuestion P((String title, String question, String replyPrefix,
85 void DisplayIcsInteractionTitle P((String title));
86 void ParseArgsFromString P((char *p));
87 void ParseArgsFromFile P((FILE *f));
88 void DrawPosition P((int fullRedraw, Board board));
89 void ResetFrontEnd P((void));
90 void NotifyFrontendLogin P((void));
91 void CommentPopUp P((String title, String comment));
92 void CommentPopDown P((void));
93 void EditCommentPopUp P((int index, String title, String text));
94 void ErrorPopDown P((void));
95 int EventToSquare P((int x, int limit));
96 void DrawSeekAxis P(( int x, int y, int xTo, int yTo ));
97 void DrawSeekBackground P(( int left, int top, int right, int bottom ));
98 void DrawSeekText P((char *buf, int x, int y));
99 void DrawSeekDot P((int x, int y, int color));
100 void PopUpMoveDialog P((char first));
102 void RingBell P((void));
103 void PlayIcsWinSound P((void));
104 void PlayIcsLossSound P((void));
105 void PlayIcsDrawSound P((void));
106 void PlayIcsUnfinishedSound P((void));
107 void PlayAlarmSound P((void));
108 void PlayTellSound P((void));
109 void EchoOn P((void));
110 void EchoOff P((void));
112 void Colorize P((ColorClass cc, int continuation));
113 char *InterpretFileName P((char *name, char *dir));
115 char *UserName P((void));
116 char *HostName P((void));
118 int ClockTimerRunning P((void));
119 int StopClockTimer P((void));
120 void StartClockTimer P((long millisec));
121 void DisplayWhiteClock P((long timeRemaining, int highlight));
122 void DisplayBlackClock P((long timeRemaining, int highlight));
123 void UpdateLogos P((int display));
125 int LoadGameTimerRunning P((void));
126 int StopLoadGameTimer P((void));
127 void StartLoadGameTimer P((long millisec));
128 void AutoSaveGame P((void));
130 typedef void (*DelayedEventCallback) P((void));
131 void ScheduleDelayedEvent P((DelayedEventCallback cb, long millisec));
132 DelayedEventCallback GetDelayedEvent P((void));
133 void CancelDelayedEvent P((void));
134 // [HGM] mouse: next six used by mouse handler, which was moved to backend
135 extern int fromX, fromY, toX, toY;
136 typedef enum { Press, Release } ClickType;
137 void PromotionPopUp P((void));
138 void DragPieceBegin P((int x, int y));
139 void DragPieceEnd P((int x, int y));
140 void LeftClick P((ClickType c, int x, int y));
141 int RightClick P((ClickType c, int x, int y, int *col, int *row));
143 int StartChildProcess P((char *cmdLine, char *dir, ProcRef *pr));
144 void DestroyChildProcess P((ProcRef pr, int/*boolean*/ signal));
145 void InterruptChildProcess P((ProcRef pr));
147 int OpenTelnet P((char *host, char *port, ProcRef *pr));
148 int OpenTCP P((char *host, char *port, ProcRef *pr));
149 int OpenCommPort P((char *name, ProcRef *pr));
150 int OpenLoopback P((ProcRef *pr));
151 int OpenRcmd P((char *host, char *user, char *cmd, ProcRef *pr));
153 typedef void (*InputCallback) P((InputSourceRef isr, VOIDSTAR closure,
154 char *buf, int count, int error));
155 /* pr == NoProc means the local keyboard */
156 InputSourceRef AddInputSource P((ProcRef pr, int lineByLine,
157 InputCallback func, VOIDSTAR closure));
158 void RemoveInputSource P((InputSourceRef isr));
160 /* pr == NoProc means the local display */
161 int OutputToProcess P((ProcRef pr, char *message, int count, int *outError));
162 int OutputToProcessDelayed P((ProcRef pr, char *message, int count,
163 int *outError, long msdelay));
165 void CmailSigHandlerCallBack P((InputSourceRef isr, VOIDSTAR closure,
166 char *buf, int count, int error));
168 extern ProcRef cmailPR;
171 /* in xgamelist.c or winboard.c */
172 void GLT_ClearList();
173 void GLT_DeSelectList();
174 void GLT_AddToList( char *name );
175 Boolean GLT_GetFromList( int index, char *name );
177 extern char lpUserGLT[];
178 extern char *homeDir;
180 /* these are in wgamelist.c */
181 void GameListPopUp P((FILE *fp, char *filename));
182 void GameListPopDown P((void));
183 void GameListHighlight P((int index));
184 void GameListDestroy P((void));
186 /* these are in wedittags.c */
187 void EditTagsPopUp P((char *tags, char **dest));
188 void TagsPopUp P((char *tags, char *msg));
189 void TagsPopDown P((void));
191 void ICSInitScript P((void));
192 void StartAnalysisClock P((void));
193 void EngineOutputPopUp P((void));
194 void EgineOutputPopDown P((void));
196 void SetHighlights P((int fromX, int fromY, int toX, int toY));
197 void ClearHighlights P((void));
198 void SetPremoveHighlights P((int fromX, int fromY, int toX, int toY));
199 void ClearPremoveHighlights P((void));
201 void AnimateAtomicCapture P((Board board, int fromX, int fromY, int toX, int toY));
202 void ShutDownFrontEnd P((void));
203 void BoardToTop P((void));
204 void AnimateMove P((Board board, int fromX, int fromY, int toX, int toY));
205 void HistorySet P((char movelist[][2*MOVE_LEN], int first, int last, int current));
206 void FreezeUI P((void));
207 void ThawUI P((void));
208 void ChangeDragPiece P((ChessSquare piece));
209 extern char *programName;
210 extern int commentUp;
211 extern char *firstChessProgramNames;
213 void GreyRevert P((Boolean grey));
215 typedef struct FrontEndProgramStats_TAG {
225 } FrontEndProgramStats;
227 void SetProgramStats P(( FrontEndProgramStats * stats )); /* [AS] */
229 void EngineOutputPopUp P((void));
230 void EngineOutputPopDown P((void));
231 int EngineOutputIsUp P((void));
232 int EngineOutputDialogExists P((void));
233 void EvalGraphPopUp P((void));
234 void EvalGraphPopDown P((void));
235 Boolean EvalGraphIsUp P((void));
236 int EvalGraphDialogExists P((void));
238 /* these are in xhistory.c */
239 Boolean MoveHistoryIsUp P((void));
240 void HistoryPopUp P((void));