Provided by: xblast-data_2.6.1-10_all bug

NAME

       tkXBlast - tcl/tk based setup tool for XBlast

SYNOPSIS

       tkXBlast

DESCRIPTION

       tkXBlast  is  an  interactive setup tool for XBlast based on tcl/tk. It
       supports  game  setup,  level  selection  and  resource  setup.  It  is
       compatible with XBlast 2.0 and 2.2.

UPPER BUTTON BAR

       The  upper  button  bar  of  tkXBlast  is use to select one of the five
       tkXBlast screens. It is available for all screens.

       Launch This button activates the Launch screen. On this screen the game
              options can be modified and the game itself can be launched. The
              game setup can also be loaded and saved from this screen.

       Levels This button activates the Levels  screen.  On  this  screen  the
              levels to be played can be selected.

       Statistics
              This  buttons  activates  the  Statistics screen. On this screen
              game statistics for each player and level can be reviewed.

       Player Colors
              This button activates the Player Colors screen. On  this  screen
              the  player  color  resources  can  be  set.  This screen is not
              available on black and white displays.

       Player Resources
              This button activates  the  Player  Resources  screen.  On  this
              screen  the  player  messages  and  control  keybindings  can be
              defined.

LAUNCH SCREEN

       On this screen the game options can be modified and the game itself can
       be  launched.  The  game  setup  can also be loaded and saved from this
       screen. On the lower part of the screen are the following buttons:

       Start XBlast
              Pressing this  button  starts  XBlast  with  the  selected  game
              parameters.  If  any  level  selection  was  made  on the Levels
              screen, this will be used too. This button will also be invoked,
              when you press Return key.

       Load Setup
              Loads a previously saved setup from the file ~/.xblast.

       Save Setup
              Save the current setup to the file ~/.xblast.

       Exit   Press this button to exit tkXBlast or press the Escape key.

       The Launch screen it self consists of several subwindows:

       Player X
              There  are  6  player  windows,  one  for each player. An active
              player window shows the xblast sprite in  winner  pose.  If  the
              window  is inactive the sprite has turned his back to you. Enter
              the player’s  name  in  the  entry  above  the  @-sign  and  the
              display’s name in the entry below.

       Game Options
              In  this  window  you  can  setup  any  game option available to
              XBlast:
              * Number of Players
              * Team Mode
              * Number of Lives
              * Number of Victories
              * Random Player Positions
              * Random Level Order
              * Allow Color Mode
              * Override Window Manager
              * Frame Rate
              * Bell Sound
              * Fork XBlast
              * Game Statistics

LEVELS SCREEN

       On this screen you can select the levels you want to  play.  The  lower
       part contains the following buttons:

       Start XBlast
              Pressing  this  button  starts  XBlast  with  the  selected game
              parameters. If any  level  selection  was  made  on  the  Levels
              screen, this will be used too. This button will also be invoked,
              when you press Return key.

       All    Pressing this button select all levels for playing.

       None   Pressing this button deselects all levels  for  playing.  Please
              note, that you must selects at least one level for playing.

       Toggle Pressing this button toggles the state of all levels.

       Exit   Press this button to exit tkXBlast or press the Escape key.

       The  Levels screen it self contains four level selection windows.  They
       list all levels available in XBlast. Click on any level to  toggle  its
       selection (selected levels are marked in red).

STATISTICS SCREEN

       On this screen you can review the game statistics for XBlast.  In order
       to use this feature you must enable the game statistics feature on  the
       Launch  screen.  The  statistics  data  will  be  stored  in  the  file
       ~/.xblast_stat. The lowe part contains the following buttons:

       Show Statistics
              Pressing this button will show the statistics for  any  selected
              player  or  level.  This  button  will also be invoked, when you
              press Return key.

       Update Statistics
              Update the data currently displayed (from the statistics  file).

       Exit   Press this button to exit tkXBlast or press the Escape key.

       The screen itself contains three subwindows

       Select Level
              This  listbox  contains  all  levels in the statistics database.
              Press on any level to select it.

       Select Player
              This listbox contains all players in  the  statistics  database.
              Press on any player to select him/her.

       Statistics for ...
              In  this  window the results of your queries are shown. They are
              sorted by highest value for percentage.

