------------------------------------------------------------
ReadMe for ixusdownload version 2.6
------------------------------------------------------------

ixusdownload - program to download pictures from the USB camera
Canon "S100 ELPH" -"digital IXUS" in Europe, "IXY digital" in Japan.
Also works with the Powershot S10 and S20 models.


Acknowledgements:
Written with the help of the reverse engineered protocol document
from the linux program "s10sh":
(http://www.kyuzz.org/antirez/s10sh.html)

Got information about the Exif file format from the document:
(http://www.butaman.ne.jp/~tsuruzoh/Computer/Digicams/exif-e.html)

The included "jpegtran" program is from the "Independent JPEG Group":
(http://www.ijg.org/)

The Annotated BeBook helped a lot:
(http://bang.dhs.org/be/bebook/index.html)

The BeOS Tip Server too:
(http://www.betips.net/)

And, of course; BeBits:
(http://www.bebits.com)

Thanks to everyone that have given me questions,
suggestions and encouragement !!


Installation:
	* Place the ixusdownload program wherever you want to.

	* Drag the jpegtran program to the folder "Drop jpegtran here",
	   which is a link to /boot/home/config/bin

	* If you want the new attributes (Width, Height, Date and Flash)
	   visible in the tracker, install them by doubleclicking on the
	   "install jpeg attributes". (if you don't have xicon just drag and
	   drop the icon into an open terminal window, and press enter)

	   -The script will not overwrite or delete any already existing
	    attributes in the MIME database.


For the advanced user:
If you want to Find files based on the attributes, you might want to
create new indices from the terminal: (Remember:  the index isn't
retroactive, you'll have to (zip/delete/unzip) or copy/move the files
so they'll show up in the new index )

	mkindex -t int GRAFX:Height
	mkindex -t int GRAFX:Width
	mkindex -t llong EXIF:Date  


Final words:
The graphical interface should be pretty self-explaining. Note that this
is my first stab at programming the interface kit. There could be bugs
or unfortunate cosmetics in there.

Please tell me if you have any problems, or for that matter, if it works ok.
Feature requests are okay too...

Urban Lindeskog  (ubbe@printf.com)

Homepage for ixusdownload:
(http://www.printf.com/ixusdownload)

------------------------------------------------------------
Version History:
------------------------------------------------------------
2.6	Recognizes some new Powershot models.
	Sets the width, height, flash and 'shot date' attributes on the
	downloaded jpeg files (GRAFX:Width, GRAFX:Height, EXIF:Flash,
	EXIF:Date). Use the supplied script to install them in the
	MIME database.
	Added the option to rotate the photos in ixusdownload,
	so you don't have to mark them for rotation in the camera
	menu (I tend to forget that). Note that ixusdownload can not
	change the rotation setting for the picture on the flash memory.
	Cleaned up the source code a bit, one more round and it will
	be ready for public consumption.

2.5	UTF8 to ISO8859 (Latin1) conversion for camera owner name.
	More info in the list view: pixel height and width, and if the
	photo was flash exposed.
	If you change the orientation for an image (+/- 90 degrees) in
	the camera, ixusdownload will rotate the thumbnail accordingly.
	It will also rotate the downloaded jpeg image with the help of
	the standalone "jpegtran" (from the Independent JPEG Group).
	The rotation is performed without any loss of quality, because
	it is not decoded/reencoded, but rather the compressed data
	is rearranged.
	The Exif parser was once more  extended to allow for extraction
	of more useful image information.
	The program remember the directory last used.
	The file panel has a "Select Current Directory" button.
	
2.4	"Edit/Select New" menu option
	"Edit/Camera info..." menu option - Edit camera owner name,
	see power supply  and CF card info.
	Fix for a problem with some S20 cameras there you'd only
	see the thumbnails, and not be able to dowload/delete/setattr.
	-The program no longer open the USB device for each action.
	The application signature is now set on the executable file.

2.3	Menu bar.
	About window.
	Download progress window.
	Alert asking for confirmation when deleting pictures.
	Error Alerts.
	The Exif directories of thumbnails are parsed correctly
	(and not just skipped as before).
	Fixed some memory leaks in the listview.
	Adjusted some cosmetics. Use the system color defs.
	"Stitch assist" pictures now show up in the listview.

2.2	Fixed embarrasing bug in setattr

2.1	Spiffed up GUI - setattr window

2.0	Graphical interface

1.0	Initial release - command line only, still useful for
	batch/background downloading