Four-in-a-Row Manual
The object of Four-in-a-Row is to place four pieces in a vertical, horizontal, or diagonal row while the opponent tries to block and make his orher own row of four. Four-in-a-Row can be played against another human or the computer.

Introduction
Four-in-a-Row is a four-in-a-row game for the GNOME Project. The object of the game is to build a line of four of your marbles while trying to stop your opponent (human or computer) building a line of his or her own. A line can be horizontal, vertical or diagonal.
To run Four-in-a-Row, select Four-in-a-Row from the Games submenu of the Main Menu, or type gnect on the command line.
Four-in-a-Row is included in the gnome-games package, which is part of the GNOME desktop environment. This document describes version 2.8 of Four-in-a-Row.
Four-in-a-Row also features multiplayer support with two human players in hotseat mode.

Basic Usage

Playing Four-in-a-Row
To start a new game of Four-in-a-Row choose Game New Game.
The game board consists of seven columns and six rows. Above it, a special row indicates the current player and the marble about to be played. Each move consists of dropping a marble in one of the columns. The marble lands on the topmost empty row of the chosen column.
To make a move, click on a column with the mouse. To play with the keyboard, move the marble in the top row with the left and right arrow keys, and drop it in place with the down arrow key. Your marble will drop into the topmost empty row of that column.
Four-in-a-Row's Main Window
Four-in-a-Row's Main Window
The game is won when one of the two players manages to line up four of his or her marbles horizontally, vertically or diagonally. If the board fills up without a win, the game ends in a draw.

Commands
To take back a move, choose Ctrl Z Undo move . If you're playing against a friend, this will undo one move. If you're playing against the computer, this will undo the computer's last move and then yours. Repeating this will return the board to its initial state.
Choose Ctrl H Hint to get a suggestion from the computer for your next move. This is shown in the status bar.
Choose Scores to show a tally of wins and draws for the current playing session. The scores will be reset to zero if Player Selection is changed in Preferences.

Preferences
To change the game's settings, select Preferences from the Settings menu. This opens the Preferences Dialogue.
Configuration options in the Game tab are:
Player One and Player Two 	 These two columns tell Four-in-a-Row who's playing and, if it is the computer, how hard they play. To play against a friend, select Human for both Player One and Player Two.
Theme 	 The theme menu lists available themes and lets you choose your favourite.
Enable Animation 	 Here you can toggle the game's animation on or off.
Finally there is a Controls tab to change the keyboard controls. To change a control, double click the appropriate entry and then press the new key.

Creating New Themes
This section is included in case you'd like to make your own themes for Four-in-a-Row. It assumes you're familiar with basic text editing, graphics software and the command line.

Images
Four-in-a-Row's tile sets contain six tiles of equal size, lined up horizontally. From left to right:
Player One's marble as it appears on the game board
Player Two's marble as it appears on the game board
The game board's background
The top row's background
Player One's marble as it appears on the top row
Player Two's marble as it appears on the top row

An example tile set
This image shows the six tiles in a tile set
Tiles three and four will be repeated over the game board and top row unless a full window background image is specified in the theme file.

TIP
PNG format is recommended for tile sets. The first, second, fifth and sixth tiles should contain some transparency if you want the background to show through. The third and fourth tiles should be solid, with no transparency, even if you'll be using a full window background image with your theme.

TIP
Tiles can be square or rectangular, and any size you like. Most of the tile sets that come with Four-in-a-Row use square tiles measuring 50 pixels by 50 pixels.
For a full window background image, there's a bit more work to do. Let's say your tiles measure 50 by 50 pixels each. The game's display measures 7 by 7 tiles, including the top row, so the ideal background image for your tile set measures 350 by 350 pixels.

TIP
Four-in-a-Row will automatically scale the background image if it doesn't match the tile set. This means you can make "large" and "small" versions of your theme, both using the same background image, just by having a large and a small version of your tile set.
So, you now have a tile set and perhaps a background image to go with it. The next step is to put them in the right place.

Putting It Together
The last step is to put your image or images where Four-in-a-Row can find them. You could put them in Four-in-a-Row's install directory (which will depend on your particular system), but your home directory is probably a better idea.
Make a ~/.gnect directory, and a ~/.gnect/pixmaps directory. Those names are important, as Four-in-a-Row won't look anywhere else.
Copy your image(s) into the pixmaps directory.
If you start Four-in-a-Row from the command line, it'll give you clues about any problems it has with your new theme. If it has none, you'll find your new theme listed the Preferences Dialogue.
Have fun!

Known Bugs and Limitations
Occasionally a marble-dropping animation doesn't look as smooth as it should.

Authors
Four-in-a-Row was written by Timothy Musson (trmusson@ihug.co.nz) and David Neary (bolsh@gimp.org). Various others have taken the time to help in many ways since work on Four-in-a-Row began.
The Velena Engine, Four-in-a-Row's main computer player, was written by Giuliano Bertoletti. We're grateful to him for allowing us to include his work, without which Four-in-a-Row wouldn't be nearly as worthwhile.
This manual was written by Timothy Musson.
To report a bug or make a suggestion regarding this application or this manual, follow the directions in this document.

Licence
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public Licence as published by the Free Software Foundation; either version 2 of the Licence, or (at your option) any later version.
This program is distributed in the hope that it will be useful, 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.
A copy of the GNU General Public License is included as an appendix to the GNOME Users Guide. You may also obtain a copy of the GNU General Public License from the Free Software Foundation by visiting their Web site or by writing to

        Free Software Foundation, Inc.
        59 Temple Place - Suite 330
        Boston, MA 02111-1307
        USA