home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 080.lha / iconize.doc < prev    next >
Text File  |  1986-11-20  |  3KB  |  84 lines
  1.                           ICONIZE 1.00
  2.                           JUNE 6, 1987
  3.  
  4.                       By Stephen Vermeulen
  5.                          3635 Utah Dr. N.W.,
  6.                          Calgary, Alberta,
  7.                          CANADA, T2N 4A6
  8.  
  9.           Copyright (C) 1987 By Stephen Vermeulen
  10.           This version may be freely redistributed
  11.           so long as not charge is made for such
  12.           distribution.
  13.  
  14. ---------------------------------------------------------------------
  15.  
  16. 0.0 Introduction
  17.  
  18. Iconize is a program that takes a full size Amiga picture and reduces
  19. it in an antialiased fashion by a factor you specify.  The program was
  20. written primarily to supply a simple CLI tool which can be used to make
  21. custom icons for paintings.  To make a custom icon for a painting you
  22. follow these steps:
  23.  
  24.   1.  Iconize the painting to produce a miniture replica.
  25.   2.  Recolor the painting to reduce the number of colours to the
  26.       four allowed on the workbench.
  27.   3.  Use the brush to icon program to convert the Iconized and Recolored
  28.       painting to an icon.
  29.  
  30. For some paintings it might be better to Recolor the full size painting
  31. first and then Iconize it down to the desired size.  The real loss in
  32. image quality comes when the Recoloring is done since the WorkBench
  33. colours are so screwy.
  34.  
  35. Of course the files that Iocnize works with are all IFF ILBM type files
  36. so it is fully compatible with the rest of your Amiga software.
  37.  
  38. 1.0 Running Iconize
  39.  
  40. Iconize can only be run from the CLI (this will probably be fixed soon).
  41. There are two ways of invoking it.  First just typing:
  42.  
  43.    Iconize
  44.  
  45. will result in the copyright notice, short instructions, and the version
  46. number being printed.  By typing a command of the following format:
  47.  
  48.    Iconize input.pic output.pic factor_x factor_y
  49.  
  50. Iconize will process the input file "input.pic", rescaling it by the
  51. supplied factors.  When it is done it will write the output to the file
  52. "output.pic".  The values of factor_x and factor_y must be a positive,
  53. non-zero, integers.  That is you can use 1, 2, 3, 4...  To display various
  54. sizes of paintings on the WorkBench screen as icons consult the following
  55. table for suggestions on "good" values for the factors:
  56.  
  57.            Painting Size            Factor_x   Factor_y
  58.            -------------            --------   --------
  59.             320 x 200                  3          6
  60.             640 x 200                  6          6
  61.             320 x 400                  3         12
  62.             640 x 400                  6         12
  63.  
  64. Note that the values of the factors are not usually equal for the best
  65. results, this is because the WorkBench has highly non-square pixels!
  66.  
  67. 2.0 Memory Usage
  68.  
  69. Iconize needs to allocate 2 complete picture buffers, so if you have a 512K
  70. machine you might find it difficult to Iconize HiRes 16 colour pictures.
  71. The first buffer is the same size as the picture, but the second buffer is
  72. only as large as the finnished product. Iconize works REAL NICE on a 2.5Meg
  73. Amiga!
  74.  
  75. 3.0 Support
  76.  
  77. Any comments, suggestions, or bug reports you might care to make will be
  78. gratefully received.  If you are interested in seeing this program improve
  79. much send a contribution ($10-$20 to me at the address above).  My current
  80. policy on improving the program is to release a new version for every 5
  81. contributions I receive, or when I need a new feature!
  82.  
  83.  
  84.