+==========================================================================+ | GPic83 Version 2.0 | +==========================================================================+ Contents: *==========================================================================* 1. Whats New in GPic83 2.0 2. Operation of GPic83 2.0 3. Developer Info 4. Known Bugs !! Earlier Gpic83 pictures are *NOT* compatable with this version !! 1. What's New in GPic83 2.0 *=====================================* o The GUI in this version has been completely revamped from the earlier versions to make it easier to use, while adding some new features o *NEW* Gpic83 now also supports changing the color depth in pictures so that if a picture flickers too much for your taste, you can reduce the color depth to reduce flickering to your liking. o The GUI now displays the size and color depth of the picture so you don't necessarily have to "count pixels" to figure that out... and so that the color depth does not remain a mystery to the user. o All the keys now run from the top 5 blue "function" keys with on-screen labels so you don't have to remember the layout of the keys on the keypad. This makes it much easier to use. o The screen doesn't clear every time you switch images, so the GUI is much less of an eye-sore than it was before. NOTE: You cannot increase the color depth past the default... for example an 8 color picture can be 2-color, 4-color or 8-color, whereas a 4-color picture can only be 2-color or 4-color. 2. Operation of GPic83 2.0 *=====================================* Keys: Y= "View" - Views the currently selected image ("View") Window "Next" - Searches for the next image, and returns to the first if there isn't one ("Next") Zoom "Down" - Lowers the color depth ("Down") Trace "Up" - Increases the color depth ("Up") Graph "Quit" - Either quits the program, or returns from viewing an image to the main screen. ("Quit") NOTE: Gpic83 2.0 will exit immediately if: There is not a picture in RAM (ION 1.4 or earlier) OR There are no pictures on the calc (ION 1.5+) So this is *NOT* a bug 3. Developer Info *=====================================* The header for the image is almost the same as it was before, with one added byte (instruction) to the beginning to keep the TI-OS from trying to run an image as an Assembly program... (that would be BAD). So it now looks like this: ret ;prevent TI-OS from running this .db "GPic83",0 ;detect string .db $08 ;name length (bytes) .db "Greypic",0 ;image name .db $02 ;number of layers .db $0B ;image height .db $02 ;image width (pixels/8) .dw $0016 ;total size ;(height * width [in bytes]) Just like before, you have to count up the number of bytes in the title, INCLUDING the terminating zero... so this one is 8 (7 + 1). Also, with the total size, it is again, height * width, where the width is the width in bytes (so it is the total linear size of 1 layer in RAM). And the image name can be any legnth up to the point where it goes off the screen... no word wrapping yet :) You can create the image with a tool such as iStudio and just add the header to the outputted source code (thats what I do at least). 4. Known Bugs *=====================================* There are actually none that I know of, but they could easily show up on somebody else's calculator... I have done massive debugging with Rusty Wagner's Virtual TI. [Thanks, Rusty! I dunno what i'd do without VTI :) ] But I haven't seen any yet. But if you do find one, please E-Mail me at pmarks@employees.org.