Galaxies: remove 'solver_recurse_depth' in live use.

It's horrible to have static mutable state in the live puzzle game.
What if some downstream wanted to run the system in multiple threads?

For purposes of limiting the recursion depth, we now pass an 'int depth'
argument to each call to solver_state_inner(). So in the normal build
of the actual puzzle, the static variable isn't needed at all. We only
include it in binaries that are going to want to use it for printing
indented diagnostics: the CLI solver program, and the live puzzle only
if DEBUGGING is defined. The rest of the time, it's absent.

A side effect of this change is that when the recursion code makes a
guess at a particular tile, the message about that is now indented to
the _outer_ level instead of the inner one, because the previous
'depth++' and 'depth--' statements wrapped the whole loop rather than
just the recursive call to the solver inside. This makes recursive
solving much easier to follow!
This commit is contained in:
Simon Tatham
2023-03-12 14:37:36 +00:00
parent 20f95e3e22
commit 51818780f8

View File

@ -86,9 +86,11 @@
#ifdef DEBUGGING
#define solvep debug
#else
#elif defined STANDALONE_SOLVER
static bool solver_show_working;
#define solvep(x) do { if (solver_show_working) { printf x; } } while(0)
#else
#define solvep(x) ((void)0)
#endif
#ifdef STANDALONE_PICTURE_GENERATOR
@ -187,7 +189,7 @@ struct game_state {
};
static bool check_complete(const game_state *state, int *dsf, int *colours);
static int solver_state_inner(game_state *state, int maxdiff);
static int solver_state_inner(game_state *state, int maxdiff, int depth);
static int solver_state(game_state *state, int maxdiff);
static int solver_obvious(game_state *state);
static int solver_obvious_dot(game_state *state, space *dot);
@ -1717,7 +1719,10 @@ static game_state *new_game(midend *me, const game_params *params,
* Solver and all its little wizards.
*/
#if defined DEBUGGING || defined STANDALONE_SOLVER
static int solver_recurse_depth;
#define STATIC_RECURSION_DEPTH
#endif
typedef struct solver_ctx {
game_state *state;
@ -2394,13 +2399,13 @@ static int solver_recurse_cb(game_state *state, space *tile, void *ctx)
#define MAXRECURSE 5
static int solver_recurse(game_state *state, int maxdiff)
static int solver_recurse(game_state *state, int maxdiff, int depth)
{
int diff = DIFF_IMPOSSIBLE, ret, n, gsz = state->sx * state->sy;
space *ingrid, *outgrid = NULL, *bestopp;
struct recurse_ctx rctx;
if (solver_recurse_depth >= MAXRECURSE) {
if (depth >= MAXRECURSE) {
solvep(("Limiting recursion to %d, returning.\n", MAXRECURSE));
return DIFF_UNFINISHED;
}
@ -2419,8 +2424,6 @@ static int solver_recurse(game_state *state, int maxdiff)
solver_recurse_depth*4, "",
rctx.best->x, rctx.best->y, rctx.bestn));
solver_recurse_depth++;
ingrid = snewn(gsz, space);
memcpy(ingrid, state->grid, gsz * sizeof(space));
@ -2434,7 +2437,11 @@ static int solver_recurse(game_state *state, int maxdiff)
state->dots[n]->x, state->dots[n]->y,
"Attempting for recursion");
ret = solver_state_inner(state, maxdiff);
ret = solver_state_inner(state, maxdiff, depth + 1);
#ifdef STATIC_RECURSION_DEPTH
solver_recurse_depth = depth; /* restore after recursion returns */
#endif
if (diff == DIFF_IMPOSSIBLE && ret != DIFF_IMPOSSIBLE) {
/* we found our first solved grid; copy it away. */
@ -2466,8 +2473,6 @@ static int solver_recurse(game_state *state, int maxdiff)
break;
}
solver_recurse_depth--;
if (outgrid) {
/* we found (at least one) soln; copy it back to state */
memcpy(state->grid, outgrid, gsz * sizeof(space));
@ -2477,7 +2482,7 @@ static int solver_recurse(game_state *state, int maxdiff)
return diff;
}
static int solver_state_inner(game_state *state, int maxdiff)
static int solver_state_inner(game_state *state, int maxdiff, int depth)
{
solver_ctx *sctx = new_solver(state);
int ret, diff = DIFF_NORMAL;
@ -2489,6 +2494,10 @@ static int solver_state_inner(game_state *state, int maxdiff)
picture = NULL;
#endif
#ifdef STATIC_RECURSION_DEPTH
solver_recurse_depth = depth;
#endif
ret = solver_obvious(state);
if (ret < 0) {
diff = DIFF_IMPOSSIBLE;
@ -2528,7 +2537,7 @@ cont:
if (check_complete(state, NULL, NULL)) goto got_result;
diff = (maxdiff >= DIFF_UNREASONABLE) ?
solver_recurse(state, maxdiff) : DIFF_UNFINISHED;
solver_recurse(state, maxdiff, depth) : DIFF_UNFINISHED;
got_result:
free_solver(sctx);
@ -2546,8 +2555,7 @@ got_result:
static int solver_state(game_state *state, int maxdiff)
{
solver_recurse_depth = 0;
return solver_state_inner(state, maxdiff);
return solver_state_inner(state, maxdiff, 0);
}
#ifndef EDITOR