 /********************************************************\
| Professeur's TripMaker v0.5 beta - "The no-stars plugin" |
 \********************************************************/



* This is the second public release of TripMaker. It should run well on most OpenGL cards.
* I forgot last time to give some credits in the README file. Here it is:
  This plugin is based on Squee's Spectrum3D plugin, which is the base for most of the
  OpenGL plugins for Winamp. From what I know, Squee was the first one to get OpenGL working
  with a Winamp plugin, and his source code is fully available. TripMaker would have never 
  existed if he hadn't published it, so I send him many (telepathical :) thanks. URL of his
  page: http://www.graphics.cornell.edu/~ewong/spectrum3d

// What's new:

- The config box is better and more complete
- Fog has been implemented. The black hole at the end of the tunnel will not be regretted ;)
  Note that it can be disabled (because it doesn't work with the new drivers for my card).
  Thanks to Phetish for the idea
- Fullscreen is disabled by default, should increase the compatibility rate
- Supplementary info can be disabled
- If an invalid path is input in the configuration box, a warning is displayed
- The error messages are more explicit (and more numerous)
- No need to restart Winamp when you want to run TripMaker several times in a row
- Various bugfixes, some not noticeable to the user, all very handy

// Installation:

Just unzip the file in the plugins directory of Winamp. Before you launch TripMaker, be sure
to configure it properly using the "Plugin Configuration" of Winamp. There are 2 fields to
enter there: The Winamp plugins path, and the tunnel texture direction.

Winamp plugins path: The full path were you put the plugin. In fact, TripMaker will use
		     this path to find the "Shine?.bw" files, so if you put them in a
		     separate directory, put that path in the field.
Tunnel texture direction: the filename of the texture, including the *full* path. There
			  is a provided texture (texture.pcx), but it can be changed if you
			  have a picture you like at disposition. Restrictions are:
	* The picture must be a Zsoft .PCX file
	* It must have 16 millions colors
	* Its dimensions must be of the form (2^m, 2^n), as required by OpenGL. Good
	  dimensions are 64x64 or 128x128 (good quality/blazing speed).
	* The latter dimensions must at least be 64x64 (OpenGL makes the rules, not me).
	-> To help you a bit with this, a little window giving info about the picture
	   you selected is available when you launch TripMaker.
	-> If you just see white dumb walls, it means your picture doesn't comply to all
	   the requirements above.

// Hints:

By default, TripMaker will use any hardware (provided it supports OpenGL) acceleration
available. If the plugin is veeeeery slow, it just means it didn't detect your card. You
can try to put the OpenGL dll (found in the windows\system directory) in the Winamp and/or
Winamp\plugin directories. You can also try to disable fullscreen mode and reduce the size
of the window.

I didn't put any timer, so TripMaker is putting stuff on screen whenever it's computed the
next frame. So, to increase speed, disable fullscreen and reduce the size of the window. To
reduce speed (what are you, crazy?), just increase the window size.

// Known bugs or issues:

* Still lacks a timer
* Gives me headaches when I work on it
* I should clean the code, or create a map (I'm losing myself in all those crazy sines!!)
* Some people emailed me saying that my plugin was going into software rendering mode
  despite the fact that they had OpenGL compatible cards (Matrox G200 and ATI all-xxxx to be
  more precise). Well, I have bad news: it can't be helped! Why? Because if a program uses
  an OpenGL function not supported by the card you have, it will automatically go into soft
  rendering (Applications like Quake2 detect this kind of errors and use their own drivers
  to get it working, or try to use an equivalent function supported by the card).
* It appears that some people had trouble with paths containing spaces or directories names
  of more than 8 characters (DOS limitation). While I can't reproduce that bug on my
  computer, I put a warning in the config box when such paths are entered (it might work
  properly, though. Just don't be too much surprised if it doesn't).
* It is possible that after installation the "Professeur's TripMaker v0.5 beta" entry does
  not appear in the configuration box. I don't know where this problem comes from, and I
  know I'm not the only one who gets it (Tripex also seems to get this bug). The code
  concerning this is ripped STRAIGHT from Nullsoft's SDK. If you find a solution to this
  on the net, please email it to me.
* If you get a "Couldn't find bw files" (or something close to that) message, it means that
  TripMaker couldn't find the Shine[0-9].bw files in the directory indicated by the Path
  To Plugins entry in the config box.

// Contact:

You can email me if you have hardware specific problems or stuff like that. Emails like:
"Your plugin doesn't seem to work on any Commodore 64 as of yet. It sucks rocks." will just
be put on the site when it is up, in the "Guys eating too much poutine" section.
Professeur, email: asdertbcv@hotmail.com

Enjoy!

PS: As usual with freeware, nobody but yourself can be held responsible for the damages
    incurred by your computer after use of TripMaker. Use this software at your OWN RISK!