Description
===========
The jhead and jpegtran command line utilities allow you to do
lossless transformations of jpeg images such as rotations without
losing any image data or exif information.  gjpegtran wraps these
utilities in a more usable graphical wrapper that is integrated with
the gnome mime infrastructure and nautilus file manager.

New Versions
============
The latest version of gjpegtran will be available at:

    http://www.picnicpark.org/keith/software/gjpegtran/


Requirements
============
gjpegtran is written in python using libglade and pygtk/pygnome.  To
be useful, you need these installed along with jhead and jpegtran.
Currently the version of libglade and pygtk/pygnome I'm developing
with are for Gnome 1.4.  I'm not sure if Gnome 2.0+ will work, as I
have no machine I can test on.

In general, if you have a reasonably modern linux distribution
installed, the only dependency you probably don't have is jhead.

Here are links to more information about the required packages:

     jhead: http://www.sentex.net/~mwandel/jhead/
     jpegtran: (part of libjpeg): http://www.ijg.org/
     pyglade/pygtk/pygnome: http://www.daa.com.au/~james/gnome/
     python: http://www.python.org/


Installation
============
Type:

     make install

This will copy all files to the required places to fit in with your
current gnome installation.  Alternatively, an rpm spec file is
provided if you prefer to build packages.

To get Nautilus to list gjpegtran in the "Open with..." menu, you may
have to do two things:

   1) Log out and log in again.  This will force Gnome to pickup the
      new application information about gjpegtran.  For cleanliness, I
      chose to install the gjpegtran information in separate files in
      the gnome application-registry and mime-info directories.  From
      my scanning of the gnome-vfs code, it appears that Gnome does
      not automatically pickup the contents of new files in these
      directories, although it does notice changes to existing files.

   2) After step 1, the application should be available to
      Gnome/Nautilus.  However, it probably won't be listed in the
      "Open with..." menu of jpeg files.  To list it there, open the
      following URI in Nautilus:

            preferences:///Documents/

      Now, open File Types and Programs.  Find the mime-types for
      image/jpeg.  In the "Default Action" box, click on "Open with
      Application" and then "Edit List".  You should see "Gnome
      Lossless JPEG Transformer" listed.  Make sure it has a checkmark
      next to it.  Select "OK" to get all the way out of the File
      Types and Programs dialogs.


Usage
=====
The preferred usage is from the "Open with..." menu in Nautilus.
Select a jpeg file and right-click on it, then select "Open with..."
followed by "Gnome Lossless JPEG Transformer".  The image will open in
the transformer.  

The operations should be pretty self-explanatory.  When one of the
toolbar icons illustrating a transformation is clicked, the
transformation is carried out immediately and the new image
redisplayed.  The EXIF information is reread after each
transformation, so you can feel comfortable that it is still there.
There is no "save" operation as the transformation is carried out
immediately.

If you would like to open a file in jgpegtran from the command line,
the syntax is extremely simple:

    gjpegtran <file>

Standard GTK options should be accepted.  Only a single file can be
specified at a time.


Redistribution
==============
gjpegtran is covered in the GPL version 2.  Please see the file
COPYING for more information.


Feedback
========
I am very interested in feedback on gjpegtran.  Please let me know
what you think, send suggestions etc.  I can be reached at 
camalot@picincpark.org