The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

enter_presets - enter the initial values of a Sudoku puzzle.

VERSION

This documentation refers to enter_presets version 0.01.2

USAGE

This program is called internally by SudokuTrainer when the user selects the option Enter manually to create the initial puzzle.

DESCRIPTION

enter_presets initially displays an empty Sudoku board. Values may be entered via the mouse or via the keyboard.

Input via the mouse

When the mouse cursor enters a cell of the board, this cell gets covered by a 3x3 grid of tiny squares. Each square corresponds to one of the digits 1 to 9. If the cell already contains a value, the corresponding square is shown in red.

Clicking on one of the black squares inserts the corresponding digit as the value of the cell. So you can select a cell and a digit with a single mouse click (I am very proud on this invention). Any previous value of the cell will be replaced. Clicking on the red square will remove the corresponding value from the cell.

Input via the keyboard

The input focus may be moved to an adjacent cell by the arrow keys (end around). A value may be entered in the active cell by the keys 1 to 9 (on the alpha or numeric keypad). This will replace any previous value in the cell. A value may be deleted by the keys 0, Delete, or the Space bar.

Pressing any of the supported keys will also hide the 3x3 grid.

EDIT AN EXISTING PUZZLE

You may use enter_presets to edit an existing puzzle, e. g. to correct an error. While the board is empty, click the Edit puzzle button and select the puzzle.

TERMINATING THE PROGRAM

enter_presets may be terminated by activation of the Done button or by the Cancel button. In the latter case no output is generated.

MANUAL INVOCATION

If you like to play Sudoku on a board that is as intelligent as a sheet of paper, enter_presets is a nice choice. Invoke it by entering

    perl path/to/enter_presets.pl > mypuzzle.sudo

on the command line. The output file may be used as the initial puzzle of the trainer.

SEE ALSO

The dokumentation for SudokuTrainer (use "perldoc sudokutrainer.pl").

DEPENDENCIES

BUGS

Please report any bugs or feature requests to bug-SudokuTrainer [at] rt.cpan.org, or through the web interface at https://rt.cpan.org/Public/Bug/Report.html?Queue=SudokuTrainer.

Patches are welcome.

AUTHOR

Klaus Wittrock (Wittrock [at] cpan.org)

LICENCE AND COPYRIGHT

Copyright 2014 Klaus Wittrock. All Rights Reserved.

This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself.