2909
2909
\dd Size of grid in squares.
2913
\cfg{winhelp-topic}{games.pearl}
2915
You have a grid of squares. Your job is to draw lines between the
2916
centres of horizontally or vertically adjacent squares, so that the
2917
lines form a single closed loop. In the resulting grid, some of the
2918
squares that the loop passes through will contain corners, and some
2919
will be straight horizontal or vertical lines. (And some squares can
2920
be completely empty \dash the loop doesn't have to pass through every
2923
Some of the squares contain black and white circles, which are clues
2924
that the loop must satisfy.
2926
A black circle in a square indicates that that square is a corner, but
2927
neither of the squares adjacent to it in the loop is also a corner.
2929
A white circle indicates that the square is a straight edge, but \e{at
2930
least one} of the squares adjacent to it in the loop is a corner.
2932
(In both cases, the clue only constrains the two squares adjacent
2933
\e{in the loop}, that is, the squares that the loop passes into after
2934
leaving the clue square. The squares that are only adjacent \e{in the
2935
grid} are not constrained.)
2937
Credit for this puzzle goes to \i{Nikoli}, who call it \q{Masyu}.
2940
Thanks to James Harvey for assistance with the implementation.
2943
\W{http://www.nikoli.co.jp/en/puzzles/masyu/}\cw{http://www.nikoli.co.jp/en/puzzles/masyu/}
2945
\H{pearl-controls} \I{controls, for Pearl}Pearl controls
2947
Click with the left button on a grid edge to draw a segment of the
2948
loop through that edge, or to remove a segment once it is drawn.
2950
Drag with the left button through a series of squares to draw more
2951
than one segment of the loop in one go. Alternatively, drag over an
2952
existing part of the loop to undraw it, or to undraw part of it and
2953
then go in a different direction.
2955
Click with the right button on a grid edge to mark it with a cross,
2956
indicating that you are sure the loop does not go through that edge.
2957
(For instance, if you have decided which of the squares adjacent to a
2958
white clue has to be a corner, but don't yet know which way the corner
2959
turns, you might mark the one way it \e{can't} go with a cross.)
2961
Alternatively, use the cursor keys to move the cursor. Use the Enter
2962
key to begin and end keyboard `drag' operations. Use the Space key to
2963
cancel the drag. Use Ctrl-arrowkey and Shift-arrowkey to simulate a
2964
left or right click, respectively, on the edge in the given direction
2965
relative to the cursor, i.e. to draw a segment or a cross.
2967
(All the actions described in \k{common-actions} are also available.)
2969
\H{pearl-parameters} \I{parameters, for Pearl}Pearl parameters
2971
These parameters are available from the \q{Custom...} option on the
2974
\dt \e{Width}, \e{Height}
2976
\dd Size of grid in squares.
2980
\dd Controls the difficulty of the generated puzzle.
2911
2982
\A{licence} \I{MIT licence}\ii{Licence}
2913
This software is \i{copyright} 2004-2010 Simon Tatham.
2984
This software is \i{copyright} 2004-2012 Simon Tatham.
2915
2986
Portions copyright Richard Boulton, James Harvey, Mike Pinna, Jonas
2916
2987
K\u00F6{oe}lker, Dariusz Olszewski, Michael Schierl, Lambros