Joxy Look and Feel Files

-- Joxy Look and Feel
-- Version 0.1.0
-- August 2012
--
-- Copyright 2011, 2012 Thom Castermans and Willem Sonke.
-- Contact: <thomcastermans@users.sf.net> and <willem3141@users.sf.net>.
--
---------------------------------------------------------------------------
--
-- This file is part of Joxy.
--
-- Joxy is free software: you can redistribute it and/or modify
-- it under the terms of the GNU General Public License as published by
-- the Free Software Foundation, either version 3 of the License, or
-- (at your option) any later version.
--
-- Joxy is distributed in the hope that it will be useful,
-- but WITHOUT ANY WARRANTY; without even the implied warranty of
-- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
-- GNU General Public License for more details.
--
-- You should have received a copy of the GNU General Public License
-- along with Joxy.  If not, see <http://www.gnu.org/licenses/>.


-- GENERAL INFO
The Joxy Look and Feel provides a consistent integration of the Java Swing 
framework with the KDE Oxygen theme.

As the license says, Joxy is free software. The source is included in the 
JAR-file. The project homepage can be found at 
<https://sourceforge.net/projects/joxy/>. It is also possible to report bugs
and discuss Joxy there.


-- INSTALLATION
There are two ways of installing Joxy.

1) Installing it locally on your system, to be used (potentially) with all Java
   Swing programs.
To do this, copy the JAR-file to the lib/ext/ directory of your Java 
installation. You can now start a program with Joxy enabled on it by using
the commandline option '-Dswing.defaultlaf=joxy.JoxyLookAndFeel' when starting
a program.
Example:
  java -jar -Dswing.defaultlaf=joxy.JoxyLookAndFeel foobar.jar
Note that this does not work with large programs that set their own LAF. For
example to start Netbeans with Joxy enabled, you have to use the -laf option
that Netbeans provides. It can also be the case that you can choose the LAF
in the settings section of a program. For more information, you can refer to
the Joxy homepage.

2) Including it in your program as (one of) the Look and Feel to be (possibly) 
   used by your program.
You can include the JAR-file in your own source. Then you can set the LAF
programmatically as follows:
  UIManager.setLookAndFeel("joxy.JoxyLookAndFeel");
This should be done before the GUI is created.
Of course, you can program your own facilities to let the user change the LAF.
Note that if you want to check if a user uses KDE, so that you can apply Joxy
only if a user uses KDE, you can use the Utils class and in particular the
isKDE method. This can be done as follows:
  if (joxy.utils.Utils.isKDE()) {
    // Do something if KDE is installed by the user.
  }
Note that you need to have the JAR-file in your build path to be able to do
this.


-- CHANGELOG
Refer to <https://sourceforge.net/p/joxy/wiki/Progress%20of%20the%20components/>
for an up-to-date list of the progress of Joxy development.
You can from there also find the changes made in all versions of Joxy.

-- ACKNOWLEDGEMENTS
For implementing many components, we looked at the code of the Oxygen Qt theme.
For the project icon we used the Konqi model by Basse <basse@kimppu.org> and
the Duke model by the Duke project <http://duke.kenai.com/>.
Thanks to participants of the KDE development mailinglist for their feedback
and tips for our native textrendering library.