/* WordSearch.h
Copyright (C) 2026 Pierre Sarrazin
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 3 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, see .
*/
#ifndef _H_WordSearch
#define _H_WordSearch
#include
typedef struct WordSearch
{
byte *rack;
BOOL allInRack;
byte difficultyLevel; // LEVEL_* value; only used for computer's search
size_t numWordsProcessed;
char foundWord[MAX_WORD_LEN + 1]; // NUL-terminated string of letters (no blanks)
// If a blank tile was used for foundWord[i], then letterTileTypeBehindBlank[i] is 1..26,
// to indicate which letter the blank represents. Otherwise, it is TILE_TYPE_NONE.
byte letterTileTypeBehindBlank[MAX_WORD_LEN];
byte foundWordRow;
byte foundWordCol;
BOOL foundWordHorizontal;
const struct GameState *gameState;
} WordSearch;
void WordSearch_init(WordSearch *ws,
byte *rack,
BOOL allInRack,
byte difficultyLevel,
const struct GameState *gs);
void WordSearch_initWordWalk(const WordSearch *ws,
byte *row,
byte *col,
byte *rowInc,
byte *colInc,
const char **wordToPlace,
byte *wordLen);
// Must be called before placing the word on the board.
//
word WordSearch_countPointsFromWordsPlayed(const WordSearch *ws,
const struct GameState *gs);
#endif /* _H_WordSearch */