
		Application compatilibity notes & HOWTO
		=======================================

playmidi
--------
  1) 'playmidi -D 0 -e <file>' - output to MIDI UART (MIDI port)
  2) 'playmidi -D 2 -e <file>' - output to GUS MIDI emulator
  3) 'playmidi -g <file>' - midi is emulated by playmidi
     - playmidi uses only .pat files with this situation
     - correct path for .pat files is only
			/dos/ultrasnd/midi or /usr/local/lib/Plib

jazz
----
  1) output via gus card
     - set .device parameter in ~/.jazz configuration file to 2
     - look to jazz.gus file in this directory for example
  2) output via gus card & input via MIDI UART (MIDI port),
     external keyboard have Local Control to ON (produce sound)
     - set .softthru to 0 (in ~/.jazz)
     - set .device to 2 (in ~/.jazz)
     - set parameter "midi_oss_swap_d0_to_d2 enable" in your gus.conf
     - reinsert driver (insgus -k, insgus)
     - look to jazz.gus file in this directory for example
  3) output via gus card & input via MIDI UART (MIDI port),
     external keyboard have Local Control to OFF (doesn't produce sound)
     - set .softthru to 1 (in ~/.jazz)
     - set .device to 2 (in ~/.jazz)
     - set parameter "midi_oss_swap_d0_to_d2 enable" in your gus.conf
     - reinsert driver (insgus -k, insgus)
     - look to jazz.gus file in this directory for example
  4) only external device is used
     - set .device to 0
     - set parameter "midi_oss_swap_d0_to_d2 disable" in your gus.conf
     - reinsert driver if needed (insgus -k, insgus)
     - look to jazz.uart file in this directory for example
  5) rerouting midi channels
     (some channels are played via gus card and other via MIDI port)
     - I'm sorry, people, but jazz doesn't support this.... :-(((

quake
-----
  Quake doesn't work with 128k DMA buffer (this is limitation for OSS
  driver - not for ultra driver). If you want use 128k DMA buffer
  for other applications - setup 128k buffer in gus.conf and use
  uquake script in this directory.

	echo "gus dma1_size 64" > /dev/gusinfo
	echo "gus dma2_size 64" > /dev/gusinfo
        xquake
        echo "gus dma1_size auto" > /dev/gusinfo
        echo "gus dma2_size auto" > /dev/gusinfo

						Jaroslav Kysela
						<perex@jcu.cz>
