NAME¶
xshisen - Shisen-sho puzzle game for X11
SYNOPSIS¶
xshisen [ options ]
DESCRIPTION¶
xshisen is a puzzle game for X11. Similar to the famous
"Shang-hai", your objective is to remove all the pieces on the
board.
xshisen requires a pointing device like mouse. It cannot be
controlled with only keyboard.
RULES¶
The game will over when you remove all the pieces on the board. The pieces can
be removed only when both of the following conditions are true.
- (1)
- The 2 pieces have the same picture
- (2)
- The 2 pieces can be connected with up to 3 lines which do
not go over other pieces.
- It may seem difficult rule, but is easier than describing
in
- words. "Auto-demo" mode must be very useful for
you to understand the rule.
Score¶
The best scores will be recorded at
xshisen-scores file under the
directory specified by
XSHISENLIB environment variable. X resources
"libDirectory" will be valid if the environment variable is not set.
Note that the score will not be recorded if you use even one of
"Back", "Search", or "Restart".
OPTIONS¶
The following command line options are available.
- standard Xt options
- xshisen accepts standard toolkit options like
-display, or -iconic.
- -demo
- Auto-demo mode. You cannot play game with this mode, but
the game will proceed by computer automated algorithm. This mode is quite
useful for you to understand rules.
- -score
- Just displays the best score dialog and exits.
- -mag number
- Magnify main window by number times. The standard
window will be 640x400. Number may be a decimal, but the range is
limited from 0.5 to the display size.
- -fn fontlist
- Use fontlist for menubar and times.
- -large
- Play double sized game. Game size can be changed with
menubar after you started xshisen. Each game size has independent
best time records.
- -huge
- Play quadruple sized game. Game size can be changed with
menubar after you started xshisen. Each game size has independent
best time records.
- -trial
- Play as "Click Trial" mode. You can measure your
mouse operation speed with this feature.
- -gravity
- Enable gravity effect. All the pieces above the removed
pieces will fall down.
RESOURCE¶
The following resources are available.
- XShisen*fitPixmap
- If this value is True, the initial window size will
be automatically calculated with the pixmap data size. When this value is
False, the initial window size is determined by the width
and height resources. The pixmap data will be resized in this case.
Default value is True.
- XShisen*width
- Width of the initial window. This resource is ignored when
fitPixmap resource is set to True. Default value is
640.
- XShisen*height
- Height of the initial window. This resource is ignored when
fitPixmap resource is set to True. Default value is
400.
- XShisen*scoreFile
- This resource specifies the score file name. This file name
must not contain the directory name. Default value is
"xshisen-scores".
- XShisen*connectLineTime
- The delay time in mili-second between you clicke the pair
and the pair is actually removed from screen. This value should be enough
big for beginners, but experts may want this value smaller in order to
play quickly. Default value is 1000 mili-seconds.
- XShisen*connectLineColor
- This specifies the connection line color which appears when
pieces are being removed. Default value is "blue".
- XShisen*connectLineWidth
- This specifies the connection line width in pixel. Default
value is 6.
- XShisen*background
- Background color. Default value is #004000.
- XShisen*libraryDirectory
- The directory where the pixmap data and the best score file
is located. This resource is ignored when you specify the
XSHISENLIB environment variable.
- XShisen*drawing.translations
- Button binding setting for your mouse. Default is
<Btn1Down>: #replace PickupPiece() \n <Btn3Down>: CancelPiece()
MENU BAR AND KEYBOARD¶
- Start (Control + D)
- Starts new game. The pieces are located at random
position.
- Restart (Control + R)
- Restarts the current game. The time of restarted game will
not be recorded as the best score.
- Pause (Control + P)
- Pauses the game. The time count will be stopped, but also
the pieces picture will be hidden. You can resume your game to do
"Pause" again.
- Exit
- Exits the Shisen-sho.
- Search (F1)
- Teaches the pair you can remove now. You can use
"Search" anytime, but the time will not be recorded as the best
score if you use "Search" even once.
- Back (F5)
- Backs one step. The time will not be recorded if you use
"Back".
MOUSE CONTROL¶
The following mouse control is available. You can change mouse button bindings
with
XShisen*drawing.translations resource.
- Button 1
- Specifies the piece to remove. You can cencel the selection
when you click the selected piece again.
- Button 3
- Cancels the selected piece. You can use button 3 after
"Search", which cancels the search result.
AUTHORS¶
Shisen-sho for X11: Masaoki Kobayashi
Picture: Takayuki Akiyama
COPYRIGHT¶
XShisen Copyright 1995,1996,1999,2002 by Masaoki Kobayashi
<masaoki@techfirm.co.jp>. Picture#1 Copyright by Takayuki Akiyama
<taco3@ybb.ne.jp>. Picture#2 Copyright by Mario Weilguni
<mweilguni@sime.com>. See LICENSE file for detail.