###############################
# RIGView/RIGConverter v2.1   #
#                             #
# by Paul Marks               #
# paul248@techie.com          #
# http://paul248.cjb.net      #
###############################


	@@@@@@@@@@@@@@@@@
	@@    @@@@@    @@ 
	@   @@     @@   @
	@  @         @  @
	@ @           @ @
	@ @           @ @
	@@ @ @ @ @ @ @ @@
	@@             @@
	@@ @ @ @ @ @ @ @@
	@@@ @ @ @ @ @ @@@
	@@@@@@@@@@@@@@@@@
	@ @ @ @ @ @ @ @ @
	@ @@@@@@@@@@@@@ @
	@  @@@@@@@@@@@  @
	@   @@@@@@@@@   @
	@@    @@@@@    @@
	@@@@@@@@@@@@@@@@@



// Platform //
>>	TI-83 Plus : MirageOS



// Description //
>>>	RIGView allows you to browse and view 4-level grayscale images on a
	TI-83 Plus.  It can access a maximum of 160 images.

>>>	RIGConverter is a Windows program that converts pictures into
	.8XP files that can be sent to the calculator and displayed with
	RIGView.  It can also create stand-alone programs with the
	grayscale routine built-in, for use with the Start-up Application.



// Directions //
1. Install MirageOS, if you haven't done so already

2. Send RIGVIEW.8XP to the calculator

3. Create picture files with RIGConverter and send them to the calculator.
	there are several pre-made pictures included in /images

4. Run RIGView to display the images

5. If the images have lines running through them, the you need to adjust the
   synchronization setting.  See "Keys" for more info.



// Keys //
	[2nd]		Toggle Between Image and Description.

	[<-],[->]	Previous/Next Image

	[(],[)]		Adjust Display Synchronization (Cleans up lines on the screen)

	[+],[-]		Adjust LCD contrast

	[.]		Pause

	[Clear]		Exit RIGView



// Version History //

10-2-2001
v2.1:
	[ RIGConverter ]

	>>>	Several changes in the user interface.
	
	>>>	Images that are not the correct size can now be stretched to fit the
		Display, but they will usually look better if resized in a photo editor.


	[ RIGView ]

 	>>>	Indexes all of the images in memory for much faster seeking.  This is
		more noticable if you have many pictures on your calculator (more than 10).

	>>>	Now includes a Pause key [.] to freeze the Grayscale, mainly so that you
		can see how it works.

	>>>	Optimized a few bytes out of the program, then added a lot more :)


9-26-2001
v2.0 (only released on my website):
	[ RIGConverter ]

	>>>	The brightness and contrast adjustments have been replaced by
		three sliders that set the thresholds between the different shades
		of gray.  This allows for more precise tweaking of the image

	>>>	There is now an "Auto" button, which will attempt to guess
		approximate values for the grayscale thresholds.

	>>>	A Histogram is generated for the current image, allowing you to
		see the brightness distribution in graphical form.

	>>>	Uses the RIGv2 file format for better image compression.


	[ RIGView ]

	>>>	Now uses a new version of the RIG format: RIGv2.  In RIGv2, the
		image is stored and compressed vertically.  This significantly
		increases the compression ratio.  Note that RIGv2 is incompatible
		with RIGv1.


8-13-2001
v1.1:
	[ RIGConverter ]

	>>>	Added the ability to convert pictures into no-shell ASM programs
		that exit when you press a key.  They should work with the TI
		start-up application. Thanks to Brian for the suggestion.


	[ RIGView ]

	>>>	Fixed a minor bug.  The DInput routine was returning 86h when no key
		was pressed.

8-1-2001
v1.0:
	>>>	Initial release.



Report any bugs/suggestions/typos to paul248@techie.com



// Notes //
RIGView can only access up to 160 images (not that you would want that many)



// What is RIG? //
RIG stands for Rotating Interlaced Grayscale.  I designed it to help reduce
flicker when displaying grayscale images on TI calculators.  The normal
way of generating grayscale is to have two layers, and flash one layer for a
period of time, then show the other layer for twice as long.  RIG Is different.
While writing to the screen, RIG interlaces the two layers together so that
one layer uses 1/3 of the screen area and the other layer uses 2/3.  Every
time the Screen copy routine is called, it shifts the positions of the layers,
creating a scanline effect instead of flicker.




// Using My Code //
You may use the code from RIGView freely, though I would prefer if you
gave me some credit if you release a program that uses it.  Also, don't go
telling people that RIG was your idea.  I'd also prefer if you didn't make small
changes to RIGView and re-release it on ticalc.org.  (Ever heard of FallUp?
Yeah, well don't do that.)




// Disclaimer //
To the best of my knowledge, these programs will not inflict any damage, but
if something goes wrong and causes a loss of data and/or time, then don't
hold me responsible.  I am also not responsible for the images that you choose
to convert and store.  Don't use RIGView while driving.  Incorrect statistics
show that 82% of car accidents are calculator related.