chess++ documentation hendrik hochstetterchesspp.sourceforge.net/chesspp_documentation.pdf · but...

26

Upload: others

Post on 30-Sep-2020

7 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: Chess++ Documentation Hendrik Hochstetterchesspp.sourceforge.net/chesspp_documentation.pdf · but it may serve well as a starting point for writing your own rule sets. 3.1.1 3D pyramid

Chess++ Documentation

Hendrik Hochstetter

30th July 2009

c© H.A.H.M. Software Group

Page 2: Chess++ Documentation Hendrik Hochstetterchesspp.sourceforge.net/chesspp_documentation.pdf · but it may serve well as a starting point for writing your own rule sets. 3.1.1 3D pyramid

This documentation is work in progress.

2

Page 3: Chess++ Documentation Hendrik Hochstetterchesspp.sourceforge.net/chesspp_documentation.pdf · but it may serve well as a starting point for writing your own rule sets. 3.1.1 3D pyramid

Contents

1 Introduction to Chess++ 4

2 Where to obtain a copy of Chess++ 5

2.1 Prerequisites and dependencies . . . . . . . . . . . . . . . . . . . . . . . . . . . 52.2 Precompiled �les . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

2.2.1 Installing Chess++ under Windows . . . . . . . . . . . . . . . . . . . . 52.2.2 Installing Chess++ under GNU/Linux . . . . . . . . . . . . . . . . . . . 5

2.3 How to compile Chess++ from SVN . . . . . . . . . . . . . . . . . . . . . . . . 6

3 The Chess++ game logic 7

3.1 Standard rule sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73.1.1 3D pyramid chess . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

4 The Chess++ server: cheppd 8

4.1 Chess++ public server system: cheppdsync . . . . . . . . . . . . . . . . . . . . 84.2 Server con�guration: cheppd-setup . . . . . . . . . . . . . . . . . . . . . . . . . 8

4.2.1 Cheppdsync registration settings . . . . . . . . . . . . . . . . . . . . . . 10

5 The Chess++ client: chesspp 13

5.1 Playing your �rst game . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145.1.1 Starting new games and joining existing ones . . . . . . . . . . . . . . . 14

5.2 Of moving pieces - mouse navigation in Chess++ . . . . . . . . . . . . . . . . . 155.3 The tree widget . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165.4 Chatting in Chess++: Chat and command prompt widget . . . . . . . . . . . . 165.5 Shortcuts in chesspp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175.6 The settings dialogue - customise your chesspp . . . . . . . . . . . . . . . . . . 17

5.6.1 Chess display settings of the OpenGL widget . . . . . . . . . . . . . . . 185.6.2 Main window display settings . . . . . . . . . . . . . . . . . . . . . . . . 205.6.3 Settings of the chat widget . . . . . . . . . . . . . . . . . . . . . . . . . 21

5.7 Command line options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

A Contact us 24

B Index 25

3

Page 4: Chess++ Documentation Hendrik Hochstetterchesspp.sourceforge.net/chesspp_documentation.pdf · but it may serve well as a starting point for writing your own rule sets. 3.1.1 3D pyramid

1 Introduction to Chess++

Chess++ is a modern platform independent implementation of the game of chess (which doesnot mean that you can only play the classic game of chess but also every kind of chess youcan imagine in three dimensions with boards stacked on top of each other and so on...) andpublished under the GNU General Public License (GPL).In chapter 3 we will discuss our standard rules of 3d chess and how you can write your ownnew rule sets.

Chess++ is built up of three main units: the game logic, server, and client. To play agame you always have to have a server running because it's the server who hosts all gamesand makes use of the game logic engine. We developed a system for public servers but youmay also set up a private local one in your LAN at home.

The Chess++ server Cheppd (Chesspp daemon, abbreviated) hosts games and users. The�rst time you log in to a server an account with username and password you supplied will becreated for you (given the username is still available and valid).See chapter 4 for a thorough look at the server.

Chessp, our Chess++ client, is a highly customisable piece of software that displays chess in3d. You can use your own chess pieces if you provide them in one of the supported formats.The client will be discussed in detail in chapter 5.