PLAYER COLORS SCREEN

       On this screen you customize the colors of your  player.  This  changes
       the  colors  on  your  display and on any other display. The lower part
       contains the following buttons:

       Apply  Pressing this buttons applies the selected player colors to your
              display, by invoking xrdb. They will be lost when you finish you
              X-session.  This button will also be  invoked,  when  you  press
              Return key..PP

       Query  Pressing this button queries the current player colors from your
              display, via xrdb.

       Link to Defaults
              Pressing this button modifies your ~/.Xresources file to include
              the file ~/.xblast-player_colors, when being parsed.

       Load   Pressing  this  button  loads  the  color  setup  from  the file
              ~/.xblast-player_colors.

       Save   Pressing this button saves the current color setup to  the  file
              ~/.xblast-player_colors.

       Exit   Press this button to exit tkXBlast or press the Escape key.

       The screen itself contains the following subwindows:

       Single/Right Player
              In this window you can set the following color resource for your
              player:
              * Helmet Color
              * Face Color
              * Body Color
              * Hands & Feet Color
              * Arms & Legs Color
              * Backpack Color
              The buttons labeled 1 to 6 reset the colors to the default value
              of  XBlast.  Enabling  the Single Player option uses this colors
              also with a single player.

       Left Player
              This window can be used to set the color option for  the  second
              player  on  your  display  (if  any). Enabling the Single Player
              option uses this colors for the single player

       Select Color
              This window is a browser for  named  colors  available  at  your
              system.   On  its very first invocation, it will parse the local
              rgb.txt file for color names. It will create a color database of
              its  own  stored  in  the file ~/.xblast-rgb. You can change the
              color very easily, using the Select Color window:
              1. Click on the color entry in the Player  window  you  want  to
              change.
              2.  Click  on  the  color in the Select Color window you want to
              use.
              The buttons <<, <, >, >> are used to move forward  and  backward
              in the color list.

PLAYER RESOURCES SCREEN

       On this screen you can customize the name, messages and the keybindings
       for your player. The changes will be used your display as  well  as  on
       any other display. The lower part contains the following buttons:

       Apply  Pressing this buttons applies the selected player colors to your
              display, by invoking xrdb. They will be lost when you finish you
              X-session.   This  button  will  also be invoked, when you press
              Return key..PP

       Query  Pressing this button queries the current player colors from your
              display, via xrdb.

       Link to Defaults
              Pressing this button modifies your ~/.Xresources file to include
              the file ~/.xblast-player_colors, when being parsed.

       Load   Pressing this  button  loads  the  color  setup  from  the  file
              ~/.xblast-player_colors.

       Save   Pressing  this  button saves the current color setup to the file
              ~/.xblast-player_colors.

       Exit   Press this button to exit tkXBlast or press the Escape key.

       The actual screen contains several subwindows:

       Key Bindings
              The following key bindings can be cutsomized foreach player:
              * Go up
              * Go left
              * Go right
              * Go down
              * Stop
              * Drop bomb
              * Special action
              * Request abort
              * Cancel abort
              Each action can be bound to two different keys. Click on the key
              entry and then press the key you want to bind the action to.

       Single/Right Player
              In this window you can set the default name for your player.

       Single/Right Player
              In this window you can set the default name for your player.

       Left Player
              In  this  window  you  can  set  the default name for any second
              player on your display.

       Messages
              In this window you can  set  the  following  messages  for  your
              player:
              * Welcome Message
              * Gloat Message
              * Lose Life Message
              * Lose Level Message
              * Win Level Message
              * Win Game Message
              * Abort Request Message
              * Abort Cancel Message

SEE ALSO

       xblast(1), wish(1), xrdb(1)

BUGS

       The level selection cannot be saved
       tkXBlast hangs up, when you enter an invalid color name into one of the
       color entries.

COPYRIGHT

       Copyright (C) 1993-1996, Oliver Vogel (vogel@ikp.uni-koeln.de).

       This program is free software; you can redistribute it and/or modify it
       under  the terms of the GNU General Public Licences as published by the
       Free Software Foundation; either version 2; or  (at  your  option)  any
       later version

       This  program  is distributed in the hope that it will be entertaining,
       but  WITHOUT  ANY  WARRANTY;  without  even  the  implied  warranty  of
       MERCHANTABILITY  or  FITNESS  FOR  A  PARTICULAR  PURPOSE.  See the GNU
       General Public License for more details.

       You should have received a copy of the GNU General Public License along
       with  this program; if not, write to the Free Software Foundation, Inc.
       675 Mass Ave, Cambridge, MA 02139, USA.

AUTHOR

       Oliver Vogel (vogel@ikp.uni-koeln.de)

                       Release 2.2 (December 14th 1996)            tkXBlast(1)