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.sudoon 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
http://search.cpan.org/perldoc?Tk (Perl/Tk)
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.