MagickThumbnail
==============

This application can generate thumbnails of the various filetypes,
readable by ImageMagick, for display by ROX-Filer.  It requires: 

* ROX-Filer CVS 2003-10-13 or later, or verson 2.1.1

* ROX-Lib2 CVS 2003-11-08 or later, or version 1.9.12

* ImageMagick or GraphicsMagick
For GraphicsMagick you need this wrapper script in your PATH:

#!/bin/sh
exec gm convert "$@"

Name it 'convert' and mark it executable.

Installation
------------

To install it, copy to your ~/Apps directory (or /usr/local/apps or
/usr/apps) and run it.  Click on install handlers and click on OK.
You can choose not to install it for some of the types.
Select "Image" to set:
- Thumbnail size
- wether to draw a frame around the thumbnails
- what color to choose for the frame (sorry, no color chooser yet, you have to enter 
a decimal integer representing a RGB color)

File type support
-----------------

Version 0.5.1 supports the following MIME types:
   image/bmp
   image/cgm
   image/fax-g3
   image/g3fax
   image/gif
   image/jpeg
   image/png
   image/tiff
   image/x-compressed-xcf
   image/x-eps
   image/x-ico
   image/x-jng
   image/x-pcx
   image/x-photo-cd
   image/x-portable-anymap
   image/x-portable-bitmap
   image/x-portable-graymap
   image/pixmap
   image/x-psd
   image/x-rgb
   image/x-tga
   image/x-wmf
   image/x-xbitmap
   image/x-xcf
   image/x-xfig
   image/x-xpixmap
   image/x-windowdump
   video/x-mng
   application/pdf
   application/x-font-ttf
   application/x-font-type1
   application/x-font

ImageMagick potentially supportes a lot more filetypes, which
are not yet in the freedesktop.org shared-mime-database.
The above list will grow much longer, as soon as I get them in
officially. (Thomas, please help me with that!)
magick1.xml and magick2.xml contain the missing types.
Note, adding those to your mime-database won't have any effect
with respect to MagickThumbnail, as the respective types have to
 be added to AppInfo.xml as well.

Due to patent issues, the copy of ImageMagick provided by your 
distributor probably lacks support for a number of filetypes. 
You can find out with:

$ convert -list format

To get support for the missing types, you have to recompile 
ImageMagick with all the necessary libraries and their header
files installed. The joy of Open Source ;-)

Lets look a little closer at the supported file-types!

application/pdf

Yes, that's right. MagickThumbnail can thumbnail your PDFs :)
Obviously it won't thumbnail whole documents, only what happens to be the first page.
Decide for yourself if that's usefull.

Let's look again:

application/x-font-ttf
application/x-font-type1
application/x-font

Hooray, font thumbnailing in ROX-Filer!
Rahsheen Porter's TTFThumbnail never worked for me and it had a depency on gozer,
which few people have installed, while ImageMagick is quite popular and wide-spread.
MagickThumbnail can not only thumbnail Truetype fonts (*.ttf), but Adobe Type1 fonts (*.pfb) too!
On the downside, the kind of thumbnails ImageMagick produces aren't very helpfull at 96x96,
which is the maximum size ROX-Filer will preview them. I don't know if something can be done
about it on the ROX-Filer end. If not I'll hack a bit on ImageMagick to get better results.

I haven't tried if all the file-types listed above actually work. Please mail me which do and which 
don't work for you!

Note, MagickThumbnail draws a lot slower than GTK. I hope I can increase speed for the future.
For the time being I suggest you don't install MagickThumbnail mime-handlers  for file-types 
supported by your installed gdk-pixbuf loaders. Example:

$ ls /opt/gnome/lib/gtk-2.0/2.2.0/loaders/*.so

io-wmf.so    libpixbufloader-jpeg.so  libpixbufloader-tiff.so
libpixbufloader-ani.so  libpixbufloader-png.so   libpixbufloader-wbmp.so
libpixbufloader-bmp.so  libpixbufloader-pnm.so   libpixbufloader-xbm.so
libpixbufloader-gif.so  libpixbufloader-ras.so   libpixbufloader-xpm.so
libpixbufloader-ico.so  libpixbufloader-tga.so   svg_loader.so

Author
------

Guido Schimmels gushi@arcor.de
http://www/roxos.sunsite.dk/dev-contrib/guido/
                
