881746789a
This brings puzzles up-to-date with upstream revision 2d333750272c3967cfd5cd3677572cddeaad5932, though certain changes made by me, including cursor-only Untangle and some compilation fixes remain. Upstream code has been moved to its separate subdirectory and future syncs can be done by simply copying over the new sources. Change-Id: Ia6506ca5f78c3627165ea6791d38db414ace0804
35 lines
1.2 KiB
C
35 lines
1.2 KiB
C
/*
|
|
* loopgen.h: interface file for loop generation functions for grid.[ch].
|
|
*/
|
|
|
|
#ifndef _LOOPGEN_H
|
|
#define _LOOPGEN_H
|
|
|
|
#include "puzzles.h"
|
|
#include "grid.h"
|
|
|
|
enum face_colour { FACE_WHITE, FACE_GREY, FACE_BLACK };
|
|
|
|
/* face should be of type grid_face* here. */
|
|
#define FACE_COLOUR(face) \
|
|
( (face) == NULL ? FACE_BLACK : \
|
|
board[(face) - g->faces] )
|
|
|
|
typedef int (*loopgen_bias_fn_t)(void *ctx, char *board, int face);
|
|
|
|
/* 'board' should be a char array whose length is the same as
|
|
* g->num_faces: this will be filled in with FACE_WHITE or FACE_BLACK
|
|
* after loop generation.
|
|
*
|
|
* If 'bias' is non-null, it should be a user-provided function which
|
|
* rates a half-finished board (i.e. may include some FACE_GREYs) for
|
|
* desirability; this will cause the loop generator to bias in favour
|
|
* of loops with a high return value from that function. The 'face'
|
|
* parameter to the bias function indicates which face of the grid has
|
|
* been modified since the last call; it is guaranteed that only one
|
|
* will have been (so that bias functions can work incrementally
|
|
* rather than re-scanning the whole grid on every call). */
|
|
extern void generate_loop(grid *g, char *board, random_state *rs,
|
|
loopgen_bias_fn_t bias, void *biasctx);
|
|
|
|
#endif
|