BITSPY 1.25 (c) 1993 by B'Brox Productions BITSPY is Freeware. It can be distributed and used free of charge as long as the following files are included: BITSPY.PRG READ.ME DESKICON.RSC There is no warranty whatsoever. The program has been tested, but you never really know... This utility can be used to find bit-mapped graphics that are embedded within ANY type of file. By playing around with the display width and the display address it is possible to visually locate bit-mapped graphic blocks. The image visible on screen can then be cut out and saved to screen with a Snapshot utility. A simple Screen-to-Disk saver also works, but the images of course need to be cleaned up. At the moment there are the following limitations: 1) Only monochrome images are found 2) Packed (or otherwise treated) images are not shown 3) I haven't had a chance to test it on a color monitor or anything else but ST high res (640x400). 4) I still haven't written a GEMDOS error handler that catches ALL errors reliably. (This is in assembly language, man) I tried to make it as GEM conform as possible. A LITTLE TUTORIAL After starting BITSPY.PRG you are presented with a file selector. Load the demo file 'DESKICON.RSC' which you find in the same folder. After the file has loaded you will see the BITSPY window open up and some strange looking shapes appear. If you play with the window buttons (the arrow buttons on the left side of the window) you see that the shapes move or change appearance, depending on which buttons you click on. The up/down buttons move back and forward through the file. The left/right buttons increase/decrease the display width. You can see the current display values in the window info. Use the window buttons to set: Width: 4 Offset: 492 Adr:(not important) At this point you should be able to recognize some shapes familiar from the TOS 2.xx desktop. The Menu: Desk BitSpy 1.2 You know what... Other Open... Loads in a file to be viewed. Any filetype is ok. The only limit is the RAM that your computer has available. All display parameters are reset after loading a new file. The file in memory will of course be lost. Goto... In this box you can set the two display parameters by entering numbers. This can bring you to the other end of a huge file real fast or, for example. Width Number of bytes displayed in one single scanline. After number of bytes a new line begins. This of course defines the width of the image. If you happen to know what size of image you're looking for than setting width to an approximate value helps recognizing the image pattern. Offset Distance of the leftmost top byte in the buffer from the filestart. In other words how far you're in the file in relation to its beginning. Quit You know... The custom window buttons (left window corner): arrow up Move view area towards file start, one byte at a time. This results in some sort of sidewards scroll effect. You cannot move below the start address of your loaded file. two arrows up Move view area towards file start, as many bytes as set in the fast-move box. two arrows up /w ALTternate key pressed The fast-move control box pops up. Enter the number of bytes that you want to move every time you click the two-arrows-up button. The number you put in is not checked, therefore numbers higher than the length of the loaded file might move the view area into illegal RAM. two arrows down Same as two-arrows-up, only reversed direction. NO RANGE CHECK! two arrows down w/ ALTernate key pressed Brings up the same control box as two-arrows-up w/ ALT. Note that both, two-arrows-up and two-arrows-down use the same fast-move value! arrow down Moves the view area away from the filestart in one byte step. THERE IS NO RANGE CHECK HERE! It is possible to move beyond the loaded file (I guess programmer's laziness, sorry) arrow left Decreases the width of the view area one byte at a time. The minimum width is 1 byte. two arrows left Decreases the width of the view area by the number of bytes set in the fast-move box. two arrows left w/ ALTernate key pressed In this box you can set the fast-move value for two-arrows-left/two-arrows-right. All values are accepted. NO VALUE CHECK! two arrows right Same as two-arrows-left only the view area gets wider. two arrows right w/ ALTernate key pressed Brings up the same fast-move value box . The value in this box affects two-arrows-left and two-arrows-right. arrow right Widens the view area by one byte. The GEM window arrows. The GEM window arrows work just a little different from regular. For one thing you will never see a slider field (because of programmer's laziness..). When BITSPY loads a file it will keep the data in memory. Then a view block is created, according to the WIDTH and OFFSET values. This block is created on a virtual screen and has the size of one full screen. In the window you actually look at a specific chunk of that virtual screen. Using the GEM window arrows you can move your window within the virtual screen. Because of the fact that the virtual screen is a full screen, the window will never be able to show the full virtual screen. Images that turn out to be wider than a window can be snapshot in two takes. Clicking on the GEM window arrows while holding down the ALT key brings up a box in which you can enter the value that the window contents are shifted when using these arrows. There is one box for vertical movement and another one for horizontal. That about covers it. I haven't had time yet to implement some sort of snapshot. I am sure there are some utilities in the PD. (In fact there comes one with GEMVIEW that can be downloaded on GEnie). Im still working on the program so any input is welcome! Direct mail to: B'Brox Productions Peter Kienle / Monika Herzig 1502 S. Olive St. Bloomington, IN 47401 (812) 334 3022 GEnie:MHERZIG Bloomington 3/2/93