mirror of
git://xwords.git.sourceforge.net/gitroot/xwords/xwords
synced 2024-12-29 10:26:36 +01:00
8d228ae190
to enable it for a game yet). In common code, break pick tile utils method in two, one for blank and the other for tray tiles. In java, implement dialog for picking the tiles. Works, though is a bit clumsy to have the dialog come and go after every pick. Better would be a dialog that stays up and accumulates picks -- but it'd have to know to reduce the set of tile choices as letters are chosen. This'll do for now.
311 lines
10 KiB
C
311 lines
10 KiB
C
/* -*-mode: C; fill-column: 78; c-basic-offset: 4; -*- */
|
|
/*
|
|
* Copyright 1997 - 2010 by Eric House (xwords@eehouse.org). All rights
|
|
* reserved.
|
|
*
|
|
* 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., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
|
|
*/
|
|
|
|
#ifndef _UTIL_H_
|
|
#define _UTIL_H_
|
|
|
|
#include "comtypes.h"
|
|
|
|
#include "dawg.h"
|
|
#include "model.h"
|
|
#include "board.h"
|
|
#include "mempool.h"
|
|
#include "vtabmgr.h"
|
|
#include "comms.h"
|
|
|
|
#include "xwrelay.h"
|
|
|
|
#define LETTER_NONE '\0'
|
|
|
|
typedef enum {
|
|
ERR_NONE, /* 0 is special case */
|
|
ERR_TILES_NOT_IN_LINE, /* scoring a move where tiles aren't in line */
|
|
ERR_NO_EMPTIES_IN_TURN,
|
|
ERR_TWO_TILES_FIRST_MOVE,
|
|
ERR_TILES_MUST_CONTACT,
|
|
/* ERR_NO_HINT_MID_TURN, */
|
|
ERR_TOO_FEW_TILES_LEFT_TO_TRADE,
|
|
ERR_NOT_YOUR_TURN,
|
|
ERR_NO_PEEK_ROBOT_TILES,
|
|
#ifndef XWFEATURE_STANDALONE_ONLY
|
|
ERR_SERVER_DICT_WINS,
|
|
ERR_NO_PEEK_REMOTE_TILES,
|
|
ERR_REG_UNEXPECTED_USER, /* server asked to register too many remote
|
|
users */
|
|
ERR_REG_SERVER_SANS_REMOTE,
|
|
STR_NEED_BT_HOST_ADDR,
|
|
#endif
|
|
ERR_NO_EMPTY_TRADE,
|
|
/* ERR_CANT_ENGINE_MID_MOVE, */
|
|
/* ERR_NOT_YOUR_TURN_TO_TRADE, */
|
|
/* ERR_NOT_YOUR_TURN_TO_MOVE, */
|
|
ERR_CANT_UNDO_TILEASSIGN,
|
|
ERR_CANT_HINT_WHILE_DISABLED,
|
|
|
|
ERR_RELAY_BASE,
|
|
ERR_RELAY_END = ERR_RELAY_BASE + XWRELAY_ERROR_LASTERR
|
|
} UtilErrID;
|
|
|
|
typedef enum {
|
|
QUERY_COMMIT_TURN, /* 0 means cancel; 1 means commit */
|
|
QUERY_ROBOT_TRADE,
|
|
|
|
QUERY_LAST_COMMON
|
|
} UtilQueryID;
|
|
|
|
#define PICKER_PICKALL -1
|
|
#define PICKER_BACKUP -2
|
|
|
|
typedef struct PickInfo {
|
|
const XP_UCHAR** curTiles;
|
|
XP_U16 nCurTiles;
|
|
XP_U16 nTotal; /* count to fetch for turn, <= MAX_TRAY_TILES */
|
|
XP_U16 thisPick; /* <= nTotal */
|
|
} PickInfo;
|
|
|
|
typedef struct BadWordInfo {
|
|
XP_U16 nWords;
|
|
const XP_UCHAR* words[MAX_TRAY_TILES+1]; /* can form in both directions */
|
|
} BadWordInfo;
|
|
|
|
/* XWTimerProc returns true if redraw was necessitated by what the proc did */
|
|
typedef XP_Bool (*XWTimerProc)( void* closure, XWTimerReason why );
|
|
|
|
/* Platform-specific utility functions that need to be
|
|
*/
|
|
typedef struct UtilVtable {
|
|
|
|
VTableMgr* (*m_util_getVTManager)(XW_UtilCtxt* uc);
|
|
|
|
#ifndef XWFEATURE_STANDALONE_ONLY
|
|
XWStreamCtxt* (*m_util_makeStreamFromAddr )(XW_UtilCtxt* uc,
|
|
XP_PlayerAddr channelNo );
|
|
#endif
|
|
|
|
XWBonusType (*m_util_getSquareBonus)( XW_UtilCtxt* uc,
|
|
const ModelCtxt* model,
|
|
XP_U16 col, XP_U16 row );
|
|
void (*m_util_userError)( XW_UtilCtxt* uc, UtilErrID id );
|
|
|
|
XP_Bool (*m_util_userQuery)( XW_UtilCtxt* uc, UtilQueryID id,
|
|
XWStreamCtxt* stream );
|
|
XP_Bool (*m_util_confirmTrade)( XW_UtilCtxt* uc, const XP_UCHAR** tiles,
|
|
XP_U16 nTiles );
|
|
/* return of < 0 means computer should pick */
|
|
XP_S16 (*m_util_userPickTileBlank)( XW_UtilCtxt* uc, XP_U16 playerNum,
|
|
const XP_UCHAR** tileFaces,
|
|
XP_U16 nTiles );
|
|
XP_S16 (*m_util_userPickTileTray)( XW_UtilCtxt* uc, const PickInfo* pi,
|
|
XP_U16 playerNum,
|
|
const XP_UCHAR** texts, XP_U16 nTiles );
|
|
|
|
XP_Bool (*m_util_askPassword)( XW_UtilCtxt* uc, const XP_UCHAR* name,
|
|
XP_UCHAR* buf, XP_U16* len );
|
|
|
|
void (*m_util_trayHiddenChange)(XW_UtilCtxt* uc,
|
|
XW_TrayVisState newState,
|
|
XP_U16 nVisibleRows );
|
|
void (*m_util_yOffsetChange)(XW_UtilCtxt* uc, XP_U16 maxOffset,
|
|
XP_U16 oldOffset, XP_U16 newOffset );
|
|
#ifdef XWFEATURE_TURNCHANGENOTIFY
|
|
void (*m_util_turnChanged)(XW_UtilCtxt* uc);
|
|
#endif
|
|
void (*m_util_informMove)( XW_UtilCtxt* uc, XWStreamCtxt* expl,
|
|
XWStreamCtxt* words );
|
|
void (*m_util_notifyGameOver)( XW_UtilCtxt* uc );
|
|
|
|
XP_Bool (*m_util_hiliteCell)( XW_UtilCtxt* uc, XP_U16 col, XP_U16 row );
|
|
|
|
XP_Bool (*m_util_engineProgressCallback)( XW_UtilCtxt* uc );
|
|
|
|
void (*m_util_setTimer)( XW_UtilCtxt* uc, XWTimerReason why, XP_U16 when,
|
|
XWTimerProc proc, void* closure );
|
|
void (*m_util_clearTimer)( XW_UtilCtxt* uc, XWTimerReason why );
|
|
|
|
void (*m_util_requestTime)( XW_UtilCtxt* uc );
|
|
|
|
XP_Bool (*m_util_altKeyDown)( XW_UtilCtxt* uc );
|
|
|
|
XP_U32 (*m_util_getCurSeconds)( XW_UtilCtxt* uc );
|
|
|
|
DictionaryCtxt* (*m_util_makeEmptyDict)( XW_UtilCtxt* uc );
|
|
|
|
const XP_UCHAR* (*m_util_getUserString)( XW_UtilCtxt* uc,
|
|
XP_U16 stringCode );
|
|
|
|
XP_Bool (*m_util_warnIllegalWord)( XW_UtilCtxt* uc, BadWordInfo* bwi,
|
|
XP_U16 turn, XP_Bool turnLost );
|
|
|
|
void (*m_util_remSelected)(XW_UtilCtxt* uc);
|
|
|
|
#ifndef XWFEATURE_MINIWIN
|
|
void (*m_util_bonusSquareHeld)( XW_UtilCtxt* uc, XWBonusType bonus );
|
|
void (*m_util_playerScoreHeld)( XW_UtilCtxt* uc, XP_U16 player );
|
|
#endif
|
|
#ifdef XWFEATURE_BOARDWORDS
|
|
void (*m_util_cellSquareHeld)( XW_UtilCtxt* uc, XWStreamCtxt* words );
|
|
#endif
|
|
|
|
#ifndef XWFEATURE_STANDALONE_ONLY
|
|
void (*m_util_addrChange)( XW_UtilCtxt* uc, const CommsAddrRec* oldAddr,
|
|
const CommsAddrRec* newAddr );
|
|
void (*m_util_setIsServer)(XW_UtilCtxt* uc, XP_Bool isServer );
|
|
#endif
|
|
|
|
#ifdef XWFEATURE_SEARCHLIMIT
|
|
XP_Bool (*m_util_getTraySearchLimits)(XW_UtilCtxt* uc,
|
|
XP_U16* min, XP_U16* max );
|
|
#endif
|
|
|
|
#ifdef XWFEATURE_CHAT
|
|
void (*m_util_showChat)( XW_UtilCtxt* uc, const XP_UCHAR* const msg );
|
|
#endif
|
|
|
|
#ifdef SHOW_PROGRESS
|
|
void (*m_util_engineStarting)( XW_UtilCtxt* uc, XP_U16 nBlanks );
|
|
void (*m_util_engineStopping)( XW_UtilCtxt* uc );
|
|
#endif
|
|
|
|
} UtilVtable;
|
|
|
|
|
|
struct XW_UtilCtxt {
|
|
UtilVtable* vtable;
|
|
|
|
struct CurGameInfo* gameInfo;
|
|
|
|
void* closure;
|
|
MPSLOT
|
|
};
|
|
|
|
#define util_getVTManager(uc) \
|
|
(uc)->vtable->m_util_getVTManager((uc))
|
|
|
|
#define util_makeStreamFromAddr(uc,a) \
|
|
(uc)->vtable->m_util_makeStreamFromAddr((uc),(a))
|
|
|
|
#define util_getSquareBonus(uc,m,c,r) \
|
|
(uc)->vtable->m_util_getSquareBonus((uc),(m),(c),(r))
|
|
|
|
#define util_userError(uc,err) \
|
|
(uc)->vtable->m_util_userError((uc),(err))
|
|
|
|
#define util_userQuery(uc,qcode,str) \
|
|
(uc)->vtable->m_util_userQuery((uc),(qcode),(str))
|
|
|
|
#define util_confirmTrade( uc, tx, nt ) \
|
|
(uc)->vtable->m_util_confirmTrade((uc),(tx),(nt))
|
|
|
|
#define util_userPickTileBlank( uc, n, tx, nt ) \
|
|
(uc)->vtable->m_util_userPickTileBlank( (uc), (n), (tx), (nt) )
|
|
#define util_userPickTileTray( uc, w, n, tx, nt ) \
|
|
(uc)->vtable->m_util_userPickTileTray( (uc), (w), (n), (tx), (nt) )
|
|
#define util_askPassword( uc, n, b, lp ) \
|
|
(uc)->vtable->m_util_askPassword( (uc), (n), (b), (lp) )
|
|
|
|
#define util_trayHiddenChange( uc, b, n ) \
|
|
(uc)->vtable->m_util_trayHiddenChange((uc), (b), (n))
|
|
|
|
#define util_yOffsetChange( uc, m, o, n ) \
|
|
(uc)->vtable->m_util_yOffsetChange((uc), (m), (o), (n) )
|
|
|
|
#ifdef XWFEATURE_TURNCHANGENOTIFY
|
|
# define util_turnChanged( uc ) \
|
|
(uc)->vtable->m_util_turnChanged((uc) )
|
|
#else
|
|
# define util_turnChanged( uc )
|
|
#endif
|
|
|
|
#define util_informMove(uc,e,w) \
|
|
(uc)->vtable->m_util_informMove( (uc),(e),(w))
|
|
#define util_notifyGameOver( uc ) \
|
|
(uc)->vtable->m_util_notifyGameOver((uc))
|
|
|
|
#define util_hiliteCell( uc, c, r ) \
|
|
(uc)->vtable->m_util_hiliteCell((uc), (c), (r))
|
|
|
|
#define util_engineProgressCallback( uc ) \
|
|
(uc)->vtable->m_util_engineProgressCallback((uc))
|
|
|
|
#define util_setTimer( uc, why, when, proc, clos ) \
|
|
(uc)->vtable->m_util_setTimer((uc),(why),(when),(proc),(clos))
|
|
#define util_clearTimer( uc, why ) \
|
|
(uc)->vtable->m_util_clearTimer((uc),(why))
|
|
|
|
#define util_requestTime( uc ) \
|
|
(uc)->vtable->m_util_requestTime((uc))
|
|
|
|
#define util_altKeyDown( uc ) \
|
|
(uc)->vtable->m_util_altKeyDown((uc))
|
|
|
|
#define util_getCurSeconds(uc) \
|
|
(uc)->vtable->m_util_getCurSeconds((uc))
|
|
|
|
#define util_makeEmptyDict( uc ) \
|
|
(uc)->vtable->m_util_makeEmptyDict((uc))
|
|
|
|
#define util_getUserString( uc, c ) \
|
|
(uc)->vtable->m_util_getUserString((uc),(c))
|
|
|
|
#define util_warnIllegalWord( uc, w, p, b ) \
|
|
(uc)->vtable->m_util_warnIllegalWord((uc),(w),(p),(b))
|
|
|
|
#define util_remSelected( uc ) \
|
|
(uc)->vtable->m_util_remSelected((uc))
|
|
|
|
#ifndef XWFEATURE_MINIWIN
|
|
# define util_bonusSquareHeld( uc, b ) \
|
|
(uc)->vtable->m_util_bonusSquareHeld( (uc), (b) )
|
|
# define util_playerScoreHeld( uc, player ) \
|
|
(uc)->vtable->m_util_playerScoreHeld( (uc), (player) )
|
|
#endif
|
|
#ifdef XWFEATURE_BOARDWORDS
|
|
#define util_cellSquareHeld(uc, s) \
|
|
(uc)->vtable->m_util_cellSquareHeld( (uc), (s) )
|
|
#endif
|
|
#ifndef XWFEATURE_STANDALONE_ONLY
|
|
# define util_addrChange( uc, addro, addrn ) \
|
|
(uc)->vtable->m_util_addrChange((uc), (addro), (addrn))
|
|
# define util_setIsServer( uc, is ) \
|
|
(uc)->vtable->m_util_setIsServer((uc), (is))
|
|
# else
|
|
# define util_addrChange( uc, addro, addrn )
|
|
#endif
|
|
|
|
#ifdef XWFEATURE_SEARCHLIMIT
|
|
#define util_getTraySearchLimits(uc,min,max) \
|
|
(uc)->vtable->m_util_getTraySearchLimits((uc), (min), (max))
|
|
#endif
|
|
|
|
#ifdef XWFEATURE_CHAT
|
|
# define util_showChat( uc, m ) (uc)->vtable->m_util_showChat((uc),(m))
|
|
#endif
|
|
|
|
# ifdef SHOW_PROGRESS
|
|
# define util_engineStarting( uc, nb ) \
|
|
(uc)->vtable->m_util_engineStarting((uc),(nb))
|
|
# define util_engineStopping( uc ) \
|
|
(uc)->vtable->m_util_engineStopping((uc))
|
|
# else
|
|
# define util_engineStarting( uc, nb )
|
|
# define util_engineStopping( uc )
|
|
# endif
|
|
|
|
#endif
|