=============================================================================
Crosses - Noughts and Crosses                                    Version 1.12

(c) Stephen Fryatt, 1993-2020                               23 September 2020
=============================================================================


Licence
-------

  Crosses is licensed under the EUPL, Version 1.2 only (the "Licence"); you
  may not use this work except in compliance with the Licence.

  You may obtain a copy of the Licence at
  http://joinup.ec.europa.eu/software/page/eupl

  Unless required by applicable law or agreed to in writing, software
  distributed under the Licence is distributed on an "AS IS" basis, WITHOUT
  WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

  See the Licence for the specific language governing permissions and
  limitations under the Licence.

  The source for Crosses can be found alongside this binary download, at
  http://www.stevefryatt.org.uk/software

  The necessary libraries and build tools can be found at
  http://www.stevefryatt.org.uk/software/build



Installing Crosses
------------------

  Crosses requires RISC OS 3.1 or later, and can be run off a hard disc or
  floppy disc.  To install Crosses on a hard disc, copy the !Crosses
  application to a suitable place on your disc.



Using Crosses
-------------

  Crosses plays Noughts and Crosses.  To start the application, double-click
  on !Crosses in the directory viewer to place it on the iconbar.  Clicking
  Select on its icon will open the game window.

  By default, Crosses presents a standard two-dimensional board with X moving
  first and the computer playing O.  Click on a grid square to place an X;
  the computer will then place an O to follow it.  If the computer player is
  turned off, clicks on the grid will alternately place Xs and Os.

  The game ends when either one of the players gets a row of three of their
  symbols, or the board is full; in the latter case, the game is considered a
  draw.  The winning row (or rows) will be highlighted in the grid.

  A new game can be started by clicking Menu over the game window and
  selecting 'New game'; selecting 'Reset scores' will reset the scoreboard.
  If the current game has finished, clicking Select on Crosses' iconbar icon
  will also start a new game.


  3D Games
  --------

  In addition to the standard two-dimensional, three by three playing playing
  grid, Crosses can play a three-dimensional game.  If the '3D game' option
  is selected in the Choices dialogue, then three grids are shown
  side-by-side.  These are treated as being stacked on top of each other to
  form a cube: if an X were placed in the top-left square of each grid they
  would form a vertical row down through the cube.

  Playing in 3D is the same as playing in the more familiar 2D, except that
  there are now 49 possible winning rows instead of eight.


  Changing the game options
  -------------------------

  A number of options can be selected by selecting 'Choices...' from the
  iconbar menu to access the Choices dialogue.

  The 'Player X' and 'Player O' sections allow the two players to be
  configured.  Selecting 'Player's name' allows a name to be entered into the
  field below: this will then be used instead of "X" and "O" in the game
  window.

  Under 'Player O', the 'Computer player' option will allow the person
  playing O to be switched between human and computer.

  The 'Scoring' section allows some control over the way that games are
  scored.  The 'Score draws' option controls whether drawn games count
  towards the scoreboard values (being attributed to both players).  The
  'Count games' option can be turned on to display the number of games in the
  scoreboard.

  '3D game' selects a three-dimensional game, instead of the more
  conventional two-dimensional one.

  Once the options have been set, clicking 'Set' will apply them.  Clicking
  'Cancel' with Select will forget any changes and close the dialogue; with
  Adjust it will reset the dialogue to the state it was in when it was last
  opened.  Any changes which directly affect the game will come into effect
  when the next new game is started.



Version History
---------------

  Here is a list of the versions of Crosses, along with all the changes made.


  1.00 (26 May 1993)
  ------------------

  First stable release.


  1.01 (24 December 2004)
  -----------------------

  * Fixed bug which prevented correct scoring if a human beat the computer.


  1.10 (21 September 2014)
  ------------------------

  Second stable release.

  * Build system revised and license updated to EUPL.
  * 'Help' menu entry added to iconbar menu.
  * 'Website' button added to program information window.
  * Support added for Interactive Help.
  * Menus remain open when selections are made with Adjust. (Ticket #500)
  * Choices dialogue made static and updated to follow Style Guide
    conventions. (Ticket #528)
  * Updated application sprites.
  * Rationalised iconbar actions.
  * Added main window menu to start new games and reset scores. (Ticket #527)
  * Updated to follow RISC OS 3 conventions: don't waste time taking unwanted
    user messages or null events, and move private sprites out of the Wimp
    pool. (Ticket #526)
  * Add 3D game from XOX3D.


  1.11 (5 March 2017)
  -------------------

  Update to second stable release.

  * Fix !Help so that 'Help' menu items work correctly.
  * Tidy up icon creation and Wimp message handling code.


  1.12 (23 September 2020)
  ------------------------

  Update to second stable release.

  * Licence updated to EUPL v1.2.
  * Use ResConf-style system variables to identify resources.



Updates and Contacting Me
-------------------------

  If you have any comments about Crosses, or would like to report any bugs
  that you find, you can email me at the address below.

  Updates to Crosses and more programs for RISC OS computers can be found
  on my website at http://www.stevefryatt.org.uk/software/

  Stephen Fryatt
  email: info@stevefryatt.org.uk
