xshisen(6)							   Games Manual 							xshisen(6)

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() 
 <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.

X Version 11							    Oct 6, 1995 							xshisen(6)