xMaze v1.3.1     README 17-07-11

Not tested much.


0. CONTENTS OF THIS FILE
========================

1. INTRODUCTION

2. REQUIREMENTS

3. INSTALLATION

4. LICENSE, COPYRIGHT, DISCLAIMER

5. CONTACT

6. CREDITS

7. SUPPORT AND DONATIONS

8. HISTORY

9. RESTRICTIONS


1. INTRODUCTION
===============

This is the xMaze v1.3.1 port for OS/2 and eComStation.

xMaze is a random maze generator. Maze complexity is highly customizable in terms of size, 
number of trails, turn frequency and crossing. A performant recursive algorithm is used to 
check if generated mazes are solvable. Valid path are stored and navigated by the computer. 
A new maze is created each time all valid trails have been completed by the computer driven 
automatic players. 
A manual player can be added on option, to compete against the computer driven players. 
A separated thread is used to generate new mazes while the old one is being navigated, 
to reduce dead times. xMaze uses either pseudo or true transparency both for its main window 
and its score window. It also has the ability to use a KDE plasma like SVG picture as a background.

2. REQUIREMENTS
===============

* klibc 0.6.3 or later

    ftp://ftp.netlabs.org/pub/gcc/libc-0_6_3-csd3.wpi

* Qt4 dll

    ftp://ftp.netlabs.org/pub/qt4/4.6.2/qt-lib-4_6_2.wpi

* Gcc 4.5.2 dll
    http://download.smedley.info/gcc452.zip


3. INSTALLATION
===============
          
To install xMaze , do the following:

klibc
-----

  1. Download klibc 0.6.3 csd3 or later.
  2. Install the package by double-clicking on the WPI file.


Qt4 dll
-------

  1. Download the package.
  2. Install the package by double-clicking on the WPI file.


Gcc dll
-------
  1. Download the package.
  2. Install the package by extracking the zip file.


xMaze 
--------

  1. Create a directory for xMaze.
  2. Extract the xMaze package to the new directory.
  3. Create a WPS object for xMaze.exe
  4. Start xMaze 
  5. Enjoy the app
  


4. LICENSE, COPYRIGHT, DISCLAIMER
=================================

(C) 2007-2011 Hugo PEREIRA <hugo.pereira@free.fr>  http://www.phenix.bnl.gov/WWW/publish/hpereira/software/index.php?page=package&package_list=software_list_qt4&package=xmaze&full=0
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.



5. CONTACT
==========

Please send bugreports to:

  elbert.pol@gmail.com

Only bug reports with a reproducable bug are accepted. :-)



6. CREDITS
==========

The port was done by:

Elbert Pol

Thanks go to:

  * Dmitry A. Kuminov
  * Silvan Scherrer
  * Herwig Bauernfeind

They either helped me when I had some nasty questions or did some testing for me.


7. SUPPORT AND DONATIONS
========================

xMaze  is based on volunteer work. If you would like to support further
development, you can do so in one of the following ways:


  * Donate to the Qt4 project: see qt.netlabs.org for more information

  * Contribute to the project: Besides actual development, this also includes
    maintaining the documentation and the project web site as well as help
    for users.


8. HISTORY
==========

Compiled now with Qt4.6.3 GA

Version 1.2

Added a direct interface to Plasma (the KDE transparent gadgets), that can load the system 
Svg theme rather than the application user-defined one.
On other platforms (such as windows), or if KDE is not the desktop manager, the user-defined 
Svg theme, if any, is used.
Changed text shadow to use some blurring rather than sharp offset.
