Image2Icon
            © 2000 by Stephan Rupprecht
                All rights reserved.
    

COPYRIGHT AND DISCLAIMER
 Image2Icon is copyrighted 2000 by Stephan Rupprecht.
 All rights reserved. This program is freeware, so no financial  
 donations required. Redistribution allowed if the package is 
 left unchanged except for addition of new language catalogs.   
 The author is not responsible for any damage caused by the 
 use or misuse of this documentation and/or the program(s) it 
 describes.


REQUIREMENTS
 Any Amiga® (compatible) computer with AmigaOS® 3.x,
 newicon.library (for os3.0/3.1 based systems) and 68020+ cpu.


DESCRIPTION
 Image2Icon is yet another conversion tool that creates thumbnail
 icons from pictures. It supports pictures with any depth, HAM
 images, however, aren't supported at the moment.


USAGE
 The program can be started from a shell as well as from wb. The
 following options/tooltypes are provided:
 
 FILE/M,MW=MAXWIDTH/N,MH=MAXHEIGHT/N,C=CROP/S,IA=IGNOREASPECT/S,
 AX=ASPECTX/N/K,AY=ASPECTY/N/K,NI=NEWICON/S,FIP=FREEICONPOS/S,
 FW=FRAMEWIDTH/N/K,FH=FRAMEHEIGHT/N/K,T=TRANSPARENT/S,
 OPT=OPTIMIZE/S,FL=FRAMELESS/S,SS=SHOWSIZE/K,F=FONT/K,
 FS=FONTSIZE/N/K,FST=FONTSTYLE/K,AP=APPICON/K,APX=APPICONX/N/K,
 APY=APPICONY/N/K,V42=MOVEV42/S,QU=QUALITY/N/K,Q=QUIET/S
 
 FILE/M: the image(s) to convert. If you don't give any, the
  program will add an appicon on which you can drop the pictures
  to convert. By double-clicking the icon the program can be
  terminated.
  
 MW=MAXWIDTH/N,MH=MAXHEIGHT/N: the maximum size of the icon to
  create. Please note that NewIcons are limited to a maximum
  size of 93x93 pixels, os3.5 icons are limited to 256x256 pixels.
  
 C=CROP/S: disables downscaling.
 
 IA=IGNOREASPECT/S: ignore the screen aspect ratio when scaling
  the image. 

 AX=ASPECTX/N/K,AY=ASPECTY/N/K: allows you to override the
  screen aspect ratio of the workbench screen.
 
 NI=NEWICON/S: create a NewIcon even when os3.5 is available.
  This option does nothing on a os3.0/os3.1 based system.
 
 FIP=FREEICONPOS/S: the resulting icon doesn't have a fixed
  position.
 
 FW=FRAMEWIDTH/N/K,FH=FRAMEHEIGHT/N/K: allows you to add a
  frame around the image.
  
 T=TRANSPARENT/S: by default, the transparent color (if any) of
  an image is ignored. Thus the resulting icon won't have one
  unless this option is specified.
  
 OPT=OPTIMIZE/S: optimize the image data, if possible (os3.5).
  
 FL=FRAMELESS/S: tell workbench not to draw a border around the
  icon (os3.5).
 
 SS=SHOWSIZE/K: display the image size in the icon. The following
  keywords are recognized:
  
  TOPLEFT,TOPRIGHT,CENTER,BOTTOMLEFT,BOTTOMRIGHT
 
 F=FONT/K: the font that is used by SHOWSIZE.
 
 FS=FONTSIZE/N/K: the size of the font.
 
 FST=FONTSTYLE/K: the style of it, either OUTLINE,SHADOW or 
  NORMAL (default)
 
 AP=APPICON/K: the icon to use as appicon.

 APX=APPICONX/N/K,APY=APPICONY/N/K: its position on the workbench
  screen. You always need to specify both.
  
 V42=MODEV42/S: when enabled truecolor images will be converted to
  8bit by the picture.datatype and not by Image2Icon. Requires
  picture.datatype v44!
 
 QU=QUALITY/N/K: the quality of the dithering algorithm to use when
  reducing truecolor/HAM images to 8bit.
  
  0 no dithering is done
  1 dither with a 4x4 Bayer matrix (default)
  2 ... 16x16 matrix
  3 Floyd Steinberg

 Q=QUIT/S: supresses any output except error messages. Currently
  there's no other output than error messages ;)
 

KNOWN PROBLEMS
 - picture.datatype v44 is required to create icons from HAM images.


CREDITS GO TO
 Olaf Barthel who wrote the dithering code used by this program.


HISTORY
 1.0  first public release
 1.1  added QU=QUALITY/N/K option to select a different dithering
      algorithm. supports HAM images via picture.datatype v44 now.


AUTHOR

Please send bug reports and ideas to:

 Stephan Rupprecht
 Apfeldweg 1
 D44359 Dortmund
 Germany

 Send emails to

 info@stephan-rupprecht.de

 WWW
 
 http://stephan-rupprecht.de