home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 447.lha / iconize_v0.935 / Iconize.docs < prev    next >
Encoding:
Text File  |  1990-12-08  |  11.3 KB  |  215 lines
  1. -----------------------------------------------------------------------------
  2. |                                                                           |
  3. |                            I C O N I Z E                                  |
  4. |                               (v.935)                                     |
  5. |           Copyright (C) 1990, Rick Tillery, all rights reserved           |
  6. |                                                                           |
  7. |                                                                           |
  8. -----------------------------------------------------------------------------
  9. | This program is release into the public domain as long as all files       |
  10. | listed below are included in each transfer.  The source code is not       |
  11. | included, but if you REALLY want to know how I did this, drop me a line   |
  12. | and I'll send you a copy.                                                 |
  13. -----------------------------------------------------------------------------
  14. OK, here's the deal:  I have lots of IFF pictures that I love to show off.  I
  15.                       usually use a graphical shell to show them because it's
  16.                       easier and the stupid icons that paint programs use are
  17.                       ugly.  Now 2.0 MAY be coming out soon and I am working
  18.                       with a developer in beta testing it and it came to me
  19.                       that the built in 16 color (or 8 color or even 2 color)
  20.                       WorkBench would be a perfect oportunity to create some
  21.                       better icons.
  22.                       
  23.  
  24. First I developed a palette from the basic 2.0 palette of a medium grey,
  25. black, white, and a pastel blue.  I extended it to 16 colors to 15 grey
  26. shades and the blue in a way which allows the 16 color icons to be viewed in
  27. the reduced color modes with some semblance of legibility.  With this palette
  28. I used several commercial products to shrink, convert to grey scale and remap
  29. my pictures into brushes with this palette.  Then I used the Icon Editor in
  30. 2.0 to make them into icons (YES! 2.0 allows you to load IFF brushes as
  31. icons).
  32.  
  33. This took quite a bit of work, but I was so pleased with the results that I
  34. couldn't resist trying my hand at a program which would automate this
  35. creation of icons from IFF pictures.
  36.  
  37. Iconize (v.935) is the result (so far).
  38.  
  39. -----------------------------------------------------------------------------
  40.  
  41. Included here:             Iconize (v.935) - the program itself (executable)
  42.                            Iconize.docs - the docs you are reading
  43.                            IFF.library - a public domain IFF handling library
  44.                            IFFlibrary.Readme - info on IFF.library
  45.  For WB 2.0 users only:    PaletteScreen - a Screenshot showing how good
  46.  -(but you WB 1.3 users                    these icons can look and also
  47.   can look at this to                      providing the appropriate color
  48.   get an idea of how                       palette.  In 2.0 select ScreenMode
  49.   GREAT your icons will                    in the prefs drawer and change to
  50.   look!)-                                  16 colors.  Then select palette
  51.                                            and use the pulldown menu to load
  52.                                            in the palette of the
  53.                                            "PaletteScreen".
  54.  For WB 1.3 users only:    Xcolour & Planes - two WB hacks to allow adding
  55.                                               bitplanes to your WB screen
  56.                                               (Planes is already hacked with
  57.                                                appropriate colors so the
  58.                                                icons mentioned were not
  59.                                                included since they wouldn't
  60.                                                have worked with this
  61.                                                palette).
  62.                            Planes.ReadMe & XColour.doc - you guessed it!
  63.                            SetColor - reads in contents of Color.palette
  64.                                       file and sets WB color registers from
  65.                                       it
  66.                            SaveColor - saves a Color.palette file using
  67.                                        current WB color registers
  68.                            Color.palette - an appropriate palette file
  69.  
  70. What is required:          One Amiga computer (not included)
  71.                            At least one IFF file (not included)
  72.                            Iconize and support files (included)
  73.                            Some time (more for bigger pics less for smaller
  74.                            ones, I'm working on speeding this up!)
  75.                            (.935 is 325% faster than .90 was!)
  76.  
  77. -----------------------------------------------------------------------------
  78.  
  79. Destructions:
  80.  
  81.                Iconize is a simple program that will convert your IFF files
  82.             into small project icons of 16, 8, 4(ugh), or 2(yech!) colors
  83.             from a standard palette.  You may specify the number of bitplanes
  84.             (number of colors = 2 raised to the power of the number of
  85.             bitplanes), the stack size, the default tool, the width and the
  86.             height of the icon.
  87.  
  88.                The palette is included in the PaletteScreen file so you can
  89.             load it into the palette command under 2.0.  However, you may use
  90.             this same palette under 1.3 normally or with a WorkBench hack for
  91.             increasing (or decreasing) the number of bitplanes in your WB
  92.             screen.  For those of you in the latter case, your palette should
  93.             consist of the first n values in the following list (where n is
  94.             the number of colors on your WorkBench screen):
  95.                      (hex values)  AAA, 000, FFF, 679, <--(this one is not
  96.                                                            unique and is up
  97.                                                            to you)
  98.                                    888, 333, DDD, 666,
  99.  
  100.                                    BBB, 222, EEE, 555,
  101.  
  102.                                    999, 444, CCC, 777
  103.  
  104.             Just load these values in as your palette in whatever way is
  105.             specified by the particular hack you are using.
  106.             
  107.             To make things easier, I've located and included two of these
  108.             screen hacks and their appropriate support files.  If you have a
  109.             better WB hack than those included (maybe one that won't crash on
  110.             an accelerated machine) use the above technical info, and please
  111.             contact me so I can distribute it with my program.  Otherwise,
  112.             just use the included hacks.
  113.  
  114. Usage:         To use Iconize you must first install the iff.library in your
  115.             libs: device (this should not interfere with the 2.0
  116.             iffparse.library).  (Some users have had problems if they had an
  117.             earlier version of iff.library in their system and then replaced
  118.             it with this version.  The problem is that a program run before
  119.             Iconize that opens that library, even if it closes it, will leave
  120.             the library in memory and when Iconize tries to open it the OS
  121.             will find the one still in memory first and bail out because the
  122.             version is wrong.  To avoid this, if you already have an
  123.             iff.library in your libs: device, replace it with this version
  124.             and then re-boot.)  Next be sure that Iconize is in your path
  125.             somewhere.  Now you are ready to attack those IFF files.
  126.  
  127.             Note: One user couldn't get any icons to save, but he finally
  128.                   realized that he had a no-icon program running in his
  129.                   startup-sequence and thus disabled my program. :-)
  130.  
  131.            
  132. Syntax:     Iconize [filename(s)] an optional list of filenames
  133.  
  134.                     [directory(ies)] an optional list of directories to
  135.                                      Iconize
  136.  
  137.                     [-dDefaultToolType] allows specification of the default
  138.                                         tool for the project icon (i.e.
  139.                                         -dc:superview would make c:superview
  140.                                         the default tool)
  141.  
  142.                     [-i] indicates that all following files or directory
  143.                          contents will be ignored if they have an associated
  144.                          icon (.info file).  This is especially useful for
  145.                          adding pictures to that picture directory and just
  146.                          Iconize-ing the new pics.
  147.  
  148.                     [-p#BitPlanes] allows specification of the number of
  149.                                    bitplanes in the icon (i.e. -p3 would
  150.                                    specify an 8 color icon) {default is 16
  151.                                    color icon}
  152.  
  153.                     [-sStackSize] allow specification of the stack size
  154.                                   provided to the default tool {default stack
  155.                                   is 4000}
  156.  
  157.                     [-xIconWidth] allows specification of the width of the
  158.                                   resulting icon (i.e. -x128 would specify a
  159.                                   width of 128 for the icon) {default width
  160.                                   is 64}
  161.  
  162.                     [-yIconHeight] allows specification of the height of the
  163.                                    icon
  164.  
  165. -------------------------------------------------------------------------------
  166.  
  167. Upgrades: v.90 - first release into gamma testing
  168.  
  169.           v.935 - 325% speed up!  
  170.                   "-i" option added
  171.                   Ability to name directories with contents to Iconize
  172.                   Defaults to usage info rather than attempting to Iconize
  173.                    entire current directory.
  174.  
  175. Please report any bugs to me and try to supply a copy of the problem causing
  176. file if you can.
  177.  
  178. -------------------------------------------------------------------------------
  179.  
  180. Future enhancements:  Not rely on iff.library which wastes memory.
  181.                       
  182.                       Handle SHAM, Dynamic HAM and Dynamic Hi-Res pictures.
  183.  
  184.                       Increase speed by converting entire processing heart
  185.                       to assembly.
  186.  
  187.                       Possibly adding rudimentary brightness control and
  188.                       maybe possibly adding even more rudimentary contrast
  189.                       control.
  190.  
  191.                       Even less likely than contrast, but still a possibilty
  192.                       of adding intuition interface.
  193.  
  194.                       Add processing pointer to show status while Iconize-ing.
  195. -------------------------------------------------------------------------------
  196.  
  197. Report any bugs and send any awe inspiring IFF files or donations [not
  198. requested but any and all accepted :-) ] to:
  199.  
  200.                       Rick Tillery
  201.                       
  202.                      {until May 1991}
  203.                       (405) 364-2372 (collect not accepted :-)
  204.                       314 E. Boyd #7
  205.                       Norman, OK, 73069
  206.                       UseNet: drtiller@uokmax.ecn.uoknor.edu
  207.  
  208.                      {after May 1991}
  209.                       5000 Ryan Dr.
  210.                       OKC, OK 73135
  211.  
  212.                       Cserve: 71020,1554
  213.                       GEnie: D.TILLERYJR
  214.                       Plink: WEL655
  215.