JSGalBuilder v0.5 - A Gallery Builder for JSGal
===============================================

Author: Andreas S. Krebs
Email:  jsgal@sberk.net
WWW:    http://www.sberk.net/jsgal/builder

Copyright (c) 2009 by Andreas S. Krebs

JSGalBuilder is licensed under the GNU General Public License Version 3
(see the COPYING file).


Description:
------------
JSGalBuilder is a java GUI application for creating web based galleries. 
The created galleries use JSGal (a javascript based gallery) for the 
rendering of the gallery in the browser.

In contrast to many other gallery builders, JSGalBuilder is not creating
HTML files with the gallery (except for an entry page of course). Instead only
the scaled images and XML files with the gallery meta data are created.
The actual rendering of the gallery is done by JSGal once the gallery is
displayed in the browser and is therefore very flexible (for details see
http://www.sberk.net/jsgal).


Features of JSGalBuilder:
-------------------------
-Easy creation and editing of JSGal galleries
-Drag&Drop support for adding images
-Automatic rotation and scaling of images
-Upgrade function for existing JSGal galleries
-Support for extracting JPEG EXIF meta data
-Java ImageIO is used for image processing 


Requirements:
-------------
-JSGalBuilder requires a Java Runtime version 1.6 or higher. (http://www.java.com)



History:
--------

v0.5: 
  -Initial release.



Building source:
----------------
1. Go to the src folder
2. Use ant (http://ant.apache.org) to build the distribution

Note: to build the windows binary wrapper you need launch4j installed
(http://launch4j.sourceforge.net) and the launch4j.dir property in the
build.xml needs to be set accordingly.



Projects embedded within JSGalBuilder:
--------------------------------------
The following projects are used within JSGalBuilder and part of the JSGalBuilder
distribution. For more information please refer to the projects homepage and
their dedicated distributions.
 

JSGal:
  Homepage: http://www.sberk.net/jsgal
  License: http://www.gnu.org/copyleft/gpl.html
  Author: Andreas S. Krebs
  Details: A stripped down version of the JSGal distribution is contained
    within the net.sberk.jsgal.datamodel.dist folder of JSGalBuilder. This files
    are used for creating a new gallery or updating an existing gallery.
    
Metadata Extractor:
  Homepage: http://www.drewnoakes.com/code/exif/
  License: http://www.drewnoakes.com/code/exif/
  Author: Drew Noakes
  Details: The metadata extractor is used to extract EXIF metadata from JPEG
    images. It is distributed as part of the JSGalBuilder source code and 
    contained within the com.drew.* packages.
    In order to make it compile smoothly the following changes were made to
    the original source:
      -removed all test coding
      -removed all coding using com.sun.image.codec.jpeg classes
      -added @SuppressWarning("all") to all classes to get rid of warnings
  The original source code is available at:
    http://www.drewnoakes.com/code/exif/releases/metadata-extractor-2.3.1-src.jar
    
Oxygen Icons:
  Homepage: http://www.oxygen-icons.org/
  Licenses: http://creativecommons.org/licenses/by-sa/3.0/
            http://www.gnu.org/licenses/lgpl.html          
  Details: The icons used within JSGalBuilder are part of KDE's Oxygen icon theme.
    The used icons are all taken from the kdebase package and copied into the 
    net.sberk.jsgal.gui.resources folder within the JSGalBuilder source.