About Java Ponies
=================

Java Ponies is a direct (and a bit outdated) port of the Desktop Ponies app.
Website: http://www.desktopponies.com/

Desktop Ponies was made for windows only, but Java Ponies
should be able to run on any system using Java 1.6 or 1.5.

The original maintainer of this port was Jirugameshi, however, he mysteriously
vanished. :(

Features
========

Java Ponies has all of the features available in Desktop Ponies.
(see README_win.txt for details)


How to run
==========

Run (double click on) the "Java Ponies.jar" file.

Linux users may require special handling due to java not setting the current directory properly.  See the "Special instructions for Linux Users.gif" file.


Known Issues
============

Under Linux:
Performance problems with Shaped windows.
Pony windows clutter up the application panel.
Unhandled JNA exception when closing.


Additional Options
==================
Double buffering: Turn this option ON to make the
                  animations smoother, or turn it OFF if
                  the application runs too slowly on your
                  system.

Full frame redraw: If you experience animation glitches
                  under Max OS X, turn this option ON to
                  redraw all animation frames completely.
                  If you don't have any glitches, it's
                  probably better to leave this OFF.

Shaped windows:	  Turn this option ON in Linux. It will
		  set the shape of the Pony windows to the
		  shape of the sprites. Experimental.


Linux Instructions
==================

In order for Java Ponies to run, you will need to have the Composite
option enabled and Java Runtime Environment (JRE) 1.6 or higher installed.

1) Extract the files to a folder of your choice


2) Verify if the Composite option is enabled
  ->In a terminal, type: xdpyinfo | grep Composite
  If the word Composite appears in the result, skip to step 3.

  ->If nothing appears, you need to enable the Composite option in your Xorg.conf file
  http://en.gentoo-wiki.com/wiki/X.Org/Transparency#X_Composite_Extension

  ->And also enable composite effects in your Window Manager
  http://en.gentoo-wiki.com/wiki/X.Org/Transparency#Enabling_Shadows_and_Real_Transparency


3) Make sure java is properly installed
  ->In a terminal, type: java -version
  If you have Java version 1.6 or higher, skip to step 4.
  If not, you will need to download and install the sun-java6-jre package


4) Running Java Ponies
  ->Go into the folder where you extracted the files
  ->Right-click on Java Ponies.jar and choose "Run with Java..."
    or
  ->In a terminal, type: java -jar "Java Ponies.jar"

5) Go into the Options and turn ON "Shaped windows".



Enjoy having an army of ponies rampaging across your screen! :D