README for running Trine 2 on the OpenSUSE Linux distribution.

- Trine 2 most likely requires specific library packages to be installed on
  the OpenSUSE linux distribution.

- The following instructions assume that you would be using the OpenSUSE 12.1,
  the 64 bit version.

- Similar instructions should apply to any other quite recent OpenSUSE
  distributions as well, but you may have to change some of the library names
  to match your distribution.


1. Installing the required libraries
------------------------------------

To install the required libraries for the OpenSUSE 12.1 distribution,
you should run the following commands (assuming you do not
have the packages already installed, and assuming you have sudo privileges).

sudo /sbin/yast --install zlib-32bit
sudo /sbin/yast --install libfreetype6-32bit
sudo /sbin/yast --install gtk2-tools-32bit
sudo /sbin/yast --install libpng12-0-32bit
sudo /sbin/yast --install libvorbis0-32bit
sudo /sbin/yast --install libvorbisfile3-32bit
sudo /sbin/yast --install libopenal1-soft-32bit

Also, notice, that you might already have some conflicting / newer package
installed so you should consider keeping your existing libraries instead,
should some of the packages conflict with an existing one.


2. Figuring out why the game isn't starting
-------------------------------------------

If you still get some issues trying to start the game (for example, nothing
seems to happen when you click Launch from the Trine 2 launcher), follow
these instructions...

To see which libraries are missing, or if there is some additional information
available, you can run the following commands in the trine 2 install directory.

Starting the game manually from a terminal (may provide some additional info):

export LD_LIBRARY_PATH=./lib/lib32
bin/trine2_linux_32bit

Or by listing at the required library files manually:

export LD_LIBRARY_PATH=./lib/lib32
ldd bin/trine2_linux_32bit
ldd bin/trine2_linux_launcher_32bit

These commands will list you the libraries that the game binaries depend on.
Look for any library lines that say: not found

If any libraries are listed as not found, you may have to figure out which
additional packages are missing. If its libGL or libGLU, see further below.


3. Having appropriate display drivers
-------------------------------------

Regarding any missing libGL or libGLU libraries, you'll probably
need to install the proprietary ATI or NVIDIA graphics drivers for your
graphics card.

Any other display drivers / opengl implementation might work, if they
have adequate shader support, etc. but they are not officially supported.

If your system lists mesa as the libGL provider (see the ldd output as
instructed above), you probably have the software Mesa GL installed.
It is likely that the game starts with those libraries, but it will not work
correctly and will not be playable.


4. Still not working?
---------------------

If you still cannot get the game working after doing the steps above, please,
go see the game support website / forums for possible solutions.