home *** CD-ROM | disk | FTP | other *** search
/ Windoware / WINDOWARE_1_6.iso / winutil / iconma / read_me.man < prev   
Text File  |  1991-04-26  |  6KB  |  103 lines
  1. This utility will allow you to scan through an .EXE or .DLL file and view
  2. all icons present.  Icons are not divided into icon groups, so you might
  3. see multiple version of the same icon (these will be icons used for different
  4. resolution devices).  By using the View Next button, the next icon will be
  5. displayed and by using the View Prev button the previously view icon can
  6. be brought back and displayed.
  7.  
  8. If the Save button is pressed, a filename may be entered and the currently
  9. visible icon will be saved into a file with the .ICO format.  You will be
  10. presented with a dialog box asking for a file name.  There will also be two
  11. radio buttons, one asking if you'd like to save the icon group, another
  12. asking if you'd like to save the individual icon.  While advancing through
  13. the icons, you may have noticed that some icons have the same name or number.
  14. These icons are called an icon group and, if the icon group radio button is
  15. enabled, all of these icons will be stored in the same file.  Such icon group
  16. files are used to adjust the icon for different devices.  Thus, using an icon
  17. group file will display a different icon based on whether the computer has a
  18. VGA, EGA, Monochrome, or CGA display.  All four of these device types will
  19. not always be represented in a group, so don't worry if you only see one or
  20. two icons with the same name or number.
  21.  
  22. If the Replace button is pressed, you will be presented with a dialog box
  23. containing a list of all files with the .ICO extension in your current
  24. directory.  By selecting any .ICO file in the list, or by changing directories
  25. and selecting a .ICO file someplace else, you will replace the currently
  26. viewed icon with the icon contained in the selected file.
  27. NOTE: At this time, only files containing a single icon are supported and this
  28.       icon must be in the exact same format as the icon being replaced.
  29.  
  30. This program was created as a quick way to view and maintain icons in some of
  31. icon libraries (DLL's) available since the available tools (e.g. The Whitewater
  32. and Edensoft Resource Toolkits) require somewhat more time to perform minor
  33. functions such as this.  This should offer an easy way to quickly extract only
  34. the icons that one wants and/or needs.  For more advanced manipulation
  35. or for the editing of icons, I would suggest purchasing one of the two tools
  36. mentioned previously.
  37.  
  38. NOTE: Due to radically different formats, Windows Version 2.1 icons can not
  39.       be read by this utility.  Some programs may run under both Windows 2.1 and
  40.       Windows 3.0.  An example of this is WinWord.  Icons in such programs are
  41.       stored in Windows 2.1 format, and thus can not be read.
  42.  
  43. A similar version of this program exists (IconExt) that will only extract
  44. icons, not replace them.  I plan to still distribute IconExt as a separate
  45. application for use by those people who are distributing icon DLL's and
  46. encourage such people to distribute IconExt with their DLL, with the
  47. understanding that IconExt remains mine and people must register it
  48. separatly in order to receive support or information on modifications.
  49.  
  50. If you find this program interesting and would like to hear about future
  51. enhancements and/or tools please send $20 to:
  52.  
  53.    Patrick Deupree
  54.    4500 Sojourn, #2606
  55.    Addison, TX 75248
  56.  
  57. Please mail any comments you might have to the above address or send me
  58. e-mail on CompuServe at user ID 76427,442.
  59.  
  60. Authors Note:
  61.  
  62. I've not put an "automatic" about box or timed registration reminder in this
  63. program, the reason being I've always found such things annoying, most
  64. people ignore them, and it's a waste of time to write the code that does
  65. so.
  66.  
  67. I would also like to mention that I've created this program using a set of
  68. tools that I would also consider selling (compiled library only, no
  69. code).  The two code sets I've used are:
  70.  
  71.     listman: This is a data set manager that will allow variable length
  72.              data items to be stored in a list and retrieved.  This data
  73.              set manager does not create a new memory handle for each
  74.              item it adds in the list and does not require Windows to be
  75.              in standard or enhanced mode to use it.  At this time item
  76.              deletion does not free associated memory, however there is
  77.              a function to free all memory allocated to the list.
  78.  
  79.     resinfo: This currently contains five major functions.  One will read
  80.              an exe file and contain a data set of all resources of a
  81.              particular type (that type being fed in as an argument).
  82.              Another will save a single icon as a .ICO file, given its
  83.              DIB data and given it's icon file header.  There is also a
  84.              function that will save an icon group.  In the reverse, there
  85.              is a function to read a .ICO file and return its DIB data and
  86.              icon file header.  The final function will write an icon to
  87.              a .EXE file, using information contained within the data set
  88.              returned from the first function.  I will also, probably, be
  89.              moving the routines I've written to display the icon into
  90.              this module.  This tool set uses the previously mentioned
  91.              "listman" tool set.
  92.  
  93. In addition to these tool sets, I've created a DOS program that will extract
  94. Icon, Bitmap, and Cursor resources from an executable or resource file and
  95. will also display information on Dialog, Menu, and String entries (such
  96. as name, and info on menu items and controls such as item width, item ID, and
  97. item name).
  98.  
  99. The reason I mention these is that I would be interested in finding out how
  100. many people would like these tools.  I make no promises as to the
  101. availability of these tools as how much work I put into them depends on
  102. how much interest there is.
  103.