home *** CD-ROM | disk | FTP | other *** search
/ GEMini Atari / GEMini_Atari_CD-ROM_Walnut_Creek_December_1993.iso / files / graphics / utility / bitspy12 / read.me < prev   
Encoding:
Text File  |  1993-03-02  |  6.7 KB  |  198 lines
  1. BITSPY 1.25
  2. (c) 1993 by B'Brox Productions
  3.  
  4. BITSPY is Freeware. It can be distributed and used free of charge as long
  5. as the following files are included:
  6. BITSPY.PRG
  7. READ.ME
  8. DESKICON.RSC
  9.  
  10. There is no warranty whatsoever. The program has been tested, but you never
  11. really know...
  12.  
  13. This utility can be used to find bit-mapped graphics that are embedded
  14. within ANY type of file. By playing around with the display width and the
  15. display address it is possible to visually locate bit-mapped graphic
  16. blocks. The image visible on screen can then be cut out and saved to screen
  17. with a Snapshot utility. A simple Screen-to-Disk saver also works, but
  18. the images of course need to be cleaned up. At the moment there are the
  19. following limitations:
  20.  
  21. 1) Only monochrome images are found 
  22. 2) Packed (or otherwise treated) images are not shown 
  23. 3) I haven't had a chance to test it on a color monitor or anything else
  24. but ST high res (640x400).
  25. 4) I still haven't written a GEMDOS error handler that catches ALL errors
  26. reliably. (This is in assembly language, man)
  27.  
  28. I tried to make it as GEM conform as possible.
  29.  
  30.  
  31. A LITTLE TUTORIAL
  32.  
  33. After starting BITSPY.PRG you are presented with a file selector.
  34. Load the demo file 'DESKICON.RSC' which you find in the same folder.
  35.  
  36. After the file has loaded you will see the BITSPY window open up and some
  37. strange looking shapes appear.
  38.  
  39. If you play with the window buttons (the arrow buttons on the left side of
  40. the window) you see that the shapes move or change appearance, depending on
  41. which buttons you click on.
  42.  
  43. The up/down buttons move back and forward through the file. The left/right
  44. buttons increase/decrease the display width.
  45.  
  46. You can see the current display values in the window info.
  47.  
  48. Use the window buttons to set:
  49.  Width:   4 Offset: 492 Adr:(not important)
  50.  
  51. At this point you should be able to recognize some shapes familiar from the
  52. TOS 2.xx desktop.
  53.  
  54.  
  55.  
  56.  
  57. The Menu:
  58.  
  59. Desk
  60.      BitSpy 1.2
  61.           You know what...
  62.  
  63. Other
  64.      Open...
  65.           Loads in a file to be viewed. Any filetype is ok. The only limit
  66.           is the RAM that your computer has available. All display
  67.           parameters are reset after loading a new file. The file in memory
  68.           will of course be lost.
  69.  
  70.      Goto...
  71.           In this box you can set the two display parameters by entering
  72.           numbers. This can bring you to the other end of a huge file real
  73.           fast or, for example.
  74.                Width
  75.                     Number of bytes displayed in one single scanline. After
  76.                     <WIDTH> number of bytes a new line begins. This of
  77.                     course defines the width of the image. If you happen to
  78.                     know what size of image you're looking for than setting
  79.                     width to an approximate value helps recognizing the
  80.                     image pattern.
  81.                Offset
  82.                     Distance of the leftmost top byte in the buffer from
  83.                     the filestart. In other words how far you're in the
  84.                     file in relation to its beginning.
  85.  
  86.      Quit
  87.           You know...
  88.  
  89.  
  90. The custom window buttons (left window corner):
  91.      arrow up
  92.           Move view area towards file start, one byte at a time. This
  93.           results in some sort of sidewards scroll effect. You cannot move
  94.           below the start address of your loaded file.
  95.  
  96.      two arrows up
  97.           Move view area towards file start, as many bytes as set in the
  98.           fast-move box.
  99.  
  100.           two arrows up /w ALTternate key pressed
  101.                The fast-move control box pops up. Enter the number of bytes
  102.                that you want to move every time you click the two-arrows-up
  103.                button. The number you put in is not checked, therefore
  104.                numbers higher than the length of the loaded file might move
  105.                the view area into illegal RAM.
  106.  
  107.      two arrows down
  108.           Same as two-arrows-up, only reversed direction. NO RANGE
  109.           CHECK!
  110.  
  111.           two arrows down w/ ALTernate key pressed
  112.                Brings up the same control box as two-arrows-up w/ ALT. Note
  113.                that both, two-arrows-up and two-arrows-down use the same
  114.                fast-move value!
  115.  
  116.      arrow down
  117.           Moves the view area away from the filestart in one byte step.
  118.           THERE IS NO RANGE CHECK HERE! It is possible to move beyond the
  119.           loaded file (I guess programmer's laziness, sorry)
  120.  
  121.      arrow left
  122.           Decreases the width of the view area one byte at a time. The
  123.           minimum width is 1 byte.
  124.  
  125.      two arrows left
  126.           Decreases the width of the view area by the number of bytes set
  127.           in the fast-move box.
  128.  
  129.           two arrows left w/ ALTernate key pressed
  130.                In this box you can set the fast-move value for
  131.                two-arrows-left/two-arrows-right. All values are accepted.
  132.                NO VALUE CHECK!
  133.  
  134.      two arrows right
  135.           Same as two-arrows-left only the view area gets wider.
  136.  
  137.           two arrows right w/ ALTernate key pressed
  138.                Brings up the same fast-move value box . The value in this
  139.                box affects two-arrows-left and two-arrows-right.
  140.  
  141.      arrow right
  142.           Widens the view area by one byte.
  143.  
  144.  
  145. The GEM window arrows.
  146.  
  147. The GEM window arrows work just a little different from regular. For one
  148. thing you will never see a slider field (because of programmer's
  149. laziness..). When BITSPY loads a file it will keep the data in memory. Then
  150. a view block is created, according to the WIDTH and OFFSET values. This
  151. block is created on a virtual screen and has the size of one full screen.
  152. In the window you actually look at a specific chunk of that virtual screen.
  153. Using the GEM window arrows you can move your window within the virtual
  154. screen. Because of the fact that the virtual screen is a full screen, the
  155. window will never be able to show the full virtual screen. Images that turn
  156. out to be wider than a window can be snapshot in two takes.
  157.  
  158. Clicking on the GEM window arrows while holding down the ALT key brings up
  159. a box in which you can enter the value that the window contents are shifted
  160. when using these arrows. There is one box for vertical movement and another
  161. one for horizontal.
  162.  
  163.  
  164. That about covers it.
  165.  
  166. I haven't had time yet to implement some sort of snapshot. I am sure there
  167. are some utilities in the PD. (In fact there comes one with GEMVIEW that
  168. can be downloaded on GEnie).
  169.  
  170. Im still working on the program so any input is welcome!
  171.  
  172. Direct mail to:
  173.  
  174. B'Brox Productions
  175. Peter Kienle / Monika Herzig
  176. 1502 S. Olive St.
  177. Bloomington, IN 47401
  178. (812) 334 3022
  179.  
  180. GEnie:MHERZIG
  181.  
  182. Bloomington 3/2/93
  183.  
  184.      
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.      
  195.  
  196.  
  197.  
  198.