Server and client both use Trolltech's Qt library. The client also makes use of OpenGL forgame display.

4

Page 5: Chess++ Documentation Hendrik Hochstetterchesspp.sourceforge.net/chesspp_documentation.pdf · but it may serve well as a starting point for writing your own rule sets. 3.1.1 3D pyramid

2 Where to obtain a copy of Chess++

We recently compile snapshots of our software and o�er them for download on Sourceforge.In section 2.2 you will learn how to install Chess++ from such a �le. Yet there still may beinteresting features in the development tree to check out (see Section 2.3).

2.1 Prerequisites and dependencies

As we make heavy use of Qt in our project, you have to have Qt installed in version 4.3 orhigher if you are under GNU/Linux. In the installer software for Windows the Qt librariesneeded are included. If you want to compile our software from SVN, you need a C++ compilerand also the Qt header �les.

2.2 Precompiled �les

The easiest way to get a running copy of Chess++ is to go to the donwload page of our projectat Sourceforge and download either the .msi �le for Windows or a .run for Linux (sorry, butwe do not provide any binary �les for other OSes.)

2.2.1 Installing Chess++ under Windows

Installing Chess++ under Windows is very easy as we o�er a comfortable .msi installer. Justdownload and run the �le, follow the instructions on the screen, and you are done.

After installing, Chess++ can be started from the Windows start menu. See chapter 5 tolearn how to use Chess++.

2.2.2 Installing Chess++ under GNU/Linux

As root, run the command sh chesspp_X.X.X_rXXX.Linux.run (where the Xs stand for someversion and revision numbers) from the directory where that �le is located. This will installChesspp, Cheppd, and Cheppd-setup in /usr/local/bin and the default set of pieces in/usr/share/chesspp.

