GTKBALLS(6x)

NAME
gtkballs - A simple logic game

SYNOPSIS
gtkballs [options]

DESCRIPTION
This manual page documents GtkBalls. GtkBalls is a simple logic game. The goal of this game is to make the highest score by matching a number of balls of the same color in a horizontal, vertical or diagonal line. For further information on how to play this game refer to the rules section in this manual page.

OPTIONS

--display [hostname:dpy]
    Specify what display GtkBalls should use. See X (1x) for more information on the syntax of hostname and display.

RULES
The play area of GtkBalls is a 9x9 grid. When GtkBalls is first started a number of balls are placed in a random manner on the grid. Balls can be in seven different colors (red, green, blue, cyan, brown, pink, yellow). You may move balls on the grid by clicking them and clicking an empty square on the grid as destination for the ball you selected. Balls will only move if they are not blocked by other balls. Each time you move a ball, unless you score some points , new balls appear in a random manner on the grid. If the grid is full then the game is lost. However this is bound to happen, your goal is to make the highest score. In order to do this you must make lines in a vertical, horizontal or diagonal way with balls of the same color. A line must have at least five balls of the same color. Making a line of five balls will earn you ten points for your score. If you make lines over five balls it will earn you even more points. In order to help you decide which ball you are going to move, there is an indicator on top of the grid that shows what colors the next balls that will appear on the grid will be.

USING THE INTERFACE
GtkBalls is a graphical program using the Gtk+ windowing toolkit. This section describes it's user interface.

  THE GAME MENU

New Selecting this menu entry will abandon the current game and start a new one or start another game if you just finished one. You may use the keyboard shortcut CTRL-N to do this also.

Hall Of Fame
    Selecting this menu entry will open a dialog box showing the high scores. Only the ten best scores are shown. This dialog also displays the name of the person who achieved a high score and it's date.

Quit
    Selecting this menu entry will quit GtkBalls. You may use the keyboard shortcut CTRL-Q to do the same thing.

  THE SETTINGS MENU

Preferences
    Selecting this menu entry will open the Preferences dialog box. You may use the keyboard shortcut CTRL-P to open it also. This dialog box allows you to set some options. Click on a check box to activate or deactivate them. Then click on the Apply button to save your settings. You can disable the showing of footprints, path of the ball, and color of the next balls indicator from this dialog box.

  THE HELP MENU

About
    Selecting this menu entry will display a dialog with the logo and the copyright information of GtkBalls. For more details on the license, click on the Show license button. This will open another dialog box where you can read the GNU General Public License.

SEE ALSO
The GtkBalls web site at: http://gtkballs.antex.ru

AUTHORS
GtkBalls was created by Eugene Morozov <jmv@lucifer.dorms.spbu.ru>. This manual page was created by Christoph Thompson <obituary@freshmeat.net>

COPYRIGHT
GtkBalls is copyright 1998, 1999 Eugene V. Morozov under the terms of the GNU General Public License. GtkBalls is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the license, or (at your option) any later version.