Sudoku-plugin

Aus VDR Wiki
(Unterschied zwischen Versionen)
Wechseln zu: Navigation, Suche
(Gliederung an Konventionen angepasst)
(Links)
 
(22 dazwischenliegende Versionen von 10 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 Plugins 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.
+
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. Mit der grünen Taste können Zellen markiert werden. Eine markierte Zelle hat einen grünen Hintergrund. Mit der gelben Taste wird der Cursor auf die nächste freie Zelle mit minimal möglichen Zahlen gesetzt. Die rote Taste setzt die nächste mögliche Zahl für die aktuelle Zelle.
+
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 Plugins vom Hauptmenü aus wird das gleiche Puzzle angezeigt. Ein neues Puzzle wird nur erzeugt, wenn der VDR gestartet wird oder wenn es durch Betätigung der blauen Taste angefordert wird. Diese Taste hat zwei Funktionen. Wenn keine Zahlen gesetzt sind, wird ein neues Puzzle erzeugt. Anderenfalls werden alle Zahlen zurückgesetzt, so dass nur noch die vorgegebenen Zahlen zu sehen sind.
+
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.jpg|thumb|none|''Screenshot'']]
+
{|
 +
|[[Bild:sudoku-plugin.jpg|thumb|none|''Sudoku'']]
 +
|}
  
==Hardwareanforderungen==
+
==Bedienung==
==Softwareanforderungen==
+
{| class="wikitable"
VDR >= 1.2.6
+
|-
 +
| 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.
 +
|}
  
==Installation==
+
===Befehlsmenü===
Siehe [[Plugin Installation]].
+
{| 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==
 
==Konfiguration==
 
===Einstellungen===
 
===Einstellungen===
{| border=1 cellpadding=2 cellspacing=0
+
{| class="wikitable"
|- bgcolor=#efefef
+
|-
 
! Parameter
 
! Parameter
 
! Werte
 
! Werte
Zeile 51: Zeile 142:
 
| Zellen mit unklaren Zahlen werden magenta markiert.
 
| Zellen mit unklaren Zahlen werden magenta markiert.
 
|-
 
|-
| '''Transparenz (%)'''
+
| '''Mögliche Zahlen als Muster anzeigen'''
| 0-100
+
| ja/nein
| 50
+
| nein
| Einstellung der Transparenz des Menüs.
+
| 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
==Bedienung==
+
| nein
{| border=1 cellpadding=2 cellspacing=0
+
| In allen leeren Zellen werden Ziffern angezeigt, die die möglichen Zahlen repräsentieren.
 
|-
 
|-
! bgcolor=#efefef|Links/Rechts/Hoch/Runter
+
| '''Markierungen löschen beim Reset'''
| Cursor im Puzzle bewegen.
+
| ja/nein
 +
| nein
 +
| Beim Zurücksetzen des Puzzles in den Ausgangszustand werden alle Markierungen gelöscht.
 
|-
 
|-
! bgcolor=#efefef|1-9
+
| '''Taste Rot'''
| Die Zahl in der aktuellen Zelle setzen.
+
| siehe Befehlsmenü
 +
| Markierung setzen/löschen
 +
| Befehl für die rote Taste auswählen.
 
|-
 
|-
! bgcolor=#efefef|0
+
| '''Taste Grün'''
| Die Zahl in der aktuellen Zelle löschen.
+
| siehe Befehlsmenü
 +
| Letzte Aktion zurücknehmen
 +
| Befehl für die grüne Taste auswählen.
 
|-
 
|-
! bgcolor=#00ff00|Grün
+
| '''Taste Gelb'''
| Aktivieren/Deaktivieren der Markierung in der aktuellen Zelle.
+
| siehe Befehlsmenü
 +
| Letzte Aktion wiederholen
 +
| Befehl für die gelbe Taste auswählen.
 
|-
 
|-
! bgcolor=#ffff00|Gelb
+
| '''Große Schriftart'''
| Cursor auf die nächste freie Zelle mit minimal möglichen Zahlen setzen.
+
| alle installierten Schriftarten
 +
| Sans Serif:Bold
 +
| Schriftart für die großen Zahlen auswählen.
 
|-
 
|-
! bgcolor=#ff0000|Rot
+
| '''Große Schrifthöhe (pixel)'''
| 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.
+
| 10-64
 +
| 31
 +
| Schrifthöhe für die großen Zahlen.
 
|-
 
|-
! bgcolor=#0000ff|Blau
+
| '''Große Schriftbreite (pixel)'''
| Das Puzzle in den Ausgangszustand zurücksetzen (falls Zahlen gesetzt sind).
+
| 10-64
Ein neues Puzzle starten (falls keine Zahlen gesetzt sind).
+
| 42
 +
| Schriftbreite für die großen Zahlen.
 
|-
 
|-
! bgcolor=#efefef|Back
+
| '''Kleine Schriftart'''
| Plugin beenden.
+
| alle installierten Schriftarten
|}
+
| Sans Serif:Bold
 
+
| Schriftart für die kleinen Zahlen auswählen.
==Farben==
+
{| border=1 cellpadding=2 cellspacing=0
+
 
|-
 
|-
! bgcolor=#00FFFF|Türkis
+
| '''Kleine Schrifthöhe (pixel)'''
| Vorgegebene Zahlen
+
| 10-64
 +
| 10
 +
| Schrifthöhe für die kleinen Zahlen.
 
|-
 
|-
! bgcolor=#00ff00|Grün
+
| '''Kleine Schriftbreite (pixel)'''
| Markierte Zellen
+
| 10-64
 +
| 14
 +
| Schriftbreite für die kleinen Zahlen.
 
|-
 
|-
! bgcolor=#ff0000|Rot
+
| '''Transparenz (%)'''
| Fehlerhafte Zellen
+
| 0-100
 +
| 50
 +
| Einstellung der Transparenz des Menüs.
 
|-
 
|-
! bgcolor=#FF00FF|Magenta
 
| Unklare Zahlen
 
 
|}
 
|}
  
==Probleme==
+
==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]]
[[en:Sudoku-plugin]]
+
{{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