Chess Manual
glChess is a game for playing the classic board game of chess, in which two players simulate a battle by capturing the opponent's pieces and ultimately the king. It can be played in 2D or 3D mode, full screen or in a window.

Introduction

Overview of Chess
Chess is a two-player strategy board game. glChess is a 2D/3D chess game, where games can be played between a combination of human and computer players. glChess detects known third-party chess engines for computer players. The game was originally developed by Robert Ancell; now the game is included in gnome-games.
glChess is written in Python and uses GTK+ and Cairo to render the chess board. 3D support is optionally available using OpenGL, using the Python OpenGL and GtkGLExt libraries. As with most modern 3D programs hardware acceleration is recommended but it should run OK in software. glChess is bundled with GNU Chess as the default chess AI. glChess can be played in network mode against other players on the Internet.
Chess is played on a square chessboard, consisting of 64 squares of alternating colour. Each player begins the game with sixteen pieces: one king, one queen, two rooks, two knights, two bishops, and eight pawns. One player controls the white pieces and the other player controls the black pieces; the player that controls white is the first to move. The players take turns moving pieces; certain moves involve a "capturing" of an opponent's piece, removing it from the chessboard. The object of the game is to checkmate the opponent's king. This occurs when the king is under immediate attack (in check) and there is no way to remove it from attack on the next move. Theoreticians have developed extensive chess strategies and tactics since the game's inception.
The current form of the game emerged in South Europe in the second half of the 15th century after evolving from similar, much older games of Asian origin. Chess is one of the world's most popular board games. The tradition of competitive chess began in the 16th century. The first official World Chess Champion, Wilhelm Steinitz, claimed his title in 1886; his modern equivalent, Vladimir Kramnik, is the 14th Champion in the lineage. There are also biennial world team events called Chess Olympiads. Since the 20th century, two international organisations, the World Chess Federation and the International Correspondence Chess Federation have organised and overseen the top chess competitions and international titles.
One of the goals of early computer scientists was to create a chess-playing machine, and today's chess is deeply influenced by the overwhelming abilities of current chess programs. In 1997, a match between Garry Kasparov, then World Champion, and IBM's Deep Blue chess program proved that computers are able to beat even the strongest human players.
To run glChess, select Chess from the Games submenu of the Main Menu, or type glchess on the command line.

Playing glChess

Main game window
Starting glChess displays the main game window as shown below. The game is played by moving chess pieces using the mouse. Each player alternates to move a piece in the appropriate colour, from one board position to another valid board position. The main game window is organised in three main areas: In the top menu and toolbar area, most common game actions can be made. The chess board is in the middle of the window, where the game is played by moving chess pieces using the mouse. Finally, the game history panel is shown at the bottom, where information about the game history, the remaining move time and buttons for showing previous or next moves are available.

Main window in glChess
Main window in glChess.

Starting a new game
To start a new game, press the New Game button on the toolbar. The new game dialogue is then shown, which allows you to setup a new game with the settings of your choice. In the game properties section, the game name and time limit for each player's move is set. In the players section, it is possible to setup the number of human and AI players. If you have installed any supported chess engines as AI players, these will be displayed in the list of available players. Finally, the difficulty setting of the AI players is set in the difficulty section.

Start new game dialogue
Start new game dialog for glChess.

Menus
The menu bar, located at the top of the Main Window, contains the following menus:
Game 	 This menu contains:
Ctrl+N New This starts a new game of Chess.
Ctrl+O Open Loads a previously saved game.
Ctrl+S Save Saves the current game of chess.
Save As Saves the current game of chess with a new filename.
Ctrl+L Network Game This starts a network multiplayer game using GGZ Gaming Zone.
Resign To concede loss of the game, so that the opponent wins the game.
Claim Draw If a claimed draw is accepted, the game ends without victory for either player.
Ctrl+Q Quit Ends the game.
View 	 This menu contains:
F11 Fullscreen Shows the game window in fullscreen mode.
3D Chess View Enables 3D chess view mode using OpenGL. This requires Python OpenGL and Python GTKGLExt installed, in addition to a 3D graphics card setup properly. Please contact your system administrator if you have problems, either way you will always be able to play chess in 2D mode.
Show Logs Show logs for debugging glChess and the active chess AI engines.
Settings 	 This menu contains:
Preferences This opens your window to edit preferences.
Help 	 This menu contains:
F1 Contents Display this manual.
About This opens the About dialog which shows basic information about glChess, such as the author's name, the version number of the game.

Chess Rules

The Rules of Chess
Chess is played on a square board of eight rows (called ranks and denoted with numbers 1 to 8) and eight columns (called files and denoted with letters a to h) of squares. The colours of the sixty-four squares alternate between light and dark, and are referred to as "light squares" and "dark squares". The chessboard is placed so that each player has a white square in the near right hand corner, and the pieces are set out as shown in the diagram, with each queen on a square that matches its colour.
Each player begins the game with sixteen pieces: each player's pieces comprise one king, one queen, two rooks, two bishops, two knights and eight pawns. One player, referred to as White, controls the white pieces and the other player, Black, controls the black pieces; White is always the first player to move. The colours are chosen either by a friendly agreement, by a game of chance or by a tournament director. The players alternate moving one piece at a time (with the exception of castling, when two pieces are moved at the same time). Pieces are moved to either an unoccupied square, or one occupied by an opponent's piece, capturing it and removing it from play. With one exception (en passant), all pieces capture opponent's pieces by moving to the square that the opponent's piece occupies.

