English VDR

'Sudoku'-Plug-in für den VDR

Kaffeekasse Toms Café
'Sudoku'-Screenshot

'Sudoku' ist ein Plug-in für Klaus Schmidingers phantastischen Video Disk Recorder (VDR).

Entwicklungs-Seite: projects.vdr-developer.org

Neueste Version für VDR >= 1.6.0:

Ältere Versionen im Logbuch.

© 2005-2010, Thomas Günther
Dies ist freie Software, die unter den Bedingungen der GNU GPL, Version 2 oder jeder späteren Version, verwendet und weitergegeben werden darf.


   Beschreibung

'Sudoku' ist ein VDR-Plug-in zum Erzeugen und Lösen von Zahlenpuzzles, so genannten Sudokus.

Ein Sudoku-Puzzle besteht aus 9 x 9 Zellen, die in 9 Regionen mit 3 x 3 Zellen unterteilt sind. Die Regeln sind einfach. In jeder Zeile, Spalte und Region müssen die Zahlen 1 bis 9 vorhanden sein. Einige Zahlen sind am Anfang vorgegeben. Diese Zellen werden türkis hinterlegt. Das Ziel des Puzzles ist, die fehlenden Zahlen zu finden. Es gibt nur eine Lösung für ein Sudoku-Puzzle.

Die Sudoku-Puzzles werden 'on-the-fly' erzeugt. Die Anzahl der vorgegebenen Zahlen kann in den Einstellungen des Plug-ins gewählt werden - bis zu einem Minimum von 26. Das Erzeugen von Puzzles mit weniger als 26 vorgegebenen Zahlen dauert zu lange. Standardmäßig sind die Zellen mit vorgegebenen Zahlen symmetrisch angeordnet. Aber auch das kann in den Einstellungen geändert werden.

Zum Lösen von schwierigen Sudokus gibt es ein paar Hilfen. Fehlerhafte Zellen sind rot und Zellen mit unklaren Zahlen magenta. Diese Hilfen können in den Einstellungen abgeschaltet werden. Für weitere Hilfen siehe das Befehlsmenü, das mit der blauen Taste geöffnet wird.

Bei jedem Start des Plug-ins vom Hauptmenü aus wird das gleiche Puzzle angezeigt. Ein neues Puzzle wird nur erzeugt, wenn der VDR gestartet wird oder wenn der entsprechende Befehl im Befehlsmenü ausgewählt wird.

Im Befehlsmenü kann man Puzzles laden oder speichern aus/in die Datei sudoku-list. Diese Datei befindet sich im Verzeichnis plugins innerhalb des Konfigurationsverzeichnisses des VDR. Wenn das Konfigurationsverzeichnis nicht explizit festgelegt ist, wird das Video-Verzeichnis verwendet (z.B. /video0/plugins/sudoku/sudoku-list).

Die Datei sudoku-list enthält Zeilen mit einem Sudoku-Dump und einer optionalen Beschreibung. Der Sudoku-Dump muss an der ersten Position der Zeile beginnen. Das Trennzeichen zwischen Sudoku-Dump und Beschreibung ist ein Leerzeichen. Alles nach dem ersten Leerzeichen wird als Beschreibung betrachtet.

Ein Sudoku-Dump besteht aus bis zu drei Teilen. Der erste Teil enthält nur die vorgegebenen Zahlen, der zweite Teil alle bisher gesetzten Zahlen (einschließlich der vorgegebenen) und der dritte Teil die markierten Zellen. Die Teile sind durch einen Doppelpunkt voneinander getrennt. Alles außer dem ersten Teil ist optional. Die Teile sind Zeichenketten mit 81 Ziffern oder Unterstrichen. Ein Unterstrich wird als Null interpretiert. Alle anderen Zeichen, mit Ausnahme von Doppelpunkten und Leerzeichen, die die Zeichenkette beenden, werden ignoriert. Sie können verwendet werden, um den Dump zu strukturieren, z.B. Pluszeichen jeweils nach 9 Ziffern/Unterstrichen.

   Einstellungen


