summaryrefslogtreecommitdiff
path: root/README
blob: 694f914e2849b2a5f343b41306ab888f17751709 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
Sudoku: A plug-in for the Video Disk Recorder
---------------------------------------------

Copyright (C) 2005-2007, Thomas Günther <tom@toms-cafe.de>

Project's homepage: http://toms-cafe.de/vdr/sudoku

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License along
with this program; if not, write to the Free Software Foundation, Inc.,
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.

See the file COPYING for the full license information.


Requirements:
-------------

- VDR >= 1.3.47


Description:
------------

'Sudoku' is a VDR plug-in to generate and solve Number Place puzzles, so called
Sudokus.

A Sudoku puzzle consists of 9 x 9 cells subdivided into 9 regions with 3 x 3
cells. The rules are simple. There have to be the numbers from 1 to 9 in every
row, column and region. In the beginning some numbers are given. These cells are
painted with cyan background color. The aim of the puzzle is to find the missing
numbers. There is only one solution of a Sudoku puzzle.

The Sudoku puzzles are generated on-the-fly. The number of givens can be set in
the plug-in's setup page down to a minimum of 26 givens. The generation of
puzzles with less than 26 givens takes too long. By default the cells with
givens are symmetrically ordered. But this can be disabled in the setup.

To solve difficult Sudoku puzzles some hints can be used. Incorrect cells are
red and cells with ambiguous numbers are magenta. These hints can be disabled in
the setup. With the green key a cell can be marked. A marked cell has green
background color. With the yellow key the cursor is moved to the next free cell
with minimal possible numbers. The red key set the next possible number for the
current cell.

Each time the plug-in is started from the main menu the same puzzle is shown. A
new puzzle is only generated on VDR startup or if it has been requested by
pressing the blue key. This key has two functions. If no numbers are set a new
puzzle is generated. Otherwise all numbers are reset so that only the givens are
shown.


Setup:
------

- Givens count            Givens count of the generated puzzles (26-81).
                          Default is 36.
- Symmetric givens        Cells with givens are symmetrically ordered (yes/no).
                          Default is yes.
- Mark errors             Incorrect cells are marked with red color (yes/no).
                          Default is yes.
- Mark ambiguous numbers  Cells with ambiguous numbers are marked with magenta
                          color (yes/no).
                          Default is yes.
- Clear marks on reset    Unmark all cells when the puzzle is reset (yes/no).
                          Default is no.
- Transparency (%)        Set the transparency of the menu (0-100).
                          Default is 50.


Keys:
-----

- Left/Right/Up/Down      Move the cursor in the puzzle.
- 1-9                     Set the number in the current cell.
- 0                       Remove the number from the current cell.
- Green                   Mark/unmark the current cell.
- Yellow                  Move the cursor to the next free cell with minimal
                          possible numbers.
- Red                     Set the next possible number for the current cell -
                          reset the number if greater numbers are not possible.
- Blue                    Reset the puzzle (if some numbers set).
                          Start a new puzzle (if no numbers set).
- Back                    Quit the plug-in.


Cell colors:
------------

- Cyan                    Givens
- Green                   Marked cells
- Red                     Incorrect cells
- Magenta                 Ambiguous numbers