King
When a king is under direct attack by one (or possibly two) of the opponent's pieces, the player is said to be in check. When in check, only moves that remove the king from attack are permitted. The player must not make any move that would place his king in check. The object of the game is to checkmate the opponent; this occurs when the opponent's king is in check, and there are no moves that remove the king from attack.
The king can move only one square horizontally, vertically or diagonally. Once in the game, each king is allowed to make a special double move, to castle. Castling consists of moving the king two squares towards a rook, then moving the rook onto the square over which the king crossed. Castling is only permissible if all of the following conditions hold:
The player must never have moved both the king and the rook involved in castling.
There must be no pieces between the king and the rook.
The king may not currently be in check, nor may the king pass through squares that are under attack by enemy pieces. As with any move, castling is illegal if it would place the king in check.
The king and the rook must be on the same rank (to exclude castling with a promoted pawn).

Rook
The rook moves any number of vacant squares vertically or horizontally (it is also involved in the king's special move of castling).

Bishop
The bishop moves any number of vacant squares in any direction diagonally. Note that a bishop never changes square colour, therefore players speak about "light-squared" or "dark-squared" bishops.

Queen
The queen can move any number of vacant squares diagonally, horizontally or vertically.

Knight
The knight can jump over occupied squares and moves two spaces horizontally and one space vertically or vice-versa, making an "L" shape. A knight in the middle of the board has eight squares to which it can move. Note that every time a knight moves, it changes square colour.

Pawns
Pawns have the most complex rules of movement: A pawn can move forward one square, if that square is unoccupied. If it has not moved yet, the pawn has the option of moving two squares forward, if both squares in front of the pawn are unoccupied. A pawn cannot move backward. When such an initial two square advance is made that puts that pawn horizontally adjacent to an opponent's pawn, the opponent's pawn can capture that pawn "en passant" as if it moved forward only one square rather than two, but only on the immediately subsequent move. Pawns are the only pieces that capture differently than they move. They can capture an enemy piece on either of the two spaces adjacent to the space in front of them (i.e., the two squares diagonally in front of them), but cannot move to these spaces if they are vacant. If a pawn advances all the way to its eighth rank, it is then promoted (converted) to a queen, rook, bishop, or knight of the same colour. In practice, the pawn is almost always promoted to a queen.

Remaining movement rules
With the exception of the knight, pieces cannot jump over each other. One's own pieces ("friendly pieces") cannot be passed if they are in the line of movement, and a friendly piece can never replace another friendly piece. Enemy pieces cannot be passed, but they can be "captured". When a piece is captured (or taken), the attacking piece replaces the enemy piece on its square (en passant being the only exception). The captured piece is thus removed from the game and may not be returned to play for the remainder of the game. The king cannot be captured, only put in check. If a player is unable to get the king out of check, checkmate results, with the loss of the game.
Chess games do not have to end in checkmate — either player may resign if the situation looks hopeless. Games also may end in a draw (tie). A draw can occur in several situations, including draw by agreement, stalemate, threefold repetition of a position, the fifty move rule, or a draw by impossibility of checkmate (usually because of insufficient material to checkmate).

Timed Games
Games can be played with a time limit by setting a move time when creating a new game. In timed games each player has a certain amount of time available for deciding which moves to make, and the time remaining for each player decreases only when it is their turn to move.

Game Draw
A game that ends without victory for either player. Most drawn games are draws by agreement based upon the rules. The other ways that a game can end in a draw are stalemate, three-fold repetition, the fifty-move rule, and insufficient material. A position is said to be a draw (or a drawn position) if either player can, through correct play, eventually force the game into a position where the game must end in a draw, regardless of the moves made by the other player.

Stalemate
A stalemate is a position in which the player whose turn it is to move has no legal move and his king is not in check. A stalemate results in an immediate draw.

Threefold repetetion
The game is drawn if the same position occurs three times with the same player to move, and with each player having the same set of legal moves each time (the latter includes the right to take en passant and the right to castle).

Fifty move rule
The fifty move rule states that the game is drawn after fifty moves from each side without a pawn move or capture.

Insufficient material
An endgame scenario in which all pawns have been captured, and one side has only its king remaining while the other is down to just a king or a king plus one knight or one bishop. The position is a draw because it is impossible for the dominant side to deliver checkmate regardless of play. Situations where checkmate is possible only if the inferior side blunders are covered by the fifty-move rule.

Game Settings

Game Preferences
This preference dialogue allows you to modify board orientation, move format and promotion type.

Game preferences dialogue for glChess
Game preferences dialog for glChess.

View Preferences
This preference dialogue allows you to modify the look and feel of glChess.

View preferences dialogue for glChess
View preferences dialog for glChess.

Chess Engines
glChess should be able to use any Chess Engine Communication Protocol or Universal Chess Interface compatible chess engines, including these chess engines:
GNUChess
Sjeng
Amy
Crafty
Faile
Phalanx
Glaurung
HoiChess
Diablo
BBChess
Fruit
Amundsen
Shredder
Toga II
Boo's Chess Engine

Known Bugs and Limitations
There are no documented bugs or limitations in glChess. To find areas where you can help improve glChess, please refer to the TODO file which is distributed with the game.

Authors
glChess was written by Robert Ancell, and is now maintained in gnome-games. This documentation was originally written by Andreas Røsdal, with input from several GPL sources. 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 Licence 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