home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d5xx / d500 / wiconify.lha / wIconify / wIconSetter.lzh / wInfo2Icon / wInfo2Icon.doc < prev    next >
Text File  |  1991-04-19  |  4KB  |  81 lines
  1. OVERVIEW:
  2.  
  3. WINFO2ICON is a companion program to WICONIFY and WICONSETTER.  It converts
  4. Workbench .info files into icon files that can be used by wIconSetter or
  5. wIconify.  wInfo2Icon will automatically write the IMAGE, SELECT and MASK
  6. commands and data that correspond to the imagery for any Workbench icon.
  7.  
  8.  
  9. HOW TO USE WINFO2ICON:
  10.  
  11. To convert a Workbench icon to a wIconify icon, simply issue the command
  12.  
  13.     1> wInfo2Icon <infofile> <iconfile>
  14.  
  15. where <infofile> is the name of the .info file (the '.info' is added
  16. automatically by wInfo2Icon), and <iconfile> is the name of the icon file to
  17. be created.
  18.  
  19. wInfo2Icon will read the .info file and extract the icon's imagery.  It will
  20. convert this to the appropriate format for wIconSetter and wIconify, and
  21. produces a text file containing the imagery.  You may edit this text file to
  22. include additional commands, or to modify the icon images.
  23.  
  24. The Workbench supports four different kinds of icons:  ones that are
  25. complemented when selected, ones that are complemented with the backgound
  26. color flood-filled around the edges of the image, ones that have
  27. separate select images, and ones that have no highlighting at all.  Each of
  28. these types is treated differently to achieve the same result in wIconify.
  29.  
  30. The first type is implemented simply by providing an IMAGE command and data
  31. that represents the icon image.  wIconify automatically uses complement
  32. select mode.
  33.  
  34. The second type uses an IMAGE command and a MASK command.  wIconify uses the
  35. mask to determine what to complement, and what part of the image is "active":
  36. you must click within the mask area in order to register a "hit" on the icon.
  37.  
  38. The third type is implemented with an IMAGE and SELECT command, to give the
  39. icon a different image when selected.  In addition, a MASK is also used to
  40. remove the background pixels when you drag the icon around (if these pixels
  41. were not removed, it would look like you were dragging part of the backgound
  42. around as well).  Note that the Workbench does not remove these pixels, so
  43. the wIconify icons should look slightly better when you move them.  If you
  44. want the effect to be exactly like the Workbench icons, simply use a text
  45. editor to remove the MASK command and its data from the file.
  46.  
  47. Finally, the fourth type is implemented using an IMAGE and SELECT command,
  48. both with the same data.  Thus the selected version of the icon will be the
  49. same as the unselected image.  As in the case above, wInfo2Icon also
  50. supplies a MASK command to make moving the icon look a little better.  If
  51. you do not want this mask, simply remove it using any text editor.
  52.  
  53. Note that many Workbench icons have an extra row of pixels on the bottom
  54. (to separate the icon's name from the icon's image).  Since wIconify adds
  55. one pixel above the icon name automatically, this is unnecessary for icons
  56. that will be used with wIconify.  You may want to remove these blank lines
  57. from the icons files created by wInfo2Icon using a text editor.  If you do,
  58. be sure to remove them from ALL the images (SELECT and MASK images, too).
  59.  
  60.  
  61. Once you have created the icon files, you can include them into the
  62. wIconSetter initialization file via the ICON: FROM <file> command, or by
  63. copying the data directly into the initialization file itself.  To use the
  64. icon file as the default image for wIconify, use the DEFAULT_ICON: <file>
  65. command in the wIconify.Init file.
  66.  
  67.  
  68. Note that Workbench icons are allowed to be almost any size, but wIconify
  69. icons are limited to 78 by 32 pixels in size.  Despite this limitation,
  70. wInfo2Icon will write files that are as large as the original icons, in most
  71. cases.
  72.  
  73.  
  74. AUTHOR:
  75.  
  76. Davide P. Cervone
  77. Mathematics Department
  78. Brown University
  79. Providence, Rhode Island 02912
  80. ST402523@BROWNVM
  81.