Kapitel 7: Referenz

Inhaltsverzeichnis

Optionen

Alle Optionen sind �ber den Dialog "Bearbeiten|Einstellungen" zug�nglich. Jede Seite in diesem Dialog hat einen "Zur�cksetzen" Schalter, der alle auf der Seite sichtbaren Optionen auf die Standardwerte zur�cksetzt. HoDoKu speichert alle Einstellungen beim Beenden des Programms (siehe Von HoDoKu verwendete Dateien) und l�dt sie beim n�chsten Start wieder. Zus�tzlich zu diesem Standardverhalten k�nnen die Optionen auch in Dateien geschrieben werden (siehe Konfigurationen und Sudokus speichern/laden). Diese Konfigurationsdateien k�nnen auch mit der Option /c f�r Batch-L�ufe verwendet werden.

Obwohl HoDoKus Konfigurationsdateien Standard-XML-Dateien sind und daher mit jedem einfachen Texteditor ge�ndert werden k�nnen, wird davon dringend abgeraten.

Allgemeine Optionen

Screenshot: General options

Programmstart:

Der Abschnitt "Programmstart" wird f�r Optionen verwendet, die nur beim Starten des Programms angewendet werden (eine Ausnahme ist die Option "Look and Feel", die sofort angewendet wird; es wird trotzdem empfohlen, HoDoKu nach einer �nderung neu zu starten). Einige Optionen spiegeln die Anfangswerte der Eintr�ge im Men� "Optionen" wieder. Wird einer der Men�eintr�ge w�hrend des Spiels ge�ndert, wird diese �nderung nicht gespeichert, wenn das Programm beendet wird. Jede Checkbox entspricht dem Men�eintrag mit demselben Namen.

Aussehen:

Verschiedene Optionen, die kontrollieren, wie HoDoKu aussieht und wie es auf Benutzereingaben reagiert:

Optionen f�r Levels/Fonts

Screenshot: Optionen f�r Levels/Fonts

Die Optionen f�r Schwierigkeitsstufen sind detailliert in Bewertung und Schwierigkeitsstufen beschrieben

Fonts:

Optionen f�r den Solver

Die Optionen f�r den Solver sind in Solver konfigurieren beschrieben.

Optionen f�r Alle L�sungsschritte finden

Die Optionen f�r Alle L�sungsschritte finden sind in Alle m�glichen Schritte finden beschrieben.

Optionen f�r Fortschrittsma�

Die Optionen f�r das Fortschrittsma� sind in Fortschrittsma� beschrieben.

Optionen f�r L�sungsschritte

Die Optionen f�r L�sungsschritte sind in Optionen f�r L�sungstechniken beschrieben.

Optionen f�r "Lernen"- bzw. "�ben"-Modus

Diese optionen sind in Spielmodi beschrieben.

Farben

Screenshot: Color options

Alle in HoDoKu verwendeten Farben k�nnen beliebig angepasst werden. Die Farben f�r die Schwierigkeitsgrade k�nnen auf der Seite "Allgemein" ge�ndert werden.

ColorKu options

Screenshot: Color options

Alle von HoDoKu im ColorKu-Modus verwendeten Farben k�nnen ebenfalls beliebig ge�ndert werden.

Kommandozeilenoptionen

HoDoKu kann als Kommandozeilenprogramm verwendet werden. Es kann einzelne Sudokus l�sen, kann beliebig viele Sudokus aus einer Datei lesen und l�sen und es kann Sudokus generieren, die bestimmte L�sungsschritte beinhalten. Da die f�r Windows bevorzugte exe-Datei keine eigenes Kommandozeilenfenster hat, �ffnet die exe-Version von HoDoKu ein eigenes Fenster, wenn sie als Kommandozeilenprogramm gestartet wird. Um das Programm zu beenden, einfach "Programm beenden" anklicken.

Bitte beachten Sie, dass "piping" (Ein-/Ausgabeverkettung) mit der exe-Version von HoDoKu nicht m�glich ist, Sie m�ssen die jar-Version verwenden.

Generelle Optionen

/h, /?
Gibt Hilfetext aus.
/f <file>
Lese Optionen aus Datei <file>. Kann mit beliebig vielen Optionen von der Kommandozeile oder von stdin kombiniert werden.
/c <hcfg file>
Verwende Konfigurationsdatei <hcfg file> f�r dieses eine Mal. Die Konfigurationsdatei sollte mit der grafischen Benutzeroberfl�che von HoDoKu erstellt worden sein. Die Verwendung von /c ver�ndert nicht die Konfiguration der grafischen Version von HoDoKu.
/lt
Liste die symbolischen Namen der einzelnen L�sungstechniken. Diese Namen k�nnen mit Optionen wie /sc oder /vg verwendet werden (siehe unten).

