Instructions for installing the Client
--------------------------------------

1) Copy the "matrix_client" folder (further on referred to as '$') to a machine that will run the game client application.
   It is recommended to use a different machine than one hosting the QMON, but it is not necessary.
2) Edit the "configuration.properties" file, in the "matrix_client" folder, to respond to IP address of the computer
   and wanted port number. Furthermore, the "NEXT_HOP" parameter must respond to IP address and the "hr.fer.teletk.SIP_STACK_PORT"
   port number of the QMON.
3) Modify the four files, in the "matrix_client" folder, that contain word "gallery" in their names so that IP address
   in the "Host" parameter corresponds to IP address of the computer hosting the game server.

In order to run the client application, the computer needs to have the following additional software installed:
- Microsoft Java Virtual Machine (MS JVM, version 5.00.3810 preferred),
- a Web browser (Internet Explorer preferred),
- VRML player/viewer for the particular Web browser, i.e. if Internet Explorer is used, Cortona VRML Client (version
  4.2) is preferred, and
- Java Media Framework (JMF) API (version 2.1.1e preferred).

The MS JVM and its upgrade can be downloaded from [1]. The VRML Client can be downloaded from [2]. The JMF can be
obtained from [3].

When the MS JVM is installed:
1) Enable the MS VM Java console and JIT compiler for VM in the "Tools->Internet Options->Advanced" section of the
   Internet Explorer.
2) Disable the use of Java (Sun) JRE, if installed, in the same section.

When the VRML Client is installed, the "classes.zip" and the "corteai.zip" files from the "C:\Program Files\Common Files\ParallelGraphics\Cortona"
folder need to be copied to the "$\lib\cortona" folder. When installing the JMF, mark all the checkboxes setup offers.
When the JMF is installed, the "jmf.jar" file from the "<JMF_folder>\lib" folder needs to be copied to the "$\lib"
folder.

After successful installation and configuration, start the client application by running "matrix_client/start.bat".

References:
[1] The Microsoft Corporation, MS Java Virtual Machine [Last accessed at: http://www.mvps.org/marksxp/WindowsXP/java.php]
[2] ParallelGraphics, Cortona VRML Client [On-line: http://www.parallelgraphics.com/products/cortona/]
[3] Sun Microsystems, Inc., Java Media Framework API (JMF) [On-line: http://java.sun.com/products/java-media/jmf/]


This product includes Xerces software (the "Xerces software") developed by the Apache Software Foundation (http://www.apache.org/).
The Xerces software is licensed under the Apache Software License, Version 1.1 (the "Xerces license"). See the file
"licenses/xerces.LICENSE" for the Xerces license.