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


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



// Important //
>>>	If RIGConverter gives an error involving MSVBVM60.DLL, then you
	must obtain the VB6 runtimes, which are availabe from many places,
	including the following URL:
	
	http://download.com.com/3000-2070-5531236.html



// 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 //

23Jul2002
v2.41
	>>>	Added a Cancel button to the Sync setting when creating a
		stand-alone program
		
	>>>	The Save Image button on RIGConverter can now be right-clicked
		to convert it into a Save Stand-alone or Copy to clipboard
		button.



26Jan2002
v2.4
	>>>	A few minor user-inerface updates.



07Jan2002
v2.3:
	[ RIGConverter ]

	>>>	Images are automatically prefixed with Theta in order to keep
		the PROG menu clean.

	[ RIGView ]
	
	>>>	Keys repeat now.  You can hold down an arrow and it will
		flip through the images.  This applies to Sync and contrast
		as well.

	>>>	I rewrote almost all of the code to make image seeking faster,
		and as a side-effect, i squashed a bug that was causing a few
		users to see only one picture.  Thanks to "puzzz" for running
		the countless betas that I sent to him.
		


18Nov2001
v2.2:
	[ RIGConverter ]
	
	>>>	Fixed a bug that caused invalid .8XP files under Windows 95


	[ RIGView ]
	
	>>>	No changes, but I wanted to make the version numbers match.



02Oct2001
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 :)



26Sep2001
v2.0
	[ 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.



13Aug2001
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.


01Aug2001
v1.0:
	>>>	Initial release.



Please notify me of any bugs/suggestions/typos



// 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.