Blame seq/sbiload/README

Packit Service b98cfc
This is sbiload - an OPL2/3 FM instrument loader for ALSA hwdep
Packit Service b98cfc
Packit Service b98cfc
Written by Uros Bizjak <uros@kss-loka.si>
Packit Service b98cfc
Web: http://www.kss-loka.si/~uros/sbiload.html
Packit Service b98cfc
Packit Service b98cfc
See the file COPYING for licence details.
Packit Service b98cfc
Packit Service b98cfc
Build and install
Packit Service b98cfc
-----------------
Packit Service b98cfc
Packit Service b98cfc
You should be able to just type 'make'.  All configuration variables
Packit Service b98cfc
are in make.conf if you need to change anything.
Packit Service b98cfc
Packit Service b98cfc
By default it will install into /usr/local/bin, change INSTDIR in
Packit Service b98cfc
make.conf to change this.
Packit Service b98cfc
Packit Service b98cfc
Usage
Packit Service b98cfc
-----
Packit Service b98cfc
Packit Service b98cfc
	sbiload [options] [instfile [drumfile]]
Packit Service b98cfc
	sbiload [options] -c
Packit Service b98cfc
Packit Service b98cfc
	  -D, --device=name       - An ALSA hwdep name to use
Packit Service b98cfc
	  -c, --clear             - Clear patches and exit
Packit Service b98cfc
	  -2  --opl2              - Two operators (OPL2) file type
Packit Service b98cfc
	  -4  --opl3              - Four operators (OPL3) file type
Packit Service b98cfc
	  -P, --path=path         - Specify the patch path
Packit Service b98cfc
	  -v, --verbose=level     - Verbose level
Packit Service b98cfc
	  -q, --quiet             - Be quiet, no error/warning messages
Packit Service b98cfc
          -V, --version           - Show version
Packit Service b98cfc
Packit Service b98cfc
When you have multiple sound cards and/or there may be multiple OPL2/3
Packit Service b98cfc
synth devices, you have to tell sbiload which one to use, and pass its
Packit Service b98cfc
hwdep name via -D option.  Otherwise, sbiload will load the data onto
Packit Service b98cfc
the first found device.
Packit Service b98cfc
Packit Service b98cfc
To find out the hwdep name of the OPL devices,  check
Packit Service b98cfc
/proc/asound/hwdep file first.  It has the list of hwdep devices
Packit Service b98cfc
currently available on your system.
Packit Service b98cfc
Packit Service b98cfc
	% cat /proc/asound/hwdep
Packit Service b98cfc
	00-00: Emux WaveTable
Packit Service b98cfc
        00-01: OPL3 FM
Packit Service b98cfc
	01-00: OPL3 FM
Packit Service b98cfc
Packit Service b98cfc
In the example above, you have two OPL3 devices.  To the first one
Packit Service b98cfc
(00-01), which means the first card (00-) and the second device (01),
Packit Service b98cfc
pass "-D hw:0,1".  For the second OPL3 device (01-00), pass "-D
Packit Service b98cfc
hw:1,0" instead.
Packit Service b98cfc
Packit Service b98cfc
For convenience, -D option accepts a string like /dev/snd/hwC0D3.
Packit Service b98cfc
This is automatically parsed as "hw:0,3".
Packit Service b98cfc
Packit Service b98cfc
Running sbiload
Packit Service b98cfc
---------------
Packit Service b98cfc
Packit Service b98cfc
Pass the instrument and drum file data as arguments.
Packit Service b98cfc
Packit Service b98cfc
	% sbiload std.o3 drums.o3
Packit Service b98cfc
Packit Service b98cfc
Without a file type option (-2 or -4), sbiload will guess the file
Packit Service b98cfc
type according to the hwdep iface type.  If it's not correct, pass -2
Packit Service b98cfc
or -4 option explicitly.
Packit Service b98cfc
Also, when the given file isn't found, sbiload tries to load a file
Packit Service b98cfc
with an appropriate extension, .sb for OPL2 and .o3 for OPL3.
Packit Service b98cfc
Packit Service b98cfc
You can omit the instrument and the drum file names, too.  In this
Packit Service b98cfc
case, the default file name "std" and "drums" are chosen.
Packit Service b98cfc
Packit Service b98cfc
The option -c is to mean just to clear patches and exit without
Packit Service b98cfc
loading patches.
Packit Service b98cfc
Packit Service b98cfc
Acknowledgements
Packit Service b98cfc
----------------
Packit Service b98cfc
Packit Service b98cfc
sbiload includes work from Steve Ratcliffe (pmidi-1.4.1.tar.gz) and
Packit Service b98cfc
Jaroslav Kysela (alsamod-1999-09-01.tar.gz).
Packit Service b98cfc
Packit Service b98cfc
Where to report bugs and feedback
Packit Service b98cfc
---------------------------------
Packit Service b98cfc
Packit Service b98cfc
Please report any problems to uros@kss-loka.si