home *** CD-ROM | disk | FTP | other *** search
/ Windows Shareware GOLD / NuclearComputingVol3No1.cdr / _bbs4 / f1429.zip / READ_ME.MAN < prev   
Text File  |  1991-05-09  |  9KB  |  158 lines
  1. This utility will allow you to scan through an .EXE or .DLL file and view
  2. all bitmaps present.  By using the right arrow button, the next bitmap will be
  3. displayed and by using the left arrow button the previous bitmap can
  4. be brought back and displayed.
  5.  
  6. When the Open button is pressed, a list of files with the .EXE extension
  7. will be presented in one listbox and a list of alternate drives/directories
  8. will be presented in another.  Using these two lists a file can be
  9. selected.  Files with the .DLL extension, and even the .DRV extension
  10. can also be read by the BitMan program.  To see a list of files with either
  11. of these extensions merely click the mouse in the edit control at the top
  12. of the file selection dialog and replace the .EXE text with .DLL, .DRV,
  13. or whatever text is desired.  There are other files with non-standard
  14. extensions that are readable by BitMan.  Basically the technical explanation
  15. is that any file that contains Windows resources appended by the Windows
  16. Resource Compiler can be read by BitMan, if they contain bitmaps.
  17.  
  18. Key information on each bitmap will be displayed as it is viewed.  This
  19. information includes the following:
  20.  
  21.     Name of bitmap in the resource file
  22.     Dimension of bitmap (in pixels)
  23.     Number of colors in bitmaps color palatte
  24.     Type of bitmap (Windows, OS2, Other)
  25.  
  26. It is unlikely that "Other" will ever appear as a bitmap type as the program
  27. would most likely terminate before reaching such a point.
  28.  
  29. In addition to using the right and left arrows to scan through bitmaps,
  30. the right and left arrow keys of the keyboard can be used as well.  Or
  31. the Tab key can be pressed until a dotted rectangle is visible around the
  32. desired direction buttons arrow and the space bar can be pressed.  If a
  33. bitmap is larger than the display area, scroll bars will appear that will
  34. allow you to scroll the bitmap.  If only a vertical or only a horizontal
  35. scroll bar appear, then the bitmap was able to fit in the window in one
  36. direction, but unable to fit in another.  Bitmaps that are smaller than
  37. the window will be centered within the window.
  38.  
  39. If the Save button is pressed, a filename may be entered and the currently
  40. visible bitmap will be saved into a file with the .BMP format.  You will be
  41. presented with a dialog box containing the name of the currently visible
  42. bitmap followed by the .BMP extension.  Any file and path can be entered
  43. in this edit control and the bitmap will be saved to the file with that
  44. name.  The bitmap will be saved in the format that is displayed on the
  45. BitMan screen (e.g Windows or OS2).
  46.  
  47. If the Replace button is pressed, you will be presented with a dialog box
  48. containing a list of all files with the .BMP extension in your current
  49. directory, and a list of directories and drives to which you can also look.
  50. After selecting a .BMP file from this list the cursor will turn to an
  51. hourglass and there will be some disk activity.  If there are many bitmaps
  52. and other resources in the file being viewed, and the bitmap selected for
  53. replacement is a different size than the bitmap selected to replace it
  54. this might take a few seconds.  If the bitmaps are the same size then
  55. this will be a fairly quick process.  If a bitmap with the OS2 format is
  56. replaced with a bitmap with the Windows format, the program will probably
  57. still work.  Windows supports display of bitmaps of either format and I
  58. have successfully replaced bitmaps of the OS2 type in Solitaire with
  59. bitmaps of the Windows type as a test case.
  60.  
  61. NOTE: This program does NOT create a backup of the file being viewed.  If
  62.       you choose to replace a bitmap in a program, I highly suggest that
  63.       you create a backup of that program.  I've only found one case where
  64.       BitMan has corrupted the file to the point where it could not be used,
  65.       but that file was VGA.DRV and I'm not sure how a device driver
  66.       accesses its resources.
  67.  
  68. Known Bugs:  For some reason my program will die in the middle of a Windows
  69.              function in some rare cases.  Examples of these cases are viewing
  70.              the "SETUP.EXE" program in enhanced mode (386), or viewing the
  71.              "WINHELP.EXE" program in standard mode (286).  However, when
  72.              running in standard mode I can view all bitmaps in "SETUP.EXE"
  73.              and when running in enhanced mode I can view all bitmaps in
  74.              "WINHELP.EXE".  All programs, to date, can be read in real
  75.              mode with no difficulties.  So, if you have trouble reading
  76.              a particular file, use one of the following to switch modes
  77.              in Windows:
  78.  
  79.                    /r - Real Mode
  80.                    /s - Standard Mode
  81.                    /e - Enhanced Mode
  82.  
  83.              I've also not tested this program with bitmaps larger than
  84.              64K as it's unlikely to find such a bitmap as a resource.  It
  85.              will probably work, but I make no guarantees.
  86.  
  87. This program was created as a quick way to view and maintain bitmaps in some of
  88. programs and libraries (DLL's) available since the available tools (e.g. The
  89. Whitewater and Edensoft Resource Toolkits) require somewhat more time to
  90. perform minor functions such as this.  This should offer an easy way to
  91. quickly extract only the bitmaps that one wants and/or needs.  For more
  92. advanced manipulation or for the editing of icons, I would suggest purchasing
  93. one of the two tools mentioned previously.  The Paint program that comes with
  94. Windows 3.0 will edit any file extracted by BitMan (at least it has for
  95. me).  Bitmaps that are smaller than 72 x 72 pixels can also be edited by the
  96. SDKPaint program that comes with the Windows Software Developers Toolkit.
  97.  
  98. NOTE: Due to radically different formats, Windows Version 2.1 bitmaps can not
  99.       be read by this utility.  Some programs may run under both Windows 2.1 and
  100.       Windows 3.0.  An example of this is WinWord.  Resources in such programs
  101.       are stored in Windows 2.1 format, and thus can not be read.
  102.  
  103. If you find this program interesting and would like to hear about future
  104. enhancements and/or tools please send $20 to:
  105.  
  106.    Patrick Deupree
  107.    4500 Sojourn, #2606
  108.    Addison, TX 75248
  109.  
  110. Please mail any comments you might have to the above address or send me
  111. e-mail on CompuServe at user ID 76427,442.
  112.  
  113. Authors Note:
  114.  
  115. I've not put an "automatic" about box or timed registration reminder in this
  116. program, the reason being I've always found such things annoying, most
  117. people ignore them, and it's a waste of time to write the code that does
  118. so.
  119.  
  120. I would also like to mention that I've created this program using a set of
  121. tools that I would also consider selling (compiled library only, no
  122. code).  The two code sets I've used are:
  123.  
  124.     listman: This is a data set manager that will allow variable length
  125.              data items to be stored in a list and retrieved.  This data
  126.              set manager does not create a new memory handle for each
  127.              item it adds in the list and does not require Windows to be
  128.              in standard or enhanced mode to use it.  At this time item
  129.              deletion does not free associated memory, however there is
  130.              a function to free all memory allocated to the list.
  131.  
  132.     resinfo: This currently contains five major functions.  One will read
  133.              an exe file and contain a data set of all resources of a
  134.              particular type (that type being fed in as an argument).
  135.              Another will save a single bitmap as a .BMP file, given its
  136.              DIB data.  In the reverse, there is a function to read a .BMP
  137.              file and return its DIB data and bitmap file header.  The final
  138.              function will write a resource to a .EXE file, using information
  139.              contained within the data set returned from the first function.
  140.  
  141.     bitview: This currently contains a window class that provides a bitmap
  142.              view window.  A bitmap is attached to this window through
  143.              a single Windows message call and, after that, the window
  144.              will do all the rest (scrolling, repainting, etc).  This
  145.              window will support bitmaps in bitmap, icon, or cursor
  146.              format.
  147.  
  148. In addition to these tool sets, I've created a DOS program that will extract
  149. Icon, Bitmap, and Cursor resources from an executable or resource file and
  150. will also display information on Dialog, Menu, and String entries (such
  151. as name, and info on menu items and controls such as item width, item ID, and
  152. item name).
  153.  
  154. The reason I mention these is that I would be interested in finding out how
  155. many people would like these tools.  I make no promises as to the
  156. availability of these tools as how much work I put into them depends on
  157. how much interest there is.
  158.