Pete's XGL2 PSX/ZiNc plugin for Linux
-------------------------------------

Installation:
-------------

Copy the file "libgpuPeteXGL2.so.x.x.x" into the emu's "Plugin" directory
The files "gpuPeteXGL2.cfg" and "cfgPeteXGL2" should be copied together into
another directory (see next section, "cfg" sub dir recommended).

For ZiNc, copy the .so and .cfg files into the main ZiNc directory, and use the
ZiNc command line option to load the renderer (prolly renaming the .so file
librendererznc.so will also work, but I haven't tried it).

Configuration:
--------------

There's a text file called "gpuPeteXGL2.cfg" and an executable called "cfgPeteXGL2".
Copy both of them together into

a) a main emu sub-directory called "cfg" or
b) directly into the main emu directory or
c) your home directory

If the main emu has a gui to select the plugins, there will be propably
a "Configure" button for the plugin. That one will start the "cfgPeteXGL2"
application, and a window with all possible options will appear. The options
are stored into the "gpuPeteXGL2.cfg" text file.

So, if there is no gui, you can use a simple text editor to change the options.
The options are somewhat explained in the cfg-file (see the comments),
a full readme will follow soon... basically all the options of my
Windows OpenGL2 plugin are included, so you can check the Windows
readme for more infos :)


Troubleshooting:
----------------
Well, the plugin is very demanding... ATI Radeon cards with drivers supporting
the "GLX_ATI_render_texture" extension will be fine to run it. For example the
official ATI 3.2.8 driver does a good job with the plugin on my Radeon 9700Pro.
Users of other gfx cards can try enabling the "no ATI render-to-texture" option,
but still the plugin may not work (at least pbuffer support is mandatory), or it
may be very slow. Well, you have to try it for yourself.

Also, with ZiNc it wasn't possible to use an high Y resolution on my ATI card.
If you have a crash on startup, try internal X/Y resolutions of "0" first.



Ok, have fun :)

Pete Bernert

mail: BlackDove@addcom.de
web:  http://www.pbernert.com