Parameter Werte Standard Beschreibung
Anzahl vorgegebener Zahlen 26-81 36 Die Anzahl vorgegebener Zahlen der erzeugten Puzzles.
Vorgegebene Zahlen symmetrisch anordnen ja/nein ja Die Zellen mit vorgegebenen Zahlen werden symmetrisch angeordnet.
Fehler markieren ja/nein ja Fehlerhafte Zellen werden rot markiert.
Unklare Zahlen markieren ja/nein ja Zellen mit unklaren Zahlen werden magenta markiert.
Mögliche Zahlen als Muster anzeigen ja/nein nein In allen leeren Zellen wird ein Muster angezeigt, das die möglichen Zahlen repräsentiert. Das Muster ist strukturiert als kleines 3 x 3 Raster, deren Teile von oben links nach unten rechts den Zahlen von 1 bis 9 entsprechen. Wenn eine Zahl in einer Zelle möglich ist, dann wird der Hintergrund des entsprechenden Rasterteils eingefärbt.
Mögliche Zahlen als Ziffern anzeigen ja/nein nein In allen leeren Zellen werden Ziffern angezeigt, die die möglichen Zahlen repräsentieren.
Markierungen löschen beim Reset ja/nein nein Beim Zurücksetzen des Puzzles in den Ausgangszustand werden alle Markierungen gelöscht.
Taste Rot siehe Befehlsmenü Markierung setzen/löschen Befehl für die rote Taste auswählen.
Taste Grün siehe Befehlsmenü Letzte Aktion zurücknehmen Befehl für die grüne Taste auswählen.
Taste Gelb siehe Befehlsmenü Letzte Aktion wiederholen Befehl für die gelbe Taste auswählen.
Große Schriftart alle installierten Schriftarten Sans Serif:Bold Schriftart für die großen Zahlen auswählen.
Große Schrifthöhe (pixel) 10-64 31 Schrifthöhe für die großen Zahlen.
Große Schriftbreite (pixel) 10-64 42 Schriftbreite für die großen Zahlen.
Kleine Schriftart alle installierten Schriftarten Sans Serif:Bold Schriftart für die kleinen Zahlen auswählen.
Kleine Schrifthöhe (pixel) 10-64 10 Schrifthöhe für die kleinen Zahlen.
Kleine Schriftbreite (pixel) 10-64 14 Schriftbreite für die kleinen Zahlen.
Transparenz (%) 0-100 50 Einstellung der Transparenz des Menüs.

   Tasten


Taste Beschreibung
Links/Rechts/Hoch/Runter Cursor im Puzzle bewegen.
1-9 Die Zahl in der aktuellen Zelle setzen.
0 Die Zahl in der aktuellen Zelle löschen.
Rot Der roten Taste zugeordneten Befehl ausführen.
Grün Der grünen Taste zugeordneten Befehl ausführen.
Gelb Der gelben Taste zugeordneten Befehl ausführen.
Blau Befehlsmenü öffnen.
Zurück Plug-in beenden.

   Befehlsmenü


Befehl Beschreibung
Neues Puzzle erzeugen Ein Zufalls-Puzzle wird erzeugt.
Puzzle laden Laden eines Puzzles aus der Sudoku-Liste. Im Listenmenü kann man auch Sudokus aus der Liste löschen oder die Beschreibungen bearbeiten.
Puzzle speichern Hinzufügen des Puzzles zur Sudoku-Liste, zusammen mit einer optionalen Beschreibung.
Letzte Aktion zurücknehmen Einen Schritt rückwärts in der History.
Letzte Aktion wiederholen Einen Schritt vorwärts in der History.
Markierung setzen/löschen Aktivieren/Deaktivieren der Markierung in der aktuellen Zelle.
Nächste Zelle Cursor auf die nächste freie Zelle mit minimal möglichen Zahlen setzen.
Nächste Zahl Die nächste mögliche Zahl für die aktuelle Zelle setzen - Löschen der Zahl, wenn es keine größere mögliche Zahl gibt.
Puzzle zurücksetzen Zurücksetzen der Zahlen in allen Zellen, mit Ausnahme der vorgegebenen Zahlen.
Einstellungsmenü öffnen Das Einstellungsmenü des Plug-ins wird geöffnet.
Beenden Plug-in beenden.

   Farben der Zellen


Farbe Beschreibung
Türkis Vorgegebene Zahlen
Grün Markierte Zellen
Rot Fehlerhafte Zellen
Magenta Unklare Zahlen

   Quellcode-Dokumentation

Die Dokumentation des Quellcodes (nur in Englisch) wurde mit Doxygen erstellt.

   Logbuch

2005-10-28: Version 0.1.0 (OpenPGP-Signatur)

2005-11-04: Version 0.1.1 (OpenPGP-Signatur)

2006-04-25: Version 0.1.2 (OpenPGP-Signatur)

2007-02-23: Version 0.1.3 (OpenPGP-Signatur)

2008-03-22: Version 0.2.0 (OpenPGP-Signatur)

2008-04-06: Version 0.2.1 (OpenPGP-Signatur)

2008-07-27: Version 0.3.0 (OpenPGP-Signatur)

2008-08-30: Version 0.3.1 (OpenPGP-Signatur)

2008-09-28: Version 0.3.2 (OpenPGP-Signatur)

2008-11-23: Version 0.3.3 (OpenPGP-Signatur)

2008-11-29: Version 0.3.4 (OpenPGP-Signatur)

2010-04-05: Version 0.3.5 (OpenPGP-Signatur)

Die Signaturen können mit meinem OpenPGP-Schlüssel 0xEC0E954C überprüft werden.


© 2005-2010, Thomas Günther

Bitte, wirf ein paar Bohnen
in die Kaffeekasse.
Valid XHTML 1.0!