CTOS Chess ----------- Version: 3.5 Released: October 1992. Installation: Use Installation Manager or Software Installation commands. CTOS Chess is a public domain program originally written in Fortran. Two Font files are released with CTOS Chess: Chess.26.Font - for B24, B26, B28, B38, B39 Chess.27.Font - for B27 only The file "Chess.Config", which will be installed into the directory, permits renaming of the Font file and the optional Audit and Save files. It also allows for setting some of the hard-coded game defaults. List or Type "Chess.Config" for further details. Known bugs and restrictions: ---------------------------- 1. CTOS Chess releases 3.3 and up will not run on CPU's lower than B24's, i.e B21, B22. 2. Problems may occur if Chess is run using the Classic operating system. The game was written and tested using the BTOS II and CTOS I operating system. 3. Different skill levels are not implemented. 4. The game cannot play against itself (demo mode). Changes in Release 3.5: ----------------------- 1. The 'Setup' command has been implemented for setting up game positions. 2. Pawns may be promoted to pieces other than Queens. Changes in Release 3.4: ----------------------- 1. Chess now works correctly on B39 systems (thanks to Kris Van Bogaert for supplying the patches). Changes in Release 3.3: ----------------------- 1. Code for older CTOS hardware, e.g. B21, B22, has been removed. Chess will only run on systems that support soft font files. 2. The Restore function now allows 'Pause' and 'Resume' by use of the and keys - see under commands below. 3. Chess will now accept moves without a delimeter between the 'from' portion and the 'to' portion, e.g. "D2D4" is legal. 4. A bug where Chess would allow castling when an opposition pawn was on the King's Pawn square and the king would have to pass through check to complete the castling move has been fixed. 5. If a game where CTOS was playing White was Saved, then Restored, and then Saved again, the Restore of the second Saved game would not work. This has now been resolved. Chess Commands: --------------- AUDIT - Toggles the Audit Trail option. BEEP - Toggles the Beep flag. DRAW - Ask for a draw. (not implemented). HELP - Displays help information. QUIT - Stops the game. RESIGN - Give up a lost position. RESTORE - Restore a saved position. SAVE - Save current position. SETUP - Setup game position. O-O - Castle Kingside. O-O-O - Castle Queenside. Commands may be abbreviated to the shortest form that still allows the command to be recognized, e.g. RESIGN can be abbreviated to 'RESI' but not to 'RES' as this will be confused with the RESTORE command. To move a chessman, enter the location the piece is moving from, a hyphen (optional) and the location the piece is moving to. An example is a pawn move from location E2 to E4. Your command would be entered as: E2-E4 (or: e2-e4). CTOS might counter with a move of E7-E5. When CTOS takes a man it will change the hyphen to an 'x'. Example: E5xD6 When a pawn reaches the 8th rank, CTOS will automatically promote it to a Queen. If you want to promote your pawn to a piece other than a Queen, specify the required piece in parenthesis immediately following the move that places the pawn on the 8th rank, e.g. D7-D8(K) this will promote the pawn to a Knight. The mnemonics to use when promoting pawns are: B = Bishop K = Knight R = Rook Q = Queen All keyboard input can be in upper or lowercase. No matter what colour you select the board will always display your pieces facing you. Keyboard Entry -------------- Key Action --- ------ GO Any one of these three keys can be used to NEXT terminate a move or command entry. RETURN BACKSPACE These two keys are used to delete one character DELETE at a time. CANCEL Deletes current entry. FINISH Same as Quit. HELP Displays help information. CANCEL Used to terminate Restore early. MARK Used to pause the Restore function. BOUND Used to resume the Restore function. Commands in detail ------------------ AUDIT ----- This is used to toggle the Audit Trail flag. The chess program stores each move in an array in memory regardless of the setting of the Audit flag. If the Audit option is not set at the start of the game but is set at some point during the game, all the moves up to that point in the game will be written to the Audit Trail from this memory array. Once the Audit flag is set all subsequent moves will be written to the Audit Trail until the option is reset. If the Audit flag is reset after Auditing has started, all following moves will be lost. If the Audit flag is set, entering this command will stop the auditing of moves to the Audit file, but will not close the file. The Audit flag can be set via an option in the Chess.Config file. Read the documentation in this file for further information about the available Audit options. BEEP ---- If the Beep option is set, a Beep will sound each time that CTOS makes a move. Entering the BEEP command at any time during the game will toggle the current setting of the option. This option can be set via an entry in the Chess.Config file. Also refer to the "RestoreBeep" option in the Config file. RESTORE ------- The Restore command is used to restore a position that has been saved in the Save file using the SAVE command. The Restore command must be entered at the beginning of the game, before you select the colour to play (it is invalid at any other time during the game). When the Restore command is entered, a Menu screen will be displayed listing the game positions available in the current Save file. You select the position that you want restored by entering the Slot number and pressing , , or . The saved position will be restored by replaying each move from the beginning of the game until the saved position is reached. The Restore function will pause before replaying each human move to allow you to halt the game at any time by pressing the key. To pause the Restore function temporarily press the key. To resume the Restore function press the key. SAVE ---- The Save command will store the moves making up the current position in a Save file. These moves can then be replayed at a later time and the current game position restored. A move can be 'taken back' by Saving the game, initiating a Restore, and pressing the key before the 'bad' move is restored. The name of the Save file is specified in the Chess.Config file. The maximum number of moves that can be stored by the Save command is 120. The maximum number of positions that can be stored in a single Save file is 35. If a Save file fills up you can either re-use one of the current Save positions, or rename the Save file and start a new Save file. A position that has been setup via the "Setup" command cannot be saved. Release Disk contents: ---------------------- Due to the size of the source files, CTOS Chess is released on two disks. One disk contains only the files required to run Chess plus the release notes. The other disk contains all the files required to recompile Chess. Disk: ChessRun-35 ----------- Name Description ---- ----------- Chess.Release.Notes This document. Chess.26.Font Font file for B24, B26, B28, B38, B39 Chess.27.Font Font file for B27 Chess.Config Configuration file used by Chess.Run. Chess.Run Chess run file. Disk: ChessSrc-35 ----------- Name Description ---- ----------- Chess.Release.Notes This document. BPL.h Include files. ChessD.h ChessE.h These files are used when recompiling ChessV.h the Chess game. Config.h CttimerX.h Chess.c 'C' source - main module. CMod1.c 'C' source - video handling routines. CMod2.c 'C' source - Audit and Save file handling routines. CMsg.c 'C' source - keyboard and message handling routines. Common.Libm Object library file containing modules required by the CMod2 chess module. Required for linking the Chess run file. Common.c 'C' source used for generating Common.Libm. Chess.Link Example submit file and associated @files Chess.Objects used for relinking the Chess run file. Chess.Libraries Chess.CFG Example CFG file used when compiling the Chess modules. Note: The 3.5 version of Chess was compiled using the "medium" model.