From c90c389a8a8d9d8661e9772ec4144c5cf2039f23 Mon Sep 17 00:00:00 2001 From: toma Date: Wed, 25 Nov 2009 17:56:58 +0000 Subject: Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. BUG:215923 git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdegames@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da --- doc/kshisen/Makefile.am | 4 + doc/kshisen/index.docbook | 423 ++++++++++++++++++++++++++++++++++ doc/kshisen/kshisen-configuration.png | Bin 0 -> 25016 bytes doc/kshisen/score-formula.png | Bin 0 -> 9490 bytes doc/kshisen/score-formula.tex | 18 ++ 5 files changed, 445 insertions(+) create mode 100644 doc/kshisen/Makefile.am create mode 100644 doc/kshisen/index.docbook create mode 100644 doc/kshisen/kshisen-configuration.png create mode 100644 doc/kshisen/score-formula.png create mode 100644 doc/kshisen/score-formula.tex (limited to 'doc/kshisen') diff --git a/doc/kshisen/Makefile.am b/doc/kshisen/Makefile.am new file mode 100644 index 00000000..368fc0da --- /dev/null +++ b/doc/kshisen/Makefile.am @@ -0,0 +1,4 @@ + +KDE_DOCS = AUTO +KDE_LANG = en + diff --git a/doc/kshisen/index.docbook b/doc/kshisen/index.docbook new file mode 100644 index 00000000..483c4eb7 --- /dev/null +++ b/doc/kshisen/index.docbook @@ -0,0 +1,423 @@ + + + + + +]> + + + +The &kshisen; Handbook + + + +Dirk +Doerflinger + +
&Dirk.Doerflinger.mail;
+ + + +FrerichRaabe +Reviewer +
&Frerich.Raabe.mail;
 + + + + + +2006-06-17 +1.5.1 + + +&kshisen; is a game similar to Mahjongg for &kde;. + + + + KDE + kdegames + kshisen + game + shisen-sho + + + + + + +Introduction + +&kshisen; is a single-player-game similar to Mahjongg and uses the same +set of tiles as Mahjongg. + +The object of the game is to remove all tiles from the field. + + + + +Playing &kshisen; + + +Rules + +The aim of the game is to remove all tiles from the board. Only two +matching tiles can be removed at a time. Two tiles can only be removed if they +can be connected with a maximum of three connected lines. Lines can be +horizontal or vertical, but not diagonal. + +You don't have to draw the lines by yourself, the game does this for +you. Just mark two matching tiles on the board, if they can be connected with a +maximum of three lines, the lines will be drawn and the tiles are +removed. + +Remember that lines only may cross the empty border. If you are stuck, you +can use the Hint feature to find two tiles which may be removed. Clicking a +tile with the &RMB; will show you all corresponding tiles, no matter if they are +removable at the moment or not. + +The game is over when no moves are possible. This could be due to +clearing all the tiles from the field or reaching a point in the game +where no two matching tiles can be connected by three lines. +Some games are unsolvable, if you would like to avoid unsolvable +games uncheck the option Allow unsolvable +games in the configuration dialog. + +The resulting score S is calculated using the +following formula, assuming that n represents the +number of tiles present when the game started and t +standing for the time (in seconds) it took to clear the +field: + + + + +S=(n/t)*sqrt(n/84)/0.0014 + + +If you played with the Gravity setting enabled, this score +will additionally get multiplied by two. + + + + +Menu Reference + + +The <guimenu>Game</guimenu> Menu + +The Game menu lets you control the status of the +current game: + + + + +&Ctrl; +N +GameNew +Finish the actual game set and start a new +session with new tiles. + + + + +F5 +GameRestart +Game +Restart the current game with the same +tiles. + + + + +P +Game +Pause +Pauses the entire game, especially the timer +which affects the scoring. The menu entry is also used for resuming the +game. + + + + +&Ctrl;H + +GameShow +Highscores +Shows the (local) Top-Ten charts of &kshisen;. + + + + +&Ctrl; +Q +GameQuit +Quits &kshisen;. + + + + +Some of the menu items can also be controlled by keykoard shortcuts. +See for a list. + + + + +The <guimenu>Move</guimenu> Menu + + + + &Ctrl;Z +Move +Undo +Undo the last step. Same as the +Undo button in the toolbar. + + + +&Ctrl;&Shift;Z +Move +Redo +Redo the last step. Same as the +Redo button in the toolbar. + + + + +H +Move +Hint +Show a tip, which two tiles to remove +next. + + + + + + +The <guimenu>Settings</guimenu> Menu + + + + +Settings +Show Toolbar + + + +Toggle on and off the display of the toolbar. + + + + + + +Settings +Show Statusbar + + + +Toggle on and off the display of the status bar. + + + + + + +Settings +Configure Shortcuts... + + +Open a dialog which lets you redefine all the keyboard shortcuts. + + + + + +Settings +Configure Toolbars... + +Displays a &kde; standard dialog where you can configure the toolbar icons. + + + + +Settings +Configure &kshisen;... + + +Opens the configuration +dialog to change &kshisen; settings. + + + + + + + +The <guimenu>Help</guimenu> Menu + +&help.menu.documentation; + + + + +Shortcuts + +Default shortcuts are: + + + + + +New&Ctrl;N +Restart GameF5 +PauseP +Show Highscores&Ctrl;H +Quit&Ctrl;Q +Undo&Ctrl;Z +Redo&Ctrl;&Shift;Z +HintH +&kshisen; HandbookF1 +What's This&Ctrl;&Shift;F1 + + + + + + + + +Configuration + +Selecting the Settings +Configure &kshisen;... menu item will +open a configuration dialog which lets you alter the behavior of the game. + + +&kshisen; configuration dialog + + +&kshisen; configuration dialog + + + + + +Gravity +Checking this makes the game even harder: If a tile is +removed, all tiles lying above it will fall down one step. + + + +Allow unsolvable games +If checked, only solvable games will be +created when a new game is started. Note: You may still choose the wrong way and +have to try again if you didn't solve the game, but if it's checked, the game +will be solvable. + + + +Board Difficulty +The slider controls the difficulty of the board. There are three +options Easy, Medium and +Hard. + + + +Piece Removal Speed +Adjusting this slider alters the speed at which the pieces are +removed from the screen after a match has been made. + + + +Prefer Unscaled Tiles +Resizing the window causes the tiles on the board to be scaled to +match the window size. When this option is checked, the window is resized to fit +the tiles' natural size. You can still adjust the size of the window. Doing so +causes this mode to be disengaged. + + + +Tile Size +This slider allows you to can change the number of tiles +on the board. The more tiles you have, the harder (and longer) +the game will be. + + + +Help +Opens &kshisen; help pages. (this document). + + +Defaults +Reverts all settings to defaults. + + +OK +Saves your changes and closes the dialog. + + +Apply +Saves your changes but doesn't close the dialog. + + +Cancel +Cancels all your changes and closes the dialog. + + + + + +Credits and License + + +&kshisen; Copyright 1999 &Mario.Weilguni; +&Mario.Weilguni.mail; + + + + +Documentation Copyright 2000 &Dirk.Doerflinger; +ddoerflinger@gmx.net + + + + +&underFDL; +&underGPL; + + + + +Installation + + +How to obtain &kshisen; + +&install.intro.documentation; + + + + +Requirements + + +In order to successfully compile &kshisen;, you need &kde; 3.x. +All required libraries as well as &kshisen; itself can be found on +&kde-ftp;. + + + + +Compilation and Installation + +&install.compile.documentation; + + + + + + diff --git a/doc/kshisen/kshisen-configuration.png b/doc/kshisen/kshisen-configuration.png new file mode 100644 index 00000000..cbcfb109 Binary files /dev/null and b/doc/kshisen/kshisen-configuration.png differ diff --git a/doc/kshisen/score-formula.png b/doc/kshisen/score-formula.png new file mode 100644 index 00000000..0dceb581 Binary files /dev/null and b/doc/kshisen/score-formula.png differ diff --git a/doc/kshisen/score-formula.tex b/doc/kshisen/score-formula.tex new file mode 100644 index 00000000..a50d233d --- /dev/null +++ b/doc/kshisen/score-formula.tex @@ -0,0 +1,18 @@ +\documentclass{article} +\usepackage[psamsfonts]{amssymb} +\usepackage{amsmath} +\newcounter{afg} +\newcommand{\aufgabe}{\stepcounter{afg}\subsubsection*{Aufgabe \arabic{afg}}} + +\renewcommand{\labelenumi}{\alph{enumi})} + +\begin{document} + +\begin{align*} + \text{S} & = \frac{n}{t} \cdot \sqrt{\frac{n}{84}} / 0.0014 \\ + & = \frac{n}{t} \cdot \frac{\sqrt{\frac{n}{84}}}{0.0014} \\ + & = \frac{n}{t} \cdot \frac{\sqrt{n}}{\sqrt{84}\cdot 0.0014} \\ + & = \frac{n}{t} \cdot \frac{\sqrt{n}}{0.012831211946} \\ + & = \frac{\sqrt{n^3}}{0.012831211946\cdot t} \\ +\end{align*} +\end{document} -- cgit v1.2.1