vfb01 - Virtual FM synthesizer / MIDI module


About vfb01
===========

 The program `vfb01' is a virtual MIDI synthesizer running on POSIX system.
 It can produce 4-operator FM synthesis sound (up to 128 voices).

 Features:

   * 4-Operator FM sound (featuring MAME's OPM emulator)
     (OPM-emu (C)1997,1998,1999 Jarek Burczynski (s0246@priv4.onet.pl))
   * Multi-channel (up to 16)
   * Acts as MIDI module (reads MIDI streams via raw MIDI device)
   * Users can customize all tone parameters
   * Some GM compatible features (volume curve, exclusive, etc...)
   * With loop-back MIDI device, many MIDI players can play with
   * Too heavy load :)


Install
=======

 Type:

  # ./configure ; make ; make install

 vfb01 is too heavy to exec. If your C compiler supports high-level
 optimization (like `-mpentiumpro', `-O6', `-mmmx' :) ,you may want to 
 specify these.

 I've compiled it with `-O6 -mk6 -mmmx' (with pgcc-2.95.2) and
 it works well.


Usage
=====

 Tiny usage:

  % vfb01 -m /dev/midi -d /dev/dsp

 and you can perform with external MIDI keyboards (connecting to /dev/midi).


 If your system has `Loopback MIDI device' (v_midi.o in Linux), you can
 play your MIDI files with your favorite MIDI player like following:

  % vfb01 -m /dev/midi01 -d /dev/dsp &
  % smfplay -m /dev/midi00 foo.mid

 In the case, /dev/midi00 and /dev/midi01 is a pair of loop-back MIDI
 device.


 vfb01 only supports `raw MIDI device'. A sequencer device (/dev/sequencer)
 don't supports. 
 Of cource, if your MIDI keyboards have serial connector like `TO HOST'
 or `COMPUTER', you can use it by specifying corresponding serial device
 to vfb01. (it means: `% vfb01 -m /dev/ttyXX' work)


 The detailed usage, information about configuration of tone parameters
 and some useful informations are found at doc/ directory. Please refer.


Copying
=======

 This program is free software; you can redistribute it and/or modify
 it under the terms of the GNU General Public License as published by
 the Free Software Foundation; either version 2, or (at your option)
 any later version.

 This program is distributed in the hope that it will be useful, but
 WITHOUT ANY WARRANTY; without even the implied warranty of
 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 General Public License for more details.

 You should have received a copy of the GNU General Public License
 along with this program; if not, write to the Free Software
 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.


Availability
============

 The latest version of vfb01 will be available at:

   http://member.nifty.ne.jp/Breeze/linux/index.html


Author
======

 vfb01 is made by

   Daisuke Nagano <breeze.nagano@nifty.ne.jp>


 Software implementation of YM-2151 (from MAME / MESS )

  (C) 1997,1998,1999 Jarek Burczynski (s0246@priv4.onet.pl)