Einzelne Sudokus l�sen

Das Sudoku muss als Zeichenkette in einem Format angegeben werden, das HoDoKu unterst�tzt. F�r Zellen, die am Anfang keinen Wert enthalten sollen, kann '.' oder '0' verwendet werden. PM-Grids (textuelle Repr�sentationen aller noch m�glichen Kandidaten f�r jede Zelle) k�nnen ebenfalls verwendet werden, aber sobald in der Angabe Leerzeichen vorkommen, muss die Zeichenkette in " oder ' eingeschlossen werden. HoDoKu l�st das Sudoku und schreibt es auf die Konsole, gefolgt von einem "#", einer fortlaufenden Nummer und der Bewertung der Schwierigkeit.

Die folgende Eingabe:

000000010400000000020000000000050407008000300001090000300400200050100000000806000

erzeugt die Ausgabe:

000000010400000000020000000000050407008000300001090000300400200050100000000806000 #1 Leicht (466)

Wenn f�r die L�sung Zellen geraten werden m�ssen, wird "bf" ("Brute Force") an die Ausgabe angeh�ngt, bei Templates wird "ts" oder "td" angeh�ngt und wenn das Sudoku mit der aktuellen Konfiguration nicht gel�st werden kann (nur m�glich, wenn "Brute Force" deaktiviert ist), wird "gu" ("Give up") an die Ausgabe angeh�ngt.

Das Ausgabeformat kann mit verschiedenen Optionen beeinflusst werden:

/vs
L�sung statt Angabe ausgeben.
/vp
F�r jedes Sudoku den kompletten L�sungsweg ausgeben (eine Zeile pro L�sungsschritt).
/vg [l|c|s:]<step>[,<step>...]
Gib f�r jeden L�sungsschritt <step> den Zustand des Puzzles aus. Der optionale Parameter bestimmt, wie die Ausgabe erfolgen soll:
  • l: Ausgabe im Bibliotheksformat
  • c: Ausgabe der Kandidaten (Standard)
  • s: Ausgabe der Kandidaten mit Kennzeichnung des L�sungsschritts
Wenn /vp nicht angegeben wurde, wird /vg ignoriert.
/vst
Statistik ausgeben (Anzahl der verwendeten Techniken, der gesetzten Zellen und eliminierten Kandidaten). Wenn /vp angegeben wurde, wird die Statistik f�r jedes einzelne Sudoku ausgegeben.
/vf <0|1|2>
Setzt das Ausgabeformat f�r Fische (Default, Zahlen, Zellen)

Mehrere Sudokus in einem Durchgang l�sen (batch solve)

Wenn mehrere Sudokus auf einmal gel�st werden sollen, m�ssen sie in eine Textdatei geschrieben werden (eine Zeile pro Sudoku). Jede Zeile kann in jedem Format sein, das HoDoKu unterst�tzt (z.B. 81 Zeichen lange Zeichenketten, HoDoKu-Bibliotheksformat oder das Format der q2-Taxonomie). An jedes Sudoku k�nnen '#' und eine beliebige Zeichenkette angeh�ngt werden.

Alle Optionen, die beim L�sen einzelner Sudokus erlaubt sind, sind auch hier g�ltig.

/bs <file>
L�se alle Sudokus in der Datei <file>. Die Ausgabe wird auf die Konsole und in eine Datei <file>.out.txt oder eine mit /o angegebene Datei geschrieben.

Alle L�sungsschritte finden

/bsa
F�hre die Funktion "Alle L�sungsschritte finden" f�r [puzzle] aus. Die Ausgabe wird auf die Konsole und in eine Datei <file>.out.txt oder eine mit /o angegebene Datei geschrieben.
/bsaf <file>
F�hre die Funktion "Alle L�sungsschritte finden" f�r alle Sudokus in der Datei <file> aus. Die Ausgabe wird auf die Konsole und in eine Datei <file>.out.txt oder eine mit /o angegebene Datei geschrieben.

Suche nach Sudokus mit bestimmten L�sungstechniken

HoDoKu kann nach Sudokus suchen, die bestimmte L�sungstechniken enthalten (mehrere L�sungstechniken k�nnen f�r einen Lauf angegeben werden, pro Ausgabezeile wird aber nur eine L�sungstechnik verwendet). Die Optionen bestimmen, wie die L�sungsschritte in den Sudokus vorkommen sollen.

