📄 usage.html
字号:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html lang="en">
<head>
<meta name="generator" content="Netbeans 5.0">
<meta name="author" content="Andrew Stevens">
<meta name="copyright" content="(c) 2005-2006 The PseudoQ Project.">
<!-- Creative Commons license metadata -->
<!--
<rdf:RDF xmlns="http://web.resource.org/cc/"
xmlns:dc="http://purl.org/dc/elements/1.1/"
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#">
<Work rdf:about="">
<license rdf:resource="http://creativecommons.org/licenses/LGPL/2.1/"/>
<dc:type rdf:resource="http://purl.org/dc/dcmitype/Software"/>
</Work>
<License rdf:about="http://creativecommons.org/licenses/LGPL/2.1/">
<permits rdf:resource="http://web.resource.org/cc/Reproduction"/>
<permits rdf:resource="http://web.resource.org/cc/Distribution"/>
<requires rdf:resource="http://web.resource.org/cc/Notice"/>
<permits rdf:resource="http://web.resource.org/cc/DerivativeWorks"/>
<requires rdf:resource="http://web.resource.org/cc/ShareAlike"/>
<requires rdf:resource="http://web.resource.org/cc/SourceCode"/>
</License>
</rdf:RDF>
-->
<meta name="keywords" content="pseudoq, sudoku, su doku, puzzle, puzzles, open source, java">
<meta name="description" content="PseudoQ is a java application for creating,
playing and solving Su Doku (number place) puzzles of various types. Uses
'smart' techniques rather than brute force to solve the puzzles.">
<link rel="stylesheet" type="text/css" title="Style" href="pseudoq-site.css">
<title>Using PseudoQ</title>
</head>
<body>
<div id="menu"><ul>
<li><a href="index.html">Home</a></li>
<li><a href="status.html">Status</a></li>
<li><a href="usage.html">Using PseudoQ</a></li>
<li><a href="charity.html">Support this project</a></li>
<li><a href="license.html">Licensing issues</a></li>
<li><a href="http://sourceforge.net/projects/pseudoq" class="externalLink">SourceForge project</a></li>
</ul></div>
<div id="content">
<h1>Using PseudoQ</h1>
<h2>Running PseudoQ</h2>
<p>PseudoQ is packaged as an executable jar, and all its dependencies are
specified in the manifest's classpath. This means that, so long as the various
library jars are in the same directory, you can run PseudoQ with the command
<code>java -jar PseudoQ.jar <em>options</em></code>
or
<code>javaw -jar PseudoQ.jar <em>options</em></code>
if you wish to run it detached from the command line. If the other jars are
not found in the same directory, you will need to add the appropriate classpath
option for the Java runtime.</p>
<h3>Switching on verbose logging</h3>
<p>PseudoQ uses <a href="http://logging.apache.org/log4j/docs/" class="externalLink">Log4J</a>
to do its logging. The log4j.properties configuration
file included in the jar only outputs error messages. To switch on more
detailed debugging messages, use
<code>java -Dlog4j.configuration=<em>alternative.configuration</em> -jar PseudoQ.jar <em>options</em></code>
to run the application. A configuration that switches on all the debug trace
messages is also included in the jar, and can be used with
<code>java -Dlog4j.configuration=dev-log4j.properties -jar PseudoQ.jar <em>options</em></code>
</p>
<h2>Using the GUI</h2>
<p>Starting PseudoQ with
<code>java -jar PseudoQ.jar --gui</code>
will open up a "launcher" window (see right).
<img src="images/launcher.png" alt="Launcher window screenshot" class="floatRight" width="210" height="202"><br>
From here, you can either click the "Load" button to open a saved
puzzle file, or "Generate/Design" to create a new puzzle, either by
entering the digits yourself into a blank grid or generated randomly by the
program.
<em>Note: At present the automatic generation may produce puzzles that PseudoQ
is unable to solve. They should always have at least one valid solution,
however.</em></p>
<p><img src="images/tiny_puzzle.png" alt="Puzzle window screenshot" class="floatLeft">
The puzzle window (see left) contains the grid where the digits are entered.
Digits are placed by first clicking on a cell in the grid, then clicking one of
the buttons on the right of the window. You can remove the value from a cell by
clicking the topmost "-" button. The currently selected cell is
highlighted by a coloured outline.</p>
<p>The window has two modes of operation: Design, in which you can set up the
initial "given" cells in the grid; and Play, in which you can try to
solve the puzzle. You can switch between the two modes by clicking on the
corresponding radio button at the top of the window. Switching into design
mode will clear any played values from the grid.</p>
<h3>Design</h3>
<p>In design mode you can change the value of any cell in the grid. You can
check whether the current grid is solveable (so far as PseudoQ is able) by
clicking the "Solve" button. If a solution is found, it will be
displayed. Clear the "Show solution" checkbox to remove this and
return to editing the grid. If you wish to start over, pressing the
"Reset" button will completely clear the grid.</p>
<h3>Play</h3>
<p>In play mode you can only change the values in cells that were not initially
filled. To help tell them apart, the two types of cell are diaplayed in a
different colour. If you get stuck, you can click the "Hint" button
to have the program attempt to find another cell whose value can be deduced.
Alternatlvely you can click "Solve" to have the program attempt to
solve the rest of the puzzle. Since PseudoQ works from the current state of
the grid, rather than the initial "givens only" position, it may be
unable to find the solution if you have filled in a cell incorrectly (e.g. if
you have guessed a value or made an incorrect deduction). Or, of course, it
may be that puzzle is too difficult to be solved using the methods that have
been coded into the program. If you come across a published puzzle which
PseudoQ can't solve but you know to be solveable, please let me know the
details (either
<a href="http://sourceforge.net/sendmessage.php?touser=247081" class="externalLink">directly</a>
or via the
<a href="http://lists.sourceforge.net/mailman/listinfo/pseudoq-interest" class="externalLink">mailing list</a>)
so that I can try to improve PseudoQ to handle it. Clicking the
"Reset" button will remove the played values from the grid, leaving
just the given ones.</p>
<h3>Generate</h3>
<p>Clicking the "Generate/Design" button on the launcher window (or
selecting New from the File menu) will start a wizard to create a new
puzzle.</p>
<p>At the first step,<br><img src="images/wizard1.png"><br>
select the type of puzzle you wish to create from the dropdown list.<p>
<p>At the second step,<br><img src="images/wizard2.png"><br>
select "Design manually" to start with an empty grid, or
"Generate automatically" if you want PseudoQ to create a puzzle for
you. <em>The puzzle creation needs more work The generated puzzles will all
have at least one solution, although PseudoQ may not be able to solve them
itself. The other options (Placement pattern and Difficulty) will in some
future version influence the puzzle that is generated,
but at the moment have no effect.</em></p>
<h2>Command line options</h2>
<p><em>Note: At present the command line options have not been as thoroughly tested
as other parts of the program, and may not all work exactly as described.</em></p>
<p>The following command line options are available:
<dl>
<dt>--gui or -g</dt><dd>Open the "launcher" window</dd>
<dt>--play or -p</dt><dd>Load and play a puzzle. Must have a --file option, to
specify the puzzle to play. Opens the GUI puzzle window with the specified
puzzle pre-loaded.</dd>
<dt>--solve or -s</dt><dd>Load and solve a puzzle. Must have a --file option,
to specify the puzzle to solve. Prints the solution to the standard output
stream.</dd>
<dt>--create or -c</dt><dd>Automatically generate a random puzzle. May have
a --type option specifying the puzzle type, otherwise a standard type puzzle is
created. If a --file option is used, the generated puzzle is written to that
file; if --gui is used, the generated puzzle is opened in the GUI puzzle window;
otherwise, the puzzle is printed to the standard output stream.</dd>
<dt>--file or -f, followed by a filename</dt><dd>Specifies a file to use with
the --play, --solve or --create options.</dd>
<dt>--type or -t, followed by a puzzle type</dt><dd>Used with the --create
option, specifies the puzzle type to be created. The type should be one of
"TINY", "MINI", "MINI_X", "SMALL_X",
"STANDARD", "SUPER", "LARGE"; or
"STANDARD_SAMURAI".
</dl>
</p>
</div>
<div id="footer">
<span class="left"><a href="http://sourceforge.net/donate/index.php?group_id=150500"><img src="http://images.sourceforge.net/images/project-support.jpg" width="88" height="32" border="0" alt="Support This Project"></a></span>
<span class="right">
<a href="http://www.netbeans.org/downloads/index.html"><img src="images/created-with-nb-1.gif" border="0" alt="Created with NetBeans!"></a>
<a href="http://sourceforge.net"><img src="http://sourceforge.net/sflogo.php?group_id=150500&type=1" width="88" height="31" border="0" alt="SourceForge.net Logo" /></a>
</span>
</div>
</body>
</html>
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -