Documentation for the library OXTRICKS
**************************************


These programs are written for the OSBORNE EXECUTIVE and use some of the 
features peculiar to that machine.  Some of them will run on the OSBORNE
1 with some modification, like E-SKETCH and TRICKS.  Any of them may run
on other machines but don't count on it!

They are entered into the public domain for educational purposes only.
Please respect the spirit of this action and refrain from USING THEM FOR
COMMERCIAL PURPOSES.  Please note that TRICKS uses routines copied from
two other programs in the public domain. If their authors
are unhappy about my use they may contact me and I will be happy to add
their names to the programs.  That information is not available to me
at this time.  Please accept my apologies for this.

For fixes and discussion please contact VANRYPER c/o MBINEX, 
617-423-6985.
 
Best wishes, W. van Riper      17 February 1984

*****************************************************************************


FINDCHAR	lets you run through the full set of EXECUTIVE characters
		from 0-255 and prints them for your inspection - graphics too

E-SKETCH	etch-a-sketch program similar to SCRPAINT in the public 
		domain for the OSBORNE 1 except configured for the EXECUTIVE
		- creates a subroutine file that uses the bank-switching
		arrangement of the EXECUTIVE to write directly to video
		memory - very fast, and incorporating improvements over
		SCRPAINT such as the ability to place cursor directly anywhere
		on the screen at any time

WINDOW		this program creates a subroutine file that defines a 
		window on the screen - something that the EXECUTIVE can
		do but the OSBORNE 1 cant - you specify the rows and columns
		of the upper left corner and the lower right corner of the
		window and the number that you want the window to be called
		for future reference, and the program makes up the subroutine
		which you can then merge into another program - I have had up
		to 9 windows on screen concurrently....

TRICKS		is a program that combines and improves upon two others,
		namely OSBCARDS, published in the Portable Companion, and
		BLACKJAK, author unknown - it uses the EXECUTIVE'S bank-
		switching business and windowing capabilities to make an
		interesting graphics-oriented blackjack game - my apologies
		for the code - I am cleaning up someone else's mess and 
		may have an improved version in the future - but note:
		the original version worked fine and the author deserves
		my gratitude - it was terribly difficult to see what was
		going on, though!



VIDEONUM	this program just displays some of the key memory locations
		corresponding to locations of the screen in video memory -
                when writing to the EXECUTIVE'S video memory using the bank-
		switching code, one has to be aware that the memory addressed
		which is the map of the screen is different from that of the 
		OSBORNE 1 - this is one of the reasons that programs written
		for that machine will often not run on the EXECUTIVE - also
		one has to realize that the screen that you see is a sort of 
		upper-left corner of the total video memory, so that when you
		come to the end of a line and go to the next with a carriage
		return, there is a gap in the memory addresses 


FUNCTION	the EXECUTIVE terminal is allegedly patterned after the 
		Televideo 950 - according to the Reference Guide, "..and uses
		many of the same screen control characters..."
		well, that's quite true - some work and some don't-
		this program allows you to specify the ASCII codes of the
		control codes so you can see the result - useful for such 
		things as figuring out how to kill the cursor and make the 
		screen blink in a hideous parody of a meltdown display on a 
		reactor contol console.

	************************************************************

	Any further information on using the EXECUTIVE would be greatly
	appreciated.