EXAMPLES OF USING THE OBERSUITE PROGRAMS
----------------------------------------
[Note:  When I write "Xpander", I also mean "Matrix-12."]

(1) ObGet

	Grab Xpander single patch 53 and store it in file "violin":

		obget s53 violin

	Same as above (case does not matter):

		obget S53 violin

	Grab Xpander multi patch 99 and store it in file "temp.multi" in the
	RAM disk:

		obget m99 ram:temp.multi

	Grab Xpander multi patch 61 and store it in file "crimson".
	If the file "crimson" already exists, overwrite it without
	informing the user (this uses the "-a" option):

		obget -a m61 crimson

	Grab Xpander single patch 03 and store it in file "snake".
	Run in "quiet" mode, with all program output turned off
	except error messages:

		obget -q s3 snake

	Same as above, but run in "super quiet" mode, turning off all
	output INCLUDING error messages:

		obget -Q s3 snake

	Grab ALL Xpander single patches and store them in file "everything":

		obget s everything

	Grab ALL Xpander multi patches and store them in file "multis":

		obget m multis

	Same as above, but overwrite the file "multis" if it already exists:

		obget -a m multis

	Same as above, but run in "quiet" mode.  Note that the transfer
	speed is increased by about 25%.

		obget -aq m multis

	Exactly the same as above (options may be separate or combined):

		obget -a -q m multis

	Exactly the same as above (options may be in any order):

		obget -q -a m multis


(2) ObPut

	Send data from the file "violin" to Xpander patch 98.  (We do
	not have to specify "single" or "multi" patch because the Xpander
	will recognize the data and use it appropriately.)

		obput 98 violin

	Same as the above, but run in "quiet" mode, turning off all output
	except for error messages:

		obput -q 98 violin

	Send the data from file "snake" back to its original patch location:

		obput snake

	Send 100 single patches from file "everything" to the Xpander:

		obput everything

(3) ObType

	Identify the contents of file "violin":

		obtype violin

	Same as above, but print only the patch name ("short" format):

		obtype -s violin

	Same as above, but print the output in "long" format:

		obtype -l violin

	Use ObType to verify that the patch data in file "violin" is
	valid.  If there is a data error, print an error message, but
	otherwise don't print anything:

		obtype -q violin

	Print the contents of file "everything" (which contains 100
	single patches) in a neat, 1-page format:

		obtype everything

	Same as above, but print only the patch names, 1 per line:

		obtype -s everything

	Same as above, but print in "long" format:

		obtype -l everything


(4) ObExtract

	In all the following examples, the file "everything" contains
100 single patches.

	Extract the data for patches 2, 3, and 71 from file "everything"
	and store them in files called "everything.s02", "everything.s03",
	and "everything.s71":

		obextract -f 2 3 71 everything

	Same as above, but the file names will be prefixed with the actual
	names of patches 2, 3, and 71, instead of "everything".  For example,
	if the patch names are TRUMPET, VIOLIN, and KABOOM, then the file
	names will be TRUMPET.s02, VIOLIN.s03, and KABOOM.s71:

		obextract -fr 2 3 71 everything

	Same as above (options may be combined or separate):

		obextract -f -r 2 3 71 everything

	Same as above (options may be in any order):

		obextract -r -f 2 3 71 everything

	Same as above, but any files that already exist will be overwritten
	automatically, without prompting the user:

		obextract -r -f -a 2 3 71 everything

	Same as above:

		obextract -arf 2 3 71 everything

	Extract patches 4 through 14 and 81 through 99, storing them in
	individual files.  All of the following examples are EXACTLY
	EQUIVALENT in behavior:

		obextract -f 4-14 81-99 everything
		obextract -f 14-4 81-99 everything
		obextract -f 99-81 4 6 5 7-14 everything
		obextract -f 82 9 99 5 10 14 13-4 81 83-97 98 everything

	Extract patches 20-30 and send them directly to the Xpander:

		obextract -o 20-30 everything

	Extract patches 1-10 from file "everything" and store them in
	individual files in the RAM: disk.

		1> cd
		df1:patches
		1> cd ram:
		1> obextract -f 1-10 df1:patches/everything

(5) Advanced examples

	Extract patch number 23 from the file "everything", and send
	it to patch location 91 in the Xpander:

		obextract -f 23 everything
		obput 91 everything.s23

	Say that your MIDI interface is using device "midi.device",
	unit 2:

		setenv OBERHEIM_DEVICE "midi.device:2"