Chesspp can now be invoked by typing chesspp into a terminal (if /usr/local/bin is in yoursystem's PATH variable.)

5

Page 6: Chess++ Documentation Hendrik Hochstetterchesspp.sourceforge.net/chesspp_documentation.pdf · but it may serve well as a starting point for writing your own rule sets. 3.1.1 3D pyramid

2.3 How to compile Chess++ from SVN

The current development tree can be obtained via SVN. You �rst have to set up an SVN client(e.g. from http://subversion.tigris.org/) that allows you to access our SVN repository.

Our SVN repository is at svn://samtronic.ath.cx/chesspp.

The easiest way to build our software is to use the tools we provide for Windows and Linux(not tested with other OSes). Download our chessppcheckout (chessppcheckout.bat if youare using Windows) script from our etc directory to some temporary folder(e.g. with svn checkout svn://samtronic.ath.cx/chesspp/etc/chessppcheckout.)Chessppcheckout is a script intended to assist you in compiling Chess++. Then copy thescript to the directory, you want to have Chess++ to be in, and simply run it and follow theinstructions on screen.

Caveat: Don't use the script in the directory you checked it out to and don't use it fromdirectory paths that contain spaces because it won't work then.

The script will then check out all source �les needed to compile Chess++ on its own, con�gureeverything, and compile it.

6

Page 7: Chess++ Documentation Hendrik Hochstetterchesspp.sourceforge.net/chesspp_documentation.pdf · but it may serve well as a starting point for writing your own rule sets. 3.1.1 3D pyramid

3 The Chess++ game logic

The Chess++ game logic is highly con�gurable. You can write your own rule set �les using asimple language which especially has been designed to describe Chess++ rule sets.

3.1 Standard rule sets

The standard rule sets are 2d_schach, 3d_würfel_schach, and 3d_pyramidal_schach,where schach is the German word for chess and würfel means cube. 2d_schach is the usualgame of chess and 3d_pyramidal_schach is what one could call real Chess++. 3d_würfel_schachactually is more of an example of a rule set then indended to be used as a rule for playing,but it may serve well as a starting point for writing your own rule sets.

3.1.1 3D pyramid chess

In 3D pyramid chess the board consists of 7 planes stacked on top of each other. The plane inthe middle is essentially a standard 2D chess board that contains 8 times 8 squares, 16 black,and 16 white pieces, just as in usual chess.

The planes above and below this central board are smaller and do not contain any pieces inthe start position. The sizes of the planes from centre to top or bottom are 8 times 8, 6 times6, 4 times 4, and 2 times 2, in either direction. Hence the 3D pyramid chess board looks like2 pyramids with their surface areas glued together.

Pieces can be moved just as in usual 2D chess with additional moves for the new directionsup and down, analogously.

7

Page 8: Chess++ Documentation Hendrik Hochstetterchesspp.sourceforge.net/chesspp_documentation.pdf · but it may serve well as a starting point for writing your own rule sets. 3.1.1 3D pyramid

4 The Chess++ server: cheppd

The Chess++ server - Cheppd - is responsible for managing user accounts and games. Italso allows users to chat with each other. (See section 5.4 for a description of how chattingworks in Chesspp.) Servers can either be public or private.

For managing public servers, we implemented a system called Cheppdsync that servers cansend their address, name, a unique server id, and some additional information to, periodically.How Cheppdsync works will be discussed in detail in section 4.1.

A private server is essentially the same thing as a public server, except for being con�gurednot to send information to Cheppdsync servers. See section 4.2 for how to con�gure Cheppd.

4.1 Chess++ public server system: cheppdsync

Cheppdsync is a system that manages public servers. Every public server periodically sendsit information to Cheppdsync to update its state. Every Chess++ client can then retrieve alist of public servers it can connect to. (The Cheppdsync �les can be found in the cheppdsyncdirectory of our svn tree.)

Cheppdsync is written in php and uses MySQL to store the public server data and also o�ersa web front-end to list public servers. (See http://chesspp.sourceforge.net/cheppdsync/for example.)

Currently, we are running three Cheppdsync servers that Cheppd servers can (and, by default,do if you activate your server) send their information to. As well as Chesspp requests publicserver lists from those three servers, by default. See subsection 4.2.1 for a description how toset up your Cheppd to register at Cheppdsync servers.

4.2 Server con�guration: cheppd-setup

The server is disabled by default, so the �rst, most important step in setting up Cheppd, isto enable it. You can do so using Cheppd-setup (see �gure 4.1) by just selecting "enableCheppd" from the drop-down list "Server enable". Cheppd-setup can be run either from theStart menu in Windows or by invoking cheppd-setup from the command line in GNU/Linux.

The default port for Cheppd to listen on is 11111. (Be sure to open that port in your router/ �rewall etc. if you want to set up a public server.)

8

Page 9: Chess++ Documentation Hendrik Hochstetterchesspp.sourceforge.net/chesspp_documentation.pdf · but it may serve well as a starting point for writing your own rule sets. 3.1.1 3D pyramid

Figure 4.1: Main settings for cheppd in cheppd-setup.

Figure 4.2: Settings for logging of cheppd server messages.

9

Page 10: Chess++ Documentation Hendrik Hochstetterchesspp.sourceforge.net/chesspp_documentation.pdf · but it may serve well as a starting point for writing your own rule sets. 3.1.1 3D pyramid

Figure 4.3: File and path settings for cheppd (under GNU/Linux).

4.2.1 Cheppdsync registration settings

By default, a unique ID will be generated for you, when starting cheppd-setup for the �rsttime. This ID will be used to identify your server at Cheppdsync if you have activated thisfeature. If you have moved your server to a di�erent machine you may want to copy the oldID to the new one. You can do so using the "Extended Settings" of the "Registration" tab ofCheppd-setup as shown in �gure 4.6. Simply close the window if you're ok with the settingsyou entered and apply by clicking "Accept" in the main window.

In the "Registration" tab (see �gure 4.5) you can set up the Cheppdsync servers to keep up todate with your server information. Simply type the addresses into the input �eld, separatedby spaces.

Here you can also activate and deactive Cheppdsync registration by selecting the appropriatevalue from the drop-down list.

10

Page 11: Chess++ Documentation Hendrik Hochstetterchesspp.sourceforge.net/chesspp_documentation.pdf · but it may serve well as a starting point for writing your own rule sets. 3.1.1 3D pyramid

Figure 4.4: Allocation of resources.

Figure 4.5: Settings for public server registration with cheppdsync.

11

Page 12: Chess++ Documentation Hendrik Hochstetterchesspp.sourceforge.net/chesspp_documentation.pdf · but it may serve well as a starting point for writing your own rule sets. 3.1.1 3D pyramid

Figure 4.6: Extended registration settings.

12

Page 13: Chess++ Documentation Hendrik Hochstetterchesspp.sourceforge.net/chesspp_documentation.pdf · but it may serve well as a starting point for writing your own rule sets. 3.1.1 3D pyramid

5 The Chess++ client: chesspp

The client side of Chess++ - Chesspp - allows you to play chess using an OpenGL widget.The main window (as shown in �gure 5.1 displays all games that are running on the server ina tree structure and allows you to chat with other users that watch the same game using thechat widget.

Figure 5.1: Chess++ main window with OpenGL widget, game tree, and chat widget.

Chesspp makes use of the Wavefront .obj format to load the pieces from, so you can even useyour own pieces if you provide them in obj format. (Blender, for example, supports exportingobj �les.)

After this brief overview of chesspp, let's start playing.

13

Page 14: Chess++ Documentation Hendrik Hochstetterchesspp.sourceforge.net/chesspp_documentation.pdf · but it may serve well as a starting point for writing your own rule sets. 3.1.1 3D pyramid

5.1 Playing your �rst game

Before you can start a new game or join an existing one, you have to log in to a server. Youcan either look for running public servers or set up your own server (as described in chapter4). Connections to both public and private servers can be established using the connectiondialogue.

This dialogue has three tabs for connections to public servers, connections to private servers,and for settings. The tab to use to connect to a public server is shown in �gure 5.2. If there are

Figure 5.2: Connection dialogue showing the list of running public servers you may log in to.

any public servers running, it will display them in the table in the centre (in the �gure thereis only the one server, realmofdarkness.zapto.org, running.) You can select one of the publicservers by clicking them in the list, they are displayed in. After you've chosen a server, you'resupposed to enter your username and password. If you've never logged in to that certainserver, yet, simply provide the username and password, you'd like to have. If username andpassword are valid and nobody else is already registered under that username, Cheppd willcreate that account for you and you'll be logged in.

If there are no public servers running, you may want to set up one as described in chapter 4and connect to that server using the dialogue for connecting to private servers as displayed in�gure 5.3. Logging in works in the same manner as in the case of a public server, but you haveto provide a server address which is localhost if you set up a server on your local machine.

5.1.1 Starting new games and joining existing ones

A game can be "entered" simply by double-clicking a game item in the game tree. (See section5.3 for a description of the game tree, it's icons, and how to use it.) After entering, you can

14

Page 15: Chess++ Documentation Hendrik Hochstetterchesspp.sourceforge.net/chesspp_documentation.pdf · but it may serve well as a starting point for writing your own rule sets. 3.1.1 3D pyramid

Figure 5.3: Connection dialogue showing the tab that allows you to log in to private servers.

take a party by either selecting "Game" → "Play white" (or "Game" → "Play black") fromthe main menu or from the menu that pops up after a right button click on the game in thetree.

Figure 5.4: Dialogue to create a game on the server you are currently using.

You can create new games using the dialogue of �gure 5.4, if there is no game, you can join.Simply select the one of the server's rule sets, you want to use from the drop-down list andenter a name for the game. Descriptions of the standard rule sets are given in section 3.1.Click "Ok" to send a request to create the game to the server. Any errors will be displayedin the chat widget.

5.2 Of moving pieces - mouse navigation in Chess++

Most of Chess++ can be controlled using your mouse (not the chat, of course). Clicking apiece or square of the board will select it. If your selected square contains a piece, everypossible target square for moving this piece to will be highlighted on the board (the colour

15

Page 16: Chess++ Documentation Hendrik Hochstetterchesspp.sourceforge.net/chesspp_documentation.pdf · but it may serve well as a starting point for writing your own rule sets. 3.1.1 3D pyramid

can be con�gured). If you select one of your pieces and click a highlighted square (or a piecethat is on one of them), your piece will be moved. (For convenience, your oppenent's possibletarget squares for a move will also be displayed if you select his pieces.)

Keep your left mouse button pressed and move your mouse inside the OpenGL widget torotate the board. Scrolling your mouse wheel brings you closer to the board or takes youfarther away from it. If you keep your right mouse button pressed while moving the mouse,the scene will be moved according to your mouse motion. Moving your mouse up and downwhile the middle button is pressed pulls the board planes (if your game uses a 3d rule set)apart or pushes them together. If you accidentally moved the scene out of view you can resetthe view to its origin using the shortcut Ctrl+R. See table 5.1 for a list of shortcuts for frequentactions.

5.3 The tree widget

If you are logged in to a server, every game that is running will be displayed in the game tree(on the left of the main window in �gure 5.1). The pattern of the knight (or king) that is usedas an icon for every game and player in the tree tells you in which state the game is and ifyou may join the game. A knight that is parted into four areas, coloured black and white inan alternating pattern, tells you that nobody is playing, yet. If the knight is black, somebodyhas already joined the game, playing as black. If it is white, somebody is already playing aswhite. And if one half is black and the other white, both parties are taken. A king as icon,instead of a knight, tells you that the game is in a check state and a king that is rotated 90degrees symbolises a �nished game.

You can adjust the size of the icons. To do so right-click the heading of the tree and select thedesired size from the submenu "Adjust icon size" from the popup menu that appears. Hereyou can also con�gure whether to hide or show the "State" and "Next" columns.

5.4 Chatting in Chess++: Chat and command prompt widget

The chat widget is not only capable of displaying (a subset of) HTML code and some built-in smileys (and of course icons of pieces), but also a command prompt to control parts ofChesspp. The screenshot for �gure 5.1 has been created using this chat widget / commandpromt (in the lower).

Commands begin with a "/" and may have parameters that have to be supplied. Parametersare separated from the command by spaces. Type "/help" in the chat widget to get a list ofall commands that are supported with a list of necessary parameters. The command "/help"with parameter "chat", so "/help chat", will display a list of all features of the chat, smileysand so on.

You can modify the appearance of (parts of) your text when chatting in many ways. Italic,bold and normal text may be displayed in every possible RGB-colour. To display a sectionof text in, e.g. italic, put the text in between [i] and [/i]. Colouring text works in exactly

16

Page 17: Chess++ Documentation Hendrik Hochstetterchesspp.sourceforge.net/chesspp_documentation.pdf · but it may serve well as a starting point for writing your own rule sets. 3.1.1 3D pyramid

the same manner, but you have to give the colour you want the text to have. You can givethe colour in either an HTML RGB code or use the prede�ned names for standard coloursas de�ned in the SVG standard. (See the W3C SVG page for the list.) Colouring your textin red is then accomplished by surrounding it with [color=red] or [color=#ff0000] and[/color]. You can also give a standard colour to display your text in (which doesn't a�ectthe colour seen by others). See section 5.6.3 for a description of the chat widget settings.

5.5 Shortcuts in chesspp

Table 5.1 lists common shortcuts that make playing Chess++ even more enjoyable.

Shortcut Action executed

F2 Toggles fullscreen modeCtrl+C Executes conenction dialogue (if not yet connected)Ctrl+D Disconnect from current server (if connected)Ctrl+N Create new game on server logged in toCtrl+P Executes properties dialogueCtrl+W Show change password dialogue (if connected to server)

Table 5.1: Shortcuts in chesspp

5.6 The settings dialogue - customise your chesspp

Chess++ is a highly customisable software system. You can set up any colour combinationyou like for the window itself, chess board, and pieces which includes transparency for theboard and pieces. You can use di�erent textures in the OpenGL game widget. There aredi�erent languages you can choose from and there is even a themeing system that allows youto save and export your settings to share them with other users. Most of these settings areadjustable via the chesspp settings dialogue.

The dialogue is divided into tabs and subtabs (see �gure 5.5) which group settings accordingto the part of the application, they are related to. Most of the settings a�ect the OpenGL

Figure 5.5: Tabs and GL Widget subtabs of the Chess++ settings dialogue.

widget.

17

Page 18: Chess++ Documentation Hendrik Hochstetterchesspp.sourceforge.net/chesspp_documentation.pdf · but it may serve well as a starting point for writing your own rule sets. 3.1.1 3D pyramid

5.6.1 Chess display settings of the OpenGL widget

You can adjust game display in many ways. You can set up di�erent colours for black andwhite pieces, squares, and use a coloured background. Pieces and squares can be decoratedwith textures that you can load from images on your machine. Moves can be animated sothat the pieces seem to disappear and reappear on the target square of their move.

Figure 5.6: Setup tab for transparent squares and pieces.

Transparency settings

"Activate piece transparency" has to be checked in order to have pieces displayed transparently.As stated in the dialogue, this involves sorting all objects in the scene. (Transparent objectsthat are closer to the viewing plane have to be rendered after those objects that are fartheraway when using transparency e�ects with alpha blending.)

If you have a very slow machine, you might want to switch piece transparency o�, to achievehigher frame rates.

You can also display pieces as wireframe objects, which also gives them a somewhat transparentlook, while piece transparency doesn't have to be activated.

18

Page 19: Chess++ Documentation Hendrik Hochstetterchesspp.sourceforge.net/chesspp_documentation.pdf · but it may serve well as a starting point for writing your own rule sets. 3.1.1 3D pyramid

Colour settings

Colours, and also transparency values, can be adjusted using the colour chooser dialogues inthe colour setup (see �gure 5.7) that appear when clicking "Change" for one of the values.The alpha value you can set up there, is the value for opacity (and so the reciprocal value

Figure 5.7: Settings tab for colouring the board and pieces.

of transparency). You shouldn't confuse the background colours, you can adjust here withthose for the main window. These here only a�ect the OpenGL widget. To display thebackground coloured, instead of black, you have to activate the checkbox "Show background"in the properties tab.

Animation settings

Moves can be animated by making pieces dissolve and then reappear on their target square.Selected squares can be highlighted (in addition to simple colouring) with a pulsating colour-ing. In the animation subtab of the settings dialogue (see �gure 5.8) you can set up the stepsize for every animation scene and the timer step size. Increasing the timer step size slowsdown animations (as it reduces the frame rate), while increasing the other step sizes increasesthe speed of the resepctive animation.

19

Page 20: Chess++ Documentation Hendrik Hochstetterchesspp.sourceforge.net/chesspp_documentation.pdf · but it may serve well as a starting point for writing your own rule sets. 3.1.1 3D pyramid

Figure 5.8: Settings tab for animation sequences.

5.6.2 Main window display settings

The Chesspp main window can be set up to use a freely con�gurable palette for background,buttons, text etc. or to simply use the palette of your window manager. Figure 5.9 displaysthe subtab of the settings window where you can adjust the colours.

You can also set up a start screen image that will be displayed in the OpenGL widget whileyou are not connected to a server or don't play a game.

Chess++ theme import and export

You can save your palette settings and all settings concerning game display to a �le using thesubtab shown in �gure 5.10. Here you can also import so-called themes using the "Import"button or by con�guring the path where to search for theme �les. If you use the "Import"button, the theme �le will be copied to your theme folder. Theme �les always end with .cpt.Please make sure that you have write permissions to your theme path if you want to use theimport function.

If you want to use a theme �le from the list of available themes, select it from the list andclick "Use selected theme" or simply double-click the item, and then "Apply" or "Ok".

20

Page 21: Chess++ Documentation Hendrik Hochstetterchesspp.sourceforge.net/chesspp_documentation.pdf · but it may serve well as a starting point for writing your own rule sets. 3.1.1 3D pyramid

Figure 5.9: Properties tab for main window colours and start screen.

5.6.3 Settings of the chat widget

The chat and command prompt widget can be modi�ed in its look using the settings tabshown in �gure 5.11. Here you can adjust the color for messages you send, messages youreceive and messages like hints from Chesspp or the server you are connected to. Time stampscan get added to every chat message and you can switch special formatting features for thechat on and o�.

Check "Use BBCode" if you want to enable the BBCode-like markup for chat messages (asdescribed in section 5.4). If you do not activate this option, all BBCode commands will simplybe stripped.

5.7 Command line options

If you play around with your settings and end up with a Chess++ client that isn't usableanymore, you can restore the default settings by invoking chesspp ��clear from the commandline.

Qt o�ers di�erent styles, you can choose from. A list of those styles can be found in thisgallery. The default style Chess++ uses, is Plastique. If you start Chesspp with chesspp

21

Page 22: Chess++ Documentation Hendrik Hochstetterchesspp.sourceforge.net/chesspp_documentation.pdf · but it may serve well as a starting point for writing your own rule sets. 3.1.1 3D pyramid

Figure 5.10: Tab for selection and export of themes.

��style=stylename Chess++ will be started using the Qt-style "stylename". (These Qtstyles are not to be confused with our Chess++-themes discussed in section 5.6.2.)

Invokation of chesspp ��version prints version information to the terminal and chesspp

��help lists all available command line arguments.

22

Page 23: Chess++ Documentation Hendrik Hochstetterchesspp.sourceforge.net/chesspp_documentation.pdf · but it may serve well as a starting point for writing your own rule sets. 3.1.1 3D pyramid

Figure 5.11: Settings of the chat and command prompt widget.

23

Page 24: Chess++ Documentation Hendrik Hochstetterchesspp.sourceforge.net/chesspp_documentation.pdf · but it may serve well as a starting point for writing your own rule sets. 3.1.1 3D pyramid

A Contact us

If you have any questions feel free to mail us (see below), visit our project page at source-forge.net, or the o�cial Chess++ homepage.

We, the developers, are:Hendrik Hochstetter ([email protected])Antoine Jacob ([email protected])Henning Mälzer ([email protected])Moritz Rathgeber ([email protected])

24

Page 25: Chess++ Documentation Hendrik Hochstetterchesspp.sourceforge.net/chesspp_documentation.pdf · but it may serve well as a starting point for writing your own rule sets. 3.1.1 3D pyramid

B Index

Symbols

3D pyramid chess . . . . . . . . . . . . . . . . . . . . . . . 7

A

animation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

C

chat. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

cheppd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8installation. . . . . . . . . . . . . . . . . . . . . . . . . .5port. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8unique id . . . . . . . . . . . . . . . . . . . . . . . . . . 10

cheppd-setup . . . . . . . . . . . . . . . . . . . . . . . . . . 8cheppdsync . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8cheppdsync registration . . . . . . . . . . . . . . . . 10chesspp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

command line options . . . . . . . . . . . . . . 21installation. . . . . . . . . . . . . . . . . . . . . . . . . .5restore default settings . . . . . . . . . . . . . 21settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17shortcuts . . . . . . . . . . . . . . . . . . . . . . . . . . 17themes . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20window style . . . . . . . . . . . . . . . . . . . . . . . 21

command prompt . . . . . . . . . . . . . . . . . . . . . . 16connect to server . . . . . . . . . . . . . . . . . . . . . . . 14contact. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .24create new game . . . . . . . . . . . . . . . . . . . . . . . 15create user account. . . . . . . . . . . . . . . . . . . . .14

D

dependencies . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

G

game logic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7gameplay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

I

installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

J

join game . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

L

log in to server . . . . . . . . . . . . . . . . . . . . . . . . . 14

M

mouse navigation . . . . . . . . . . . . . . . . . . . . . . 15

move pieces . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

N

new game . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

P

preriquisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

private server . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

public server . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

R

reset view . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

rule set. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7

S

server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

set up server . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

set up user account . . . . . . . . . . . . . . . . . . . . 14

settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

shortcuts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17

smileys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16, 21

standard rule sets . . . . . . . . . . . . . . . . . . . . . . . 7

25

Page 26: Chess++ Documentation Hendrik Hochstetterchesspp.sourceforge.net/chesspp_documentation.pdf · but it may serve well as a starting point for writing your own rule sets. 3.1.1 3D pyramid

T

transparency . . . . . . . . . . . . . . . . . . . . . . . . . . . 18tree widget . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16

W

watch game . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

26