X-Git-Url: https://git.distorted.org.uk/~mdw/sgt/puzzles/blobdiff_plain/0fe46bd5c639d1fe8f8689057100a216c5c53c23..854a4f51614eb4a6a23e15204d30d1e57ef83c6f:/devel.but diff --git a/devel.but b/devel.but index 3695bcd..096aa12 100644 --- a/devel.but +++ b/devel.but @@ -1456,6 +1456,26 @@ mid-end doesn't even bother calling \cw{anim_length()} each game. On the rare occasion that animated solve moves are actually required, you can set this flag. +\dt \cw{REQUIRE_RBUTTON} + +\dd This flag indicates that the puzzle cannot be usefully played +without the use of mouse buttons other than the left one. On some +PDA platforms, this flag is used by the front end to enable +right-button emulation through an appropriate gesture. Note that a +puzzle is not required to set this just because it \e{uses} the +right button, but only if its use of the right button is critical to +playing the game. (Slant, for example, uses the right button to +cycle through the three square states in the opposite order from the +left button, and hence can manage fine without it.) + +\dt \cw{REQUIRE_NUMPAD} + +\dd This flag indicates that the puzzle cannot be usefully played +without the use of number-key input. On some PDA platforms it causes +an emulated number pad to appear on the screen. Similarly to +\cw{REQUIRE_RBUTTON}, a puzzle need not specify this simply if its +use of the number keys is not critical. + \H{backend-initiative} Things a back end may do on its own initiative This section describes a couple of things that a back end may choose @@ -2122,7 +2142,7 @@ function; see \k{drawing-draw-circle}. \c void (*draw_update)(void *handle, int x, int y, int w, int h); This function behaves exactly like the back end \cw{draw_update()} -function; see \k{drawing-draw-text}. +function; see \k{drawing-draw-update}. An implementation of this API which only supports printing is permitted to define this function pointer to be \cw{NULL} rather