install

MIDI解码程序(用VC编写)

#define AUDIO_BUFFER_BITS 12

I guess this values no need to change.

** CONTROLS_PER_SECOND

TiMidity++ do not calculate every envelope changes, but calculate some
samples at one time.  Small controls yields better quality sound, but
also eat much CPU time.  By default:

#define CONTROLS_PER_SECOND 1000

This can be changed from command line.  Leave as it is.

** DEFAULT_RESAMPLATION

Type of interpolation engine.  By default:

#define DEFAULT_RESAMPLATION resample_gauss

This definition cause TiMidity++ to Gauss-like interpolation in re-
sampling, and the quality of sound would be nice.  But it eats CPU
powers.  I recommend define it if your machine has much power.  Other
choices are (sorted by their speed):

#define DEFAULT_RESAMPLATION resample_none
#define DEFAULT_RESAMPLATION resample_linear
#define DEFAULT_RESAMPLATION resample_lagrange
#define DEFAULT_RESAMPLATION resample_cspline
#define DEFAULT_RESAMPLATION resample_gauss
#define DEFAULT_RESAMPLATION resample_newton

Interpolation methods are changeable from the command line.  If you
want to prevent users from doing so, uncomment next line and define as
this:

#define FIXED_RESAMPLATION

** USE_DSP_EFFECT

Configuration of USE_DSP_EFFECT to refine chorus, delay, EQ and
insertion effect.  Default enabled.

** LOOKUP_HACK

Configuration of LOOKUP_HACK.  By default, this features are undefined
like this:

/* #define LOOKUP_HACK */
/* #define LOOKUP_INTERPOLATION */

This option saves a little CPU power, but sound quality would decrease
noticeably.  If your machine suffers from lack of CPU power, enable
it.

** SMOOTH_MIXING

Defining this greatly reduces popping due to large volume/pan changes.
This is definitely worth the slight increase in CPU usage.

** FAST_DECAY

Configuration of FAST_DECAY.  By default:

/* #define FAST_DECAY */

This option makes envelopes twice as fast and saves CPU power.  But
since the release time of voices is shorten, the sound would be poor.
This feature is controllable in command line option.

** FRACTION_BITS

TiMidity++ uses fixed-point calculation.  Its default is

#define FRACTION_BITS 12

and you don't have to change this value.

** ADJUST_SAMPLE_VOLUMES

Configuration of adjusting amplitude of GUS/patch.  By default:

#define ADJUST_SAMPLE_VOLUMES

This option makes TiMidity to adjust amplitudes of each GUS/patch to
same volume.

** DENGEROUS_RENICE

By default this feature is disabled:

/* #define DANGEROUS_RENICE -15 */

If you want to increase process priority of TiMidity++ by using setuid
root enable this option.  This option is only available in UNIX.  Once
you enabled this option, you should install timidity with the follow-
ing procedure:

# chown root /usr/local/bin/timidity
# chmod u+s /usr/local/bin/timidity

Note: You should not set setuid to timidity if DANGEROUS_RENICE isn't
      enabled.

** MAX_DIE_TIME

If this value is too small, click noise would be come.  Default is:

#define MAX_DIE_TIME 20

and I recommend this value leave to this.

** LOOKUP_SINE

#define LOOKUP_SINE

On some machines (especially PCs without math coprocessors), looking
up sine values in a table will be significantly faster than computing
them on the fly.  I recommend define it.

** PRECALC_LOOPS

Configuration of optimizing re-sampling.  By default:

#define PRECALC_LOOPS

These may not in fact be faster on your particular machine and
compiler.

** USE_LDEXP

Configuration of use of ldexp().  By default this feature is disabled:

/* #define USE_LDEXP */

If your machine can multiply floating point number with ldexp() faster
than other method, enable this option.

** DEFAULT_CACHE_DATA_SIZE

Size of pre-re-sampling cache.  By default:

#define DEFAULT_CACHE_DATA_SIZE (2*1024*1024)

This can be changed from command line, so you don't have to change
here.

* Configurations about network

TiMidity++ can access any files via networks with URL.  This feature
are configurable in Makefile.  If you have enabled this feature in
Makefile (configure --enable-network), configure the following macros:

** MAIL_DOMAIN

specifies domain name of your name address.  If your name address is
"[e-mail]" set the macro:

#define MAIL_DOMAIN "@onicos.co.jp"

** MAIL_NAME

specifies mail name of yours if in Windows.  In UNIX, uncomment it.
For example, your name address is "[e-mail]" set the macro:

#define MAIL_NAME "iz"

** TMPDIR

Configuration of temporary directory.  By default, this option is
disabled:

/* #define TMPDIR "/var/tmp" */

In UNIX, if this option is disabled TiMidity++ creates temporary files
in the path specified by the environment variable TMPDIR.  If environ-
ment variable TMPDIR also isn't defined, TiMidity++ creates temporary
files in /tmp.  In Windows, TMPDIR variable are ignored.  So you
should specify the temporary path with this macro.

** GS_DRUMPART

Recognizing GS drum part by GS exclusive message.

#define GS_DRUMPART

enables to recognize GS exclusive message to set drum part.

/* #define GS_DRUMPART */

disables this feature.

* Japanese-text-handling related options

There are some options for Japanese handling.

** JAPANESE

If your system is in Japanese environment, define

#define JAPANESE

otherwise comment it out like

/* #define JAPANESE */

** OUTPUT_TEXT_CODE

specifies output text code (in Japanese environment).  You should
specify appropriate code name to OUTPUT_TEXT_CODE macro.  The follow-
ing strings are available:

AUTO
  Auto conversion by `LANG' environment variable (UNIX only)
ASCII
  Convert unreadable characters to '.' (0x2e)
NOCNV
  No conversion
1251
  Convert from windows-1251 to koi8-r
EUC
  eucJP
JIS
  JIS
SJIS
  shift-JIS

In Japanized UNIX system, all of above are available.  In Windows,
"ASCII", "NOCNV", "SJIS" are available.  If your environment cannot
handle Japanese, specify "ASCII" or "NOCNV" alternatively.

** MODULATION_WHEEL_ALLOW
** PORTAMENTO_ALLOW
** NRPN_VIBRATO_ALLOW
** REVERB_CONTROL_ALLOW
** FREEVERB_CONTROL_ALLOW
** CHORUS_CONTROL_ALLOW
** SURROUND_CHORUS_ALLOW
** GM_CHANNEL_PRESSURE_ALLOW
** VOICE_CHAMBERLIN_LPF_ALLOW
** VOICE_MOOG_LPF_ALLOW
** MODULATION_ENVELOPE_ALLOW
** ALWAYS_TRACE_TEXT_META_EVENT
** OVERLAP_VOICE_ALLOW
** TEMPER_CONTROL_ALLOW

Controllers of MIDI actions.  By default:

#define MODULATION_WHEEL_ALLOW
#define PORTAMENTO_ALLOW
#define NRPN_VIBRATO_ALLOW
/* #define REVERB_CONTROL_ALLOW */
#define FREEVERB_CONTROL_ALLOW
#define CHORUS_CONTROL_ALLOW
/* #define SURROUND_CHORUS_ALLOW */
/* #define GM_CHANNEL_PRESSURE_ALLOW */
#define VOICE_CHAMBERLIN_LPF_ALLOW
/* #define VOICE_MOOG_LPF_ALLOW */
/* #define MODULATION_ENVELOPE_ALLOW */
/* #define ALWAYS_TRACE_TEXT_META_EVENT */
#define OVERLAP_VOICE_ALLOW
#define TEMPER_CONTROL_ALLOW

These values are configurable in command line options.  So you may
leave these in default value.

======================================================================
Make
======================================================================

Make section has nothing particular to write.  Just say "make"

...Oops, almost forgot, TiMidity++'s Makefile needs GNU version of
make.  If you do not have, get one first.  If you have one in a
different name than "make", type its true name instead.

Installation

On UNIX and clones, you can type "make install" to install all files.
Or you can select following targets:

install.bin
  installs executable filles
install.tk
  installs Tcl/Tk interface
install.el
  installs Emacs interface
install.man
  installs man files
install
  installs everything

I strongly recommend you to check the install destinations and files
by setteing -n flag like

% make -n

======================================================================
Search for voice data
======================================================================

TiMidity++ uses Either GUS/patch, or SoundFont(, or both) as the voice
data to play.  You must get a SoundFont or GUS/patch files, and make
the configuration file.  You must make the configuration file (*.cfg).
By default, timidity.cfg is /usr/local/share/timidity/timidity.cfg (or
C:\WINDOWS\TIMIDITY.CFG on Windows).  And please check the following
sites for many voice(patch) data:

* http://www.onicos.com/staff/iz/timidity/link.html#gus
* http://www.onicos.com/staff/iz/timidity/dist/cfg/ (Some sample *.cfg's)
* http://www.i.h.kyoto-u.ac.jp/~shom/timidity/ (10M and 4M patches)
* ftp://ftp.cdrom.com/pub/gus/sound/patches/files/ (GUS site)

If you got funny voice archive, extract it to appropriate directory
and configure *.cfg files with the name and path of these voice datas.