/s
Suche nach Sudokus, die L�sungsschritte gem�� /sc enthalten. Die Sudokus werden auf die Konsole und in eine Datei <step>[_<step>...].txt oder eine mit /o angegebene Datei geschrieben. An das Sudoku werden '#' und der Puzzle-Typ angeh�ngt.
/so <file>
Nimm die Datei <file>, die mit /s erzeugt wurde, und sortiere sie nach Puzzle-Typ. Die Ausgabe wird auf die Konsole und in eine Datei <file>.out.txt oder eine mit /o angegebene Datei geschrieben. Wenn /sc angegeben wurde, werden nur Schritte geschrieben, die mit den Optionen von /sc �bereinstimmen.
/sc <step>[:0|1|2|3][+[e|g|l]n][,[-]<step>[:0|1|2|3][+[e|g|l]n]...]
Definiere Sudoku-Eigenschaften f�r /s oder /so. <step> ist ein interner Name gem�� /lt oder "all" (alle Schritte au�er Singles), "nssts" (alle Schritte aus Singles, h2, h3, h4, n2, n3, n4, l2, l3, lc1, lc2, bf2, bf3, bf4, xy, sc, mc) oder "nssts1" (nssts und 2sk, sk, bug1, w, u1, xyz, rp). "-" bedeutet, dass <step> nicht in der L�sung enthalten sein darf (im ersten Schritt nicht erlaubt).
Der erste optionale Parameter bestimmt, wie die L�sungsschritte im Sudoku vorkommen sollen:
  • 0: Beliebige Schritte vor und nach dem Schritt erlaubt (x <step> x - Standard).
  • 1: Nur SSTS vor und nach dem Schritt erlaubt (ssts <step> ssts).
  • 2: Nur SSTS vor dem Schritt, nur Singles nach dem Schritt (ssts <step> s).
  • 3: Nur Singles vor und nach dem Schritt erlaubt (s <step> s).
Der zweite optionale Parameter bestimmt, wie viele Kandidaten von <step> eliminiert werden m�ssen:
  • e: Anzahl eliminierter Kandidaten ist gleich n
  • l: Anzahl eliminierter Kandidaten ist kleiner als n
  • g: Anzahl eliminierter Kandidaten ist gr��er als n
/sl <level>
Erzeugt nur Sudokus mit Schwierigkeitsstufe <level>. G�ltige Werte f�r <level> sind:
  • 0: Leicht
  • 1: Mittel
  • 2: Schwer
  • 3: Unfair
  • 4: Extrem

Verschiedene Optionen

/o <file>
Schreibe Ausgabe in die Datei <file>. Wenn <file> gleich "stdout" ist, erfolgt die Ausgabe in der Konsole.
/stdin
Lese zus�tzliche Optionen von stdin. Kann mit /f und mit beliebig vielen direkt auf der Kommandozeile spezifizierten Optionen kombiniert werden.

Brute Force Test

/bt <file>
Lese Sudoku aus <file> und f�hre einen Brute Force Test durch: Nach jedem L�sungsschritt, der kein Single ist, wird f�r alle mit /bts angegebenen Schritte die Funktion "Alle L�sungsschritte finden" ausgef�hrt. Anschlie�end werden alle gefundenen Schritte gegen die korrekte L�sung gepr�ft, Abweichungen werden ausgegeben.
/bts <step>[,<step>...]
Eine Liste mit L�sungstechniken, f�r die der Brute Force Test durchgef�hrt werden soll.

Regression-Test

/test <file>
F�hrt alle Tests aus, die in <file> enthalten sind
/testf <file>
F�hrt alle Tests aus, die in <file> enthalten sind, au�er jenen, deren Berechnung sehr lange dauert

SSTS sind die vom Programm "Simple Sudoku" unterst�tzten Techniken:

Von HoDoKu verwendete Dateien

HoDoKu erzeugt zwei Dateien im tempor�ren Ordner des Computers (die Lage des tempor�ren Ordners ist abh�ngig vom Betriebssystem - unter Windows ist es normalerweise "%USERPROFILE%\AppData\Local\Temp", unter Linux ist es normalerweise einfach nur "/tmp"). Die erste Datei hei�t "hodoku.hcfg". Sie enth�lt die aktuelle Konfiguration. Die zweite Datei hei�t "hodoku.log", in ihr werden Informationen �ber kritische Fehler gespeichert. Beide Dateien k�nnen problemlos gel�scht werden. Wird allerdings "hodoku.hcfg" gel�scht, startet HoDoKu das n�chste Mal mit den Standardeinstellungen.

Copyright © 2008-12 by Bernhard Hobiger
Alles Material auf dieser Site unterliegt der GNU FDLv1.3.