Sudoku-plugin

Aus VDR Wiki
(Unterschied zwischen Versionen)
Wechseln zu: Navigation, Suche
(Beschreibung)
(Links)
 
(35 dazwischenliegende Versionen von 12 Benutzern werden nicht angezeigt)
Zeile 2: Zeile 2:
 
'''Autor:''' Thomas Günther
 
'''Autor:''' Thomas Günther
  
'''Sudoku''' ist ein Plugin zum Erzeugen und Lösen von Zahlenpuzzles, so genannten Sudokus.
+
{{wikipedia|Sudoku}} ist ein Plug-in zum Erzeugen und Lösen von Zahlenpuzzles, so genannten Sudokus.
 +
 
 +
===Status===
 +
Letztes Update 04/2010
 +
 
 +
 
 +
===Detaillierte Beschreibung===
  
 
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.
 
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.
  
 
==Bilder==
 
==Bilder==
[[Bild:sudoku-plugin-00.jpg|thumb|none|''kurze beschreibung'']]
+
{|
 +
|[[Bild:sudoku-plugin.jpg|thumb|none|''Sudoku'']]
 +
|}
  
==Hardwareanforderungen==
 
==Softwareanforderungen==
 
==Installation==
 
==Optionen==
 
==Patches==
 
==Konfiguration==
 
==Parameter==
 
 
==Bedienung==
 
==Bedienung==
==Probleme==
+
{| class="wikitable"
==CVS==
+
|-
==SVN==
+
| bgcolor=#efefef | Links/Rechts/Hoch/Runter
 +
| Cursor im Puzzle bewegen.
 +
|-
 +
| bgcolor=#efefef | 1..9
 +
| Die Zahl in der aktuellen Zelle setzen.
 +
|-
 +
| bgcolor=#efefef | 0
 +
| Die Zahl in der aktuellen Zelle löschen.
 +
|-
 +
| bgcolor=#ff0000 | Rot
 +
| Der roten Taste zugeordneten Befehl ausführen.
 +
|-
 +
| bgcolor=#00ff00 | Grün
 +
| Der grünen Taste zugeordneten Befehl ausführen.
 +
|-
 +
| bgcolor=#ffff00 | Gelb
 +
| Der gelben Taste zugeordneten Befehl ausführen.
 +
|-
 +
| bgcolor=#0000ff | Blau
 +
| Befehlsmenü öffnen.
 +
|-
 +
| bgcolor=#efefef | Zurück
 +
| Plug-in beenden.
 +
|}
 +
 
 +
===Befehlsmenü===
 +
{| class="wikitable"
 +
|-
 +
! 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===
 +
{| class="wikitable"
 +
|-
 +
| bgcolor=#00FFFF | Türkis
 +
| Vorgegebene Zahlen
 +
|-
 +
| bgcolor=#00ff00 | Grün
 +
| Markierte Zellen
 +
|-
 +
| bgcolor=#ff0000 | Rot
 +
| Fehlerhafte Zellen
 +
|-
 +
| bgcolor=#FF00FF|  Magenta
 +
| Unklare Zahlen
 +
|}
 +
 
 +
==Konfiguration==
 +
===Einstellungen===
 +
{| class="wikitable"
 +
|-
 +
! 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.
 +
|-
 +
|}
 +
 
 +
==Entwicklerversion==
 +
git clone  git://projects.vdr-developer.org/vdr-plugin-sudoku.git
 +
 
 +
==Aktuelle Version==
 +
[http://projects.vdr-developer.org/attachments/download/280/vdr-sudoku-0.3.5.tgz 0.3.5]
 +
 
 
==Links==
 
==Links==
{|
+
# [http://toms-cafe.de/vdr/sudoku/ Homepage des Plugins]
| [1]
+
# [http://projects.vdr-developer.org/projects/show/plg-sudoku Entwicklungs-Seite]
| http://toms-cafe.de/vdr/sudoku
+
 
| Homepage des Plugins
+
[[Kategorie:Plugins]]
|}[[Kategorie:Plugins]]
+
[[Kategorie:Spiele-Plugins]]
 +
{{i18n|sudoku-plugin}}

Aktuelle Version vom 29. August 2013, 16:06 Uhr

Inhaltsverzeichnis

[Bearbeiten] Beschreibung

Autor: Thomas Günther

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

[Bearbeiten] Status

Letztes Update 04/2010


[Bearbeiten] Detaillierte Beschreibung

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.

[Bearbeiten] Bilder

Sudoku

[Bearbeiten] Bedienung

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.

[Bearbeiten] 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.

[Bearbeiten] Farben

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

[Bearbeiten] Konfiguration

[Bearbeiten] 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.

[Bearbeiten] Entwicklerversion

git clone  git://projects.vdr-developer.org/vdr-plugin-sudoku.git

[Bearbeiten] Aktuelle Version

0.3.5

[Bearbeiten] Links

  1. Homepage des Plugins
  2. Entwicklungs-Seite
In anderen Sprachen