home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 15 / AACD15.ISO / AACD / Graphics / Image2Icon / Image2Icon.doc < prev    next >
Encoding:
Text File  |  2000-10-11  |  7.9 KB  |  207 lines
  1.                     Image2Icon
  2.             © 2000 by Stephan Rupprecht
  3.                 All rights reserved.
  4.     
  5.  
  6. COPYRIGHT AND DISCLAIMER
  7.  Image2Icon is copyrighted 2000 by Stephan Rupprecht.
  8.  All rights reserved. This program is freeware, so no financial  
  9.  donations required. Redistribution allowed if the package is 
  10.  left unchanged except for addition of new language catalogs.   
  11.  The author is not responsible for any damage caused by the 
  12.  use or misuse of this documentation and/or the program(s) it 
  13.  describes.
  14.  
  15.  
  16. REQUIREMENTS
  17.  Any Amiga® (compatible) computer with AmigaOS® 3.x,
  18.  newicon.library (for os3.0/3.1 based systems) and 68020+ cpu.
  19.  
  20.  
  21. DESCRIPTION
  22.  Image2Icon is yet another conversion tool that creates thumbnail
  23.  icons from pictures.
  24.  
  25.  
  26. USAGE
  27.  The program can be started from a shell as well as from wb. The
  28.  following options/tooltypes are provided:
  29.  
  30.  FILE/M,MW=MAXWIDTH/N,MH=MAXHEIGHT/N,C=CROP/S,IA=IGNOREASPECT/S,
  31.  AX=ASPECTX/N/K,AY=ASPECTY/N/K,NI=NEWICON/S,FIP=FREEICONPOS/S,
  32.  FW=FRAMEWIDTH/N/K,FH=FRAMEHEIGHT/N/K,T=TRANSPARENT/S,R=REMAPFS/S,
  33.  OPT=OPTIMIZE/S,FL=FRAMELESS/S,SS=SHOWSIZE/K,F=FONT/K,D=DITHER/S,
  34.  FS=FONTSIZE/N/K,FST=FONTSTYLE/K,AP=APPICON/K,APX=APPICONX/N/K,
  35.  APY=APPICONY/N/K,V42=MOVEV42/S,QU=QUALITY/N/K,P=PLANAR/S,
  36.  MP=MAXPEN/N/K,SF=STARTFROM/K,DT=DEFAULTTOOL/K,GS=GREYSCALE/S,
  37.  Q=QUIET/S
  38.  
  39.  FILE/M: the image(s) to convert. If you don't give any, the
  40.   program will add an appicon on which you can drop the pictures
  41.   to convert. By double-clicking the icon the program can be
  42.   terminated.
  43.   
  44.  MW=MAXWIDTH/N,MH=MAXHEIGHT/N: the maximum size of the icon to
  45.   create. Please note that NewIcons are limited to a maximum
  46.   size of 93x93 pixels, os3.5 icons are limited to 256x256 pixels.
  47.   
  48.  C=CROP/S: disables downscaling.
  49.  
  50.  IA=IGNOREASPECT/S: ignore the screen aspect ratio when scaling
  51.   the image. 
  52.  
  53.  AX=ASPECTX/N/K,AY=ASPECTY/N/K: allows you to override the
  54.   screen aspect ratio of the workbench screen.
  55.  
  56.  NI=NEWICON/S: create a NewIcon even when os3.5 is available.
  57.   This option does nothing on a os3.0/os3.1 based system.
  58.  
  59.  FIP=FREEICONPOS/S: the resulting icon doesn't have a fixed
  60.   position.
  61.  
  62.  FW=FRAMEWIDTH/N/K,FH=FRAMEHEIGHT/N/K: allows you to add a
  63.   frame around the image.
  64.   
  65.  T=TRANSPARENT/S: by default, the transparent color (if any) of
  66.   an image is ignored. Thus the resulting icon won't have one
  67.   unless this option is specified. As of 1.2 this option is no
  68.   longer working!!!
  69.   
  70.  OPT=OPTIMIZE/S: optimize the image data, if possible (os3.5).
  71.   
  72.  FL=FRAMELESS/S: tell workbench not to draw a border around the
  73.   icon (os3.5).
  74.  
  75.  SS=SHOWSIZE/K: display the image size in the icon. The following
  76.   keywords are recognized:
  77.   
  78.   TOPLEFT,TOPRIGHT,CENTER,BOTTOMLEFT,BOTTOMRIGHT
  79.  
  80.  F=FONT/K: the font that is used by SHOWSIZE.
  81.  
  82.  FS=FONTSIZE/N/K: the size of the font.
  83.  
  84.  FST=FONTSTYLE/K: the style of it, either OUTLINE,SHADOW or 
  85.   NORMAL (default)
  86.  
  87.  AP=APPICON/K: the icon to use as appicon.
  88.  
  89.  APX=APPICONX/N/K,APY=APPICONY/N/K: its position on the workbench
  90.   screen. You always need to specify both.
  91.   
  92.  V42=MODEV42/S: when enabled truecolor images will be converted to
  93.   8bit by the picture.datatype and not by Image2Icon (requires
  94.   picture.datatype v44). You can use this option in combination
  95.   with either REMAPFS or DITHER to improve the quality, but you'll
  96.   probably prefer to stay away from this option as it slows down
  97.   the conversion process without improving the result.
  98.  
  99.  QU=QUALITY/N/K: the quality of the dithering algorithm to use:
  100.   
  101.   0 no dithering is done (quick & dirty)
  102.   1 dither with a 4x4 Bayer matrix (default, still quick but not so dirty:)
  103.   2 ... 16x16 matrix (better quality than 1, speed is about the same)
  104.   3 Floyd Steinberg (slowest but best quality)
  105.  
  106.  GS=GREYSCALE/S: enables greyscale output.
  107.  
  108.  MP=MAXPENS/N/K: the maximum number of pens/colors to use. If GREYSCALE
  109.   is not enabled, the program will either use 8,12,27,36,64,80,125,150,
  110.   216 or 252 colors depending on which is next nearest number to the one
  111.   you've specified.
  112.  
  113.  D=DITHER/S: by default, images with <= 256 colors are remapped to
  114.   their original palette after scaling (ignoring MAXPEN). If you
  115.   enable this option, the images will be dithered instead. This is
  116.   faster but normally results in a thumbnail image with less quality
  117.   as the original palette of the image is not taken into account.
  118.  
  119.  R=REMAPFS/S: by default, images with <= 256 colors are remapped to
  120.   their original palette after scaling (ignoring MAXPEN). If you
  121.   enable this option, the images will also be dithered using Floyd 
  122.   Steinberg dithering.
  123.  
  124.  P=PLANAR/S: this will create an "old style"/planar image in addition
  125.   to the os3.5/NewIcon image.
  126.  
  127.  DT=DEFAULTTOOL/K: the default tool of the icon to create.
  128.  
  129.  SF=STARTFROM/K: how to start the default tool when the user
  130.   double-clicks the icon, this can either be WB, CLI or REXX.
  131.  
  132.  Q=QUIET/S: supresses any output except error messages.
  133.  
  134.  
  135. KNOWN PROBLEMS
  136.  - the ilbm.datatype that comes with os3.5 doesn't support bw/greyscale
  137.    images produced by BME (PageStream). Please use my ilbm.datatype
  138.    instead (util/dtype/ilbmdt44.lha).
  139.  
  140.  
  141. SPECIAL THANKS GO TO
  142.  Olaf Barthel who wrote the dithering code used by this program
  143.  and of course to the people who reported bugs and made suggestions :)
  144.  Also thanks to Dámaso D. Estévez for the spanish doc and
  145.  Raul Silva for the icons.
  146.  
  147.  
  148. HISTORY
  149.  1.0  first public release
  150.  1.1  added QU=QUALITY/N/K option to select a different dithering
  151.       algorithm. supports HAM images via picture.datatype v44 now.
  152.  1.2  optionally creates a "old style" image in addition to the 
  153.       os3.5/NewIcon one, see PLANAR/S option <John Blyth>. added
  154.       some smoothing code to the scaler, this requires additional
  155.       cpu time but makes the icon look nicer. Please note that I
  156.       had to disable TRANSPARENT/S to make it work correctly. It's
  157.       possible to drop drawers on the appicon, now. This will allow
  158.       you to convert a whole dir in one go.
  159.  1.3  some datatypes pass an aspect ratio of 0:0 causing a division
  160.       by zero guru (0x80000005), fixed. When dropping a drawer on
  161.       the appicon the program will no longer put up an error requester
  162.       when encountering an unsupported filetype <John Blyth>. added
  163.       MP=MAXPENS/N/K option although it isn't quite useful (IMHO).
  164.  1.4  added STARTFROM/K, DEFAULTTOOL/K options <Mario Cattaneo>.
  165.       creating NewIcons on a 3.5 based system didn't work, as NewIcon
  166.       and 3.5 image data was saved to disk.
  167.  1.5  should work on a NewIcons based system finally <Xenomorph>,
  168.       <Rainer M. Herold>.
  169.  1.6  no longer crashs on small images where the source size is the
  170.       same as the destination size.
  171.  1.7  added GS=GREYSCALE/S option <Nick Clover>. If QUIET is not given,
  172.       the program will output some status messages to the current
  173.       console window (when started from WB, the WINDOW tooltype must be
  174.       given to see this messages).
  175.  1.8  added D=DITHER/S,R=REMAPFS/S options. the code to handle EHB pictures
  176.       disappeared somehow, it's now back;) HAM images are supported in-
  177.       dependently from the installed picture.datatype, now. rewrote some
  178.       parts of code to work on chunky buffers instead of bitmaps, this should
  179.       result in a faster thumbnail creation, especially users without an RTG
  180.       software should notice an speed improvement.
  181.  1.9  the dithering code can use upto 252 colors, now (before 216).
  182.  1.10 optimized the scaling code a bit, included some nice icons made by
  183.       Raul Silva.
  184.  1.11 if you start the program from wb or if you drop icons on its appicon,
  185.       a simple gui with a progress bar will be shown.
  186.  1.12 the progress bar was shown even when QUIET was given. unless
  187.       PLANAR was specified the program has caused several enforcer hits when
  188.       a NewIcon was saved on a os3.0/os3.1 based system.
  189.  
  190.  
  191. AUTHOR
  192.  
  193. Please send bug reports and ideas to:
  194.  
  195.  Stephan Rupprecht
  196.  Apfeldweg 1
  197.  D44359 Dortmund
  198.  Germany
  199.  
  200.  Send emails to
  201.  
  202.  info@stephan-rupprecht.de
  203.  
  204.  WWW
  205.  
  206.  http://stephan-rupprecht.de
  207.