home *** CD-ROM | disk | FTP | other *** search
/ Magazyn Exec 3 / CD_Magazyn_EXEC_nr_3.iso / Recent / util / wb / Image2Icon.lha / Image2Icon / Image2Icon.doc next >
Encoding:
Text File  |  2000-07-18  |  3.9 KB  |  136 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. It supports pictures with any depth, HAM
  24.  images, however, aren't supported at the moment.
  25.  
  26.  
  27. USAGE
  28.  The program can be started from a shell as well as from wb. The
  29.  following options/tooltypes are provided:
  30.  
  31.  FILE/M,MW=MAXWIDTH/N,MH=MAXHEIGHT/N,C=CROP/S,IA=IGNOREASPECT/S,
  32.  AX=ASPECTX/N/K,AY=ASPECTY/N/K,NI=NEWICON/S,FIP=FREEICONPOS/S,
  33.  FW=FRAMEWIDTH/N/K,FH=FRAMEHEIGHT/N/K,T=TRANSPARENT/S,
  34.  OPT=OPTIMIZE/S,FL=FRAMELESS/S,SS=SHOWSIZE/K,F=FONT/K,
  35.  FS=FONTSIZE/N/K,FST=FONTSTYLE/K,AP=APPICON/K,APX=APPICONX/N/K,
  36.  APY=APPICONY/N/K,V42=MOVEV42/S,QU=QUALITY/N/K,Q=QUIET/S
  37.  
  38.  FILE/M: the image(s) to convert. If you don't give any, the
  39.   program will add an appicon on which you can drop the pictures
  40.   to convert. By double-clicking the icon the program can be
  41.   terminated.
  42.   
  43.  MW=MAXWIDTH/N,MH=MAXHEIGHT/N: the maximum size of the icon to
  44.   create. Please note that NewIcons are limited to a maximum
  45.   size of 93x93 pixels, os3.5 icons are limited to 256x256 pixels.
  46.   
  47.  C=CROP/S: disables downscaling.
  48.  
  49.  IA=IGNOREASPECT/S: ignore the screen aspect ratio when scaling
  50.   the image. 
  51.  
  52.  AX=ASPECTX/N/K,AY=ASPECTY/N/K: allows you to override the
  53.   screen aspect ratio of the workbench screen.
  54.  
  55.  NI=NEWICON/S: create a NewIcon even when os3.5 is available.
  56.   This option does nothing on a os3.0/os3.1 based system.
  57.  
  58.  FIP=FREEICONPOS/S: the resulting icon doesn't have a fixed
  59.   position.
  60.  
  61.  FW=FRAMEWIDTH/N/K,FH=FRAMEHEIGHT/N/K: allows you to add a
  62.   frame around the image.
  63.   
  64.  T=TRANSPARENT/S: by default, the transparent color (if any) of
  65.   an image is ignored. Thus the resulting icon won't have one
  66.   unless this option is specified.
  67.   
  68.  OPT=OPTIMIZE/S: optimize the image data, if possible (os3.5).
  69.   
  70.  FL=FRAMELESS/S: tell workbench not to draw a border around the
  71.   icon (os3.5).
  72.  
  73.  SS=SHOWSIZE/K: display the image size in the icon. The following
  74.   keywords are recognized:
  75.   
  76.   TOPLEFT,TOPRIGHT,CENTER,BOTTOMLEFT,BOTTOMRIGHT
  77.  
  78.  F=FONT/K: the font that is used by SHOWSIZE.
  79.  
  80.  FS=FONTSIZE/N/K: the size of the font.
  81.  
  82.  FST=FONTSTYLE/K: the style of it, either OUTLINE,SHADOW or 
  83.   NORMAL (default)
  84.  
  85.  AP=APPICON/K: the icon to use as appicon.
  86.  
  87.  APX=APPICONX/N/K,APY=APPICONY/N/K: its position on the workbench
  88.   screen. You always need to specify both.
  89.   
  90.  V42=MODEV42/S: when enabled truecolor images will be converted to
  91.   8bit by the picture.datatype and not by Image2Icon. Requires
  92.   picture.datatype v44!
  93.  
  94.  QU=QUALITY/N/K: the quality of the dithering algorithm to use when
  95.   reducing truecolor/HAM images to 8bit.
  96.   
  97.   0 no dithering is done
  98.   1 dither with a 4x4 Bayer matrix (default)
  99.   2 ... 16x16 matrix
  100.   3 Floyd Steinberg
  101.  
  102.  Q=QUIT/S: supresses any output except error messages. Currently
  103.   there's no other output than error messages ;)
  104.  
  105.  
  106. KNOWN PROBLEMS
  107.  - picture.datatype v44 is required to create icons from HAM images.
  108.  
  109.  
  110. CREDITS GO TO
  111.  Olaf Barthel who wrote the dithering code used by this program.
  112.  
  113.  
  114. HISTORY
  115.  1.0  first public release
  116.  1.1  added QU=QUALITY/N/K option to select a different dithering
  117.       algorithm. supports HAM images via picture.datatype v44 now.
  118.  
  119.  
  120. AUTHOR
  121.  
  122. Please send bug reports and ideas to:
  123.  
  124.  Stephan Rupprecht
  125.  Apfeldweg 1
  126.  D44359 Dortmund
  127.  Germany
  128.  
  129.  Send emails to
  130.  
  131.  info@stephan-rupprecht.de
  132.  
  133.  WWW
  134.  
  135.  http://stephan-rupprecht.de
  136.