======================================================================
	TiMidity++󥹥ȡ륬

					б
					<iz@onicos.co.jp>
					2004ǯ0301
					С2.13.0ʹ
======================================================================

ʸϤǤϡTiMidity++UNIX饤ʴĶ˥󥹥ȡ뤹뤿ˡ
ˤĤƤޤ

Windows 95/98/Me/NT/2000/XP/2003ǤϡCygwinȤȤǡʸϤ
˽timidity.exeǤޤWindowsĶοͤϡޤCygwin(
mingw)ꤷƤ

Macintoshϥ桼ɤFreeBSDʤΤǡʸϤ̤ˤ
꤯ϤǤŤMacintosh("Classic")ǤΥ󥹥ȡλϡ
ʸϤˤƤޤ

======================================================================
Ūʼ
======================================================================

TiMidity++ϡGNU autotoolsȤäƤޤäơִñʥ
ȡˡ:

1. ɤΤǥ쥯ȥˡcdɤơ./configureɤϤ
   ѥåꤷޤ(κȤϤФ餯֤ޤ)System V
   θŤСȤäƤϡ/bin/sh configureɤȤʤȤ
   ʤ⤷ޤ
2. makeɤȥפȥѥ뤬Ϥޤޤ(GNU makeɬפǤ
   GNU makegmakeɤȤ̾ǥ󥹥ȡ뤵ƤĶǤϡ
   ˡgmakeɤȥפƤ)
3. makeämake installɤȥפơξTiMidity++
   򥤥󥹥ȡ뤷Ƥ

======================================================================
ܺ٤
======================================================================

󥹥ȡδʼ

1. configre¹Ԥ
2. ɬפcommon.makefileMakefiletimidity.hԽ
3. ѥ
4. 󥹥ȡ
5. ե

ǤʲޤʲǤϡ%ɤץץȤȤƻȤä
ޤΤդƤ

======================================================================
configure
======================================================================

ޤʲΥޥɤ¹ԤƤߤƤ

% /bin/sh configure --help

configureΥץ󤬤ɽ줿ȻפޤΤ--help
--prefix=PREFIXΤ褦¿ΥץϡŵŪ¾ΥץȤˤ
ΤƱ̣/ˡǤTiMidity++ȼΥץ⤢ޤ

--enable-debug
  ǥХåե饰ͭˤʤޤ

--without-x
  TiMidity++ϡɸ֤XѤ褦ˤʤäƤޤΤǡXΥ饤
  ȥ󥯤ʤϡŪ--without-xꤷʤȤ
  

--enable-audio[=audio_list]
  ǥϤηꤷޤ--enable-audio=noξϡTiMidity++
  ϤMIDI-to-WAVEѴȤʤޤ

  Υץ˻Ǥͤϡ

  * default: ưȽ
  * oss: OSS /dev/dsp
  * sun: SunOS /dev/audio
  * hpux: hp-ux /dev/audio
  * irix: IRIX audio library
  * mme: OSF/1 MME
  * sb_dsp: BSD/OS 2.0 /dev/sb_dsp
  * w32: Windows MMS
  * darwin: darwin(Mac OS X)CoreAudio frameowrk
  * alsa: ALSA pcm device
  * alib: hp-ux network audio (Alib)
  * nas: NAS
  * portaudio: PortAudio
  * jack: JACK
  * arts: aRts
  * esd: EsounD
  * vorbis: ogg vorbis
  * gogo: mp3Τ(Windows only)

  Ǥ

--enable-interface[=interface_list]
--enable-dynamic[=interface_list]
  Ѥ륤󥿥եꤷޤ--enable-dynamicȤȡ
  եưŪ󥯥⥸塼Ȥƥѥ뤵ޤ(Х
  ʥΥʤޤ)

  Υץ˻Ǥͤϡ

  * ncurses: ncurses󥿥ե
  * slang: S-Lang󥿥ե
  * motif: Motif󥿥ե(LestiffǤưޤ)
  * tcltk: Tcl/Tk󥿥ե
  * emacs: Emacsեȥ(M-x timidity)
  * vt100: vt100󥿥ե
  * xaw: X Athena Widget󥿥ե
  * xskin: X skin󥿥ե
  * gtk: GTK+󥿥ե
  * w32gui: Windows GUIǤȤƥѥ
  * winsyn: TiMidity++ Windows󥻥ФȤƥѥ
  * alsaseq: ALSA󥵥󥿥ե

  Ǥǡ

  --enable-interface=INTERFACE1,INTERFACE2,...
  Ȥ꤬
  --enable-INTERFACE1=yes --enable-INTERFACE2=yes ...
  ȤƱ̣ǡƱͤ
  --enable-dynamic=INTERFACE1,INTERFACE2,...
  Ȥ꤬
  --enable-INTERFACE1=dynamic --enable-INTERFACE2=dynamic ...
  ȤƱ̣ȤȤդƤ

--enable-network
  ͥåȥݡȤͭˤޤTiMidity++URLϤȡͥåȥ
  ۤMIDIեդ뤳Ȥǽˤʤޤ

--enable-spectrogram
  PCMΥڥȥ򡤥ꥢ륿ɽǤ褦ˤ
  ץǤ

--enable-wrd
  WRDбͭˤޤ

* configureȴĶѿ

MIDIեˤäƤϡ󥰤ˤȤäƤCPUѥɬפʾ礬
ޤŬڤʺŬˡǤСΤ褦MIDIե⥹ࡼ
˱դǤ褦ˤʤ뤫⤷ޤ

configureϡʲδĶѿ(ꤵƤ)ǧޤ

CC
  Cѥ顣/usr/bin/gcc
CFLAGS
  ${CC}Ϥե饰-O2 -pipe
LDFLAGS
  󥫤Ϥե饰-L/usr/gnu/lib
CPPFLAGS
  ץץåϤե饰-traditional-cpp

ѥˤϡκŬե饰ȻפޤȤ
ultrasparc/gccξ:

% env CFLAGS='-O3 -Wall -mv8 -funroll-all-loops -fomit-frame-pointer \
	-mcpu=ultrasparc' /bin/sh configure [configure-options]...

ʤɤȻꤹ뤳Ȥ(¿ʬ)®ʥХʥ꤬Ȼפޤ

======================================================================
եԽ
======================================================================

Τޤޤξ֤Ǥϥѥ뤬̤ʤȤޤʤȤˤϡ
ưcommon.makefileMakefile뤤timidity.hԽȤޤ
礬ޤ

* timidity.h˵ܤƤѥ᡼

TiMidity++ˤϡХʥ˥ϡɥɤƤ륪ץ󤬤Ĥ
ޤΥѥ᡼ϡtimidity.h#defineǵҤƤޤ

ʲεҤǡ֥ޥɥ饤󤫤ѹǤޤפȽ񤤤ƤΤ⤢
ޤΥץϥޥɥ饤ǻꤵʤäΥǥ
ͤꤷƤޤˤ虜虜ѹɬ
ȻפޤΤǡäƤƤ⤤󤸤ʤǤ礦 -- mput

** CONFIG_FILE

ɬפ˱CONFIG_FILEƤǥեȤǤ

#define CONFIG_FILE DEFAULT_PATH "/timidity.cfg"

ȤʤäƤޤDEFAULT_PATHϡMakefileTIMID_DIRƱǤ
⤷ɤƤ¾ξ֤ʤ

#define CONFIG_FILE "/etc/timidity.cfg"

Τ褦ޤ

** DECOMPRESSOR_LIST

եŸޥɤǤWindowsǤ̵뤷Ƥ
ǥեȤǤ

#define DECOMPRESSOR_LIST { \
		".gz", "gunzip -c %s", \
		".bz2", "bunzip2 -c %s", \
		".Z", "zcat %s", \
		".zip", "unzip -p %s", \
		".lha", "lha -pq %s", \
		".lzh", "lha -pq %s", \
		".shn", "shorten -x %s -", \
		0 }

ȤʤäƤޤꥸʥTiMidityǤϡ嵭ǻꤷĥҤб
ޥɤѤơեŸɤ߹ळȤǤޤ
TiMidity++ǤϴĤηˤĤƤϡTiMidityŸƥե
ɤ߹ߤޤ٤ƤηϥݡȤƤʤΤǡݡ
Ƥʤˤϡ嵭ǻꤷޥɤѤޤ

** PATCH_CONVERTERS

ѥåեѴޥɤ˴ؤǤWindowsǤ̵
ƤǥեȤǤ

#define PATCH_CONVERTERS { \
		".wav", "wav2pat %s", \
		0 }

ȤʤäƤޤ

** PATCH_EXT_LIST

GUS/patchեγĥҤλǤ˻ꤷĥҤ*.cfgΥ
̾ǾάǤޤǥեȤǤ

#define PATCH_EXT_LIST { \
		".pat", \
		".shn", ".pat.shn", \
		".gz", ".pat.gz", \
		".bz2", ".pat.bz2", \
		0 }

ȤʤäƤޤ

** DEFAULT_PROGRAM

ǥեȤinstrumentǤ

#define DEFAULT_PROGRAM 0

ȤʤäƤޤMIDIProgram Change٥Ȥʤˡͤ
ޤ̾0֤ϥԥΤǤ

Υץϥޥɥ饤󤫤ǤΤǡΤޤޤǤ褤Ǥ


** DEFAULT_DRUMCHANNELS

ɥͥǤǥեȤǤ

#define DEFAULT_DRUMCHANNELS {10, -1}

ȤʤäƤޤϡޥɥ饤󥪥ץѹǤΤǡ
ޤޤɤȻפޤѹϡɥͥΥꥹȤʣ
ꤷ-1ǽλޤ⤷1016ͥǥեȤǥɥ
ͥˤʤС

#define DEFAULT_DRUMCHANNELS {10, 16, -1}

Ȥޤ

** FLOAT_T

ưηλǤ

  typedef double FLOAT_T;
  typedef float FLOAT_T;

Τɤ餫Ǥdouble٤FPUܤƤޥǤϡ
floatdouble®ǤsparcSGI/IPʤɤϡdouble®
ǶFPUϡƤξdouble٤®Ǥ
ΥޥѥǤϡfloat®ˤʤ뤫Τޤ

** (MAX|MIN)_OUTPUT_RATE

ץ졼Ȥβ¡¤ǤǥեȤǤ

#define MIN_OUTPUT_RATE 4000
#define MAX_OUTPUT_RATE 65000

ȤʤäƤޤäѹɬפϤʤǤ礦

** DEFAULT_AMPLIFICATION

ޥܥ塼ΥǥեͤǤǥեȤǤ

#define DEFAULT_AMPLIFICATION 70

ȤʤäƤޤͤϥѡͤǻꤷޤǥեȤ70%Ϥ
ɤͤʤΤǡäѹʤƤɤǤ礦ޥɥ饤
ץѹ뤳ȤǤޤ

** DEFAULT_RATE

ǥեȤκץ졼ȤǤǥեȤǤ

#define DEFAULT_RATE 44100

ȤʤäƤޤͤϡѥ饪ץ-DDEFAULT_RATE=<rate>Τ
˻ꤷƤɤǤѥΤޥǡDATʼ¤ߤGUS/patch
ȤäƲŬʲʹ

#define DEFAULT_RATE 48000

ȤΤɤǤ

** DEFAULT_VOICES

Ʊȯ˴ؤǤǥեȤǤ

#define DEFAULT_VOICES 256

ȤʤäƤޤDEFAULT_VOICESϵưƱȯǡͤ-pץ
Ѥ1꤬ޤǤοꤹ뤳ȤǤޤ-in
󥿥եǤϡ¹ԻѲ뤳ȤǤޤѥΤޥ
ʤ顤ǥեȤƱȯ䤷

#define DEFAULT_VOICES 512

Τ褦ˤΤɤǤʤ顤и128ŲСMIDI
ե뤬Ŭʹޤޤ256ŲۤMIDIեϤۤȤ¸
ߤʤ(˴ˤޤ)256ŲʾˤϤʤǽCPU
(㤨R10000Ȥ)ǤäƤ٤⤤ǤΤᡤDEFAULT_VOICES
ü䤷Ƥ⤢ޤ̣ʤΤǡ256餤¤ˤΤǤ

** AUDIO_BUFFER_BITS

Хåե礭ǤǥեȤǤ

#define AUDIO_BUFFER_BITS 12

ȤʤäƤޤäѹ뤳ȤϤʤǤ礦

** CONTROLS_PER_SECOND

TiMidityǤϡ٥פβ̷׻1ץ뤴Ȥ˷׻ΤǤϤʤ
٤ޤȤƷ׻ޤͤ礭Фۤɺ٤׻
ᡤμϤ褯ʤޤդCPU٤⤯ʤޤǥեȤǤ

#define CONTROLS_PER_SECOND 1000

ȤʤäƤޤޥɥ饤󥪥ץѹǤΤǡΤޤޤ
Ȥޤ礦

** DEFAULT_RESAMPLATION

ꥵץˤ䴰ǤǥեȤǤϡ

#define DEFAULT_RESAMPLATION resample_gauss

ȤʤäƤޤȡꥵץ˥䴰Ԥ
夷ޤȿ̡CPU٤夬ޤϤʥޥǤʤ¤
Ƥޤ礦䴰르ꥺȤơΤΤѲǽǤ(
ηڤ)

#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

䴰르ꥺϡޥɥ饤󥪥ץѹǤޤ桼
äѹǤʤˤ

#define FIXED_RESAMPLATION

ΥȥȤ򳰤Ƥ

** USE_DSP_EFFECT

DSPեȤ˴ؤǤǥեȤǤ

#define USE_DSP_EFFECT

ȤʤäƤޤ饹ǥ쥤EQӥ󥵡󥨥եȤ
ǽ夵ΤǡäѹɬפϤʤǤ礦

** LOOKUP_HACK

ǥեȤǤ

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

̤ˤʤäƤޤΥޥȡ¿®ưޤ
16ӥåȤΥץ8ӥåȤǷ׻ΤDzޤ
ʥޥDZսɤդʤʤƤߤޤ礦

** SMOOTH_MIXING

ߥ󥰤ʳǡ޷ʲѲȡݥåԥ󥰡Υȯ
뤳ȤޤꤷƤȥݥåԥ󥰡Υηڸ˸
ޤǥեȤ

#define SMOOTH_MIXING

ͭǤȥȤȼ㴳®ˤʤޤ

** FAST_DECAY

٥פѲ®٤ꤷޤǥեȤǤ

/* #define FAST_DECAY */

̤ˤʤäƤޤȥ٥ץơ2®
褦ˤʤޤ̤Ȥơ®ˤĤʤΤǤȿ̡
ĹûʤꡤϤ˷礱Ƥޤϥޥɥ饤󤫤on/
offǤΤǡ̤ΤޤޤɤǤ礦

** FRACTION_BITS

TiMidityǤϡβѴưѤˡ32ӥåȸ꾮
ѤƷ׻ƤޤǥեȤǤ

#define FRACTION_BITS 12

ȤʤäƤꡤϤΤޤޤɤǤ礦

** ADJUST_SAMPLE_VOLUMES

ưGUS/patchĴǤǥեȤǤ

#define ADJUST_SAMPLE_VOLUMES

ƤޤƤȡGUS/patchβ̤ưŪĴ
Ʊ礭ˤޤ⤷GUS/patchϾޤޤˡ
GUS/patch礭ޤޤˤʤ̤ˤƤΤ˥
塼˥󥰤ƤGUS/patchåȤΤߤѤʤ̤ǤɤǤ
¾͡GUS/patchѤˡ̤·ˤʤäƤޤ
ΤǡΥޥƤɤǤ礦

** DENGEROUS_RENICE

UNIXϥƥevil⡼ɤͭˤǤǥեȤǤ

/* #define DANGEROUS_RENICE -15 */

̤ˤʤäƤޤsetuid rootTiMidityǡץΥץ饤
夲Ƽ¹ԤϡΥޥƤUNIXΤߤͭ
ǤΥޥTiMidity򥤥󥹥ȡ뤷ϡ

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

Τ褦ˤޤ

աDANGEROUS_RENICEƤʤϡsetuidץˤʤ
      Ǥ

** MAX_DIE_TIME

ΥѡȤβABȰܤȤAβֻ˾äƤޤȥ
ΥФƤޤޤΥѥ᡼ǡֻ˾ä٤˥å
ΥФʤ褦˥ȥ뤷ޤǥեȤǤ

#define MAX_DIE_TIME 20

ȤʤäƤޤޤ꾮ʿˤȡåΤˤʤޤ
ͤϤΤޤޤɤǤ礦

** LOOKUP_SINE

ؿơ֥뻲Ȥ˴ؤǤǥեȤǤ

#define LOOKUP_SINE

ȤʤäƤޤĤδĶ(ä˿ͱ黻ץåʤPCʤ)
ϡؿͤơ֥뻲Ȥٷ׻꤫ʤ®
ʤޤ

PCϡCPUα黻®٤ɤɤ®ʤǡᥤΥ
֤Ϥƹ®Ƥޤ(̤)ơ֥
԰٤ᥤؤΥΤǡǤʤΥ
åߥҥåȡҤƤϥѥץ饤󥹥ȡ뤬ȯޤߤʳ
Ǥȡơ֥뻲Ȥ򤹤ΤȤʤΤǤϡۤȤ®Ūʺ
ޤ(ʤȤδĶǤ -- mput)ǯˤϡ׻
®ˤʤͽۤޤ

** PRECALC_LOOPS

ꥵץ󥰺Ŭ˴ؤǤǥեȤǤ

#define PRECALC_LOOPS

ȤʤäƤޤκŬϴĶˤäƸʤäꤷ
ΤǡˤäƤ̤ˤ®⤷ޤ

** USE_LDEXP

ldexp()ȤɤǤǥեȤǤ

/* #define USE_LDEXP */

̤ˤʤäƤޤưγݤldexp()Ѥ®
ޥξƤɤäˤ纹ʤȤϻפޤ

** DEFAULT_CACHE_DATA_SIZE

å礭ǤǥեȤǤ

#define DEFAULT_CACHE_DATA_SIZE (2*1024*1024)

2MˤʤäƤޤTiMidity++ǤϡMIDI٥Ȥ˥󤷤ơ
β򤢤餫ꥵץ󥰤ޤΥꥵץ󥰤ΥХåե
礭ꤷƤ礭ۤɹ®ˤʤޤʬ
ϲ񤷤ޤ2Mʾ䤷Ƥ⡤ޤ긲˹®ʤޤ
ɥ饤󥪥ץ󤫤ѹǤΤǡϥǥեȤΤޤޤɤ
Ǥ礦

* ͥåȥϢ귲

TiMidity++ǤϡURLѤƥͥåȥ𤷤ƥե˥뤳
ȤǽˤʤäƤޤ(configure  --enable-network ꤷ)
ʲΥޥꤷƤ

** MAIL_DOMAIN

᡼륢ɥ쥹Υɥᥤ̾ꤷƤ㤨С᡼륢ɥ쥹
iz@onicos.co.jpȤȡ

#define MAIL_DOMAIN "@onicos.co.jp"

ȵҤޤ

** MAIL_NAME

UNIXǤ̤ˤƤWindowsǤϥ᡼̾Ƥ
С᡼륢ɥ쥹iz@onicos.co.jpȤȡ

#define MAIL_NAME "iz"

ȵҤޤ

** TMPDIR

ե־ꤷޤǥեȤǤ

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

̤ˤʤäƤޤUNIXǤϡΥޥ̤ˤƤTMPDIR
ĶѿƤǥ쥯ȥ˰եޤTMPDIR
ޥTMPDIRĶѿɤȤ̤ξϡ/tmp˰ե뤬
ޤWindowsǤϡTMPDIRĶѿ̵뤵ޤΤǡTMPDIRޥ
Ƥ

** GS_DRUMPART

GSΥɥѡȤǧ˴ؤǤ

#define GS_DRUMPART

СGSΥ롼å֥åɥѡȤǧ
ޤ

/* #define GS_DRUMPART */

̤ˤФεǽ̵ˤʤޤ

* ܸϢ

ܸΤΥץ󤬤Ĥޤ

** JAPANESE

ܸĶǤ

#define JAPANESE

ƤܸĶǤʤϡ

/* #define JAPANESE */

ȥȥȤƤ

** OUTPUT_TEXT_CODE

ϥɤꤷޤʲʸͭǤ

AUTO
  LANGĶѿ鼫ưŪ˷
ASCII
  ʸԥꥪɤѴ
NOCNV
  ̵Ѵ⡼
1251
  windows-1251koi8-rѴ
EUC
  eucJPǽ
JIS
  JISǽ
SJIS
  shift-JISǽ

UNIXܸĶǤϡ嵭٤ͭǤWindowsܸĶǤϡ
"ASCII""NOCNV""SJIS" Τɤ줫ꤷƤܸĶǤʤ
ϡ"ASCII""NOCNV"Τɤ餫ꤷƤ

ϥޥɥ饤󤫤ǽǤ

** 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

MIDI˴ؤǤǥեȤ

#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

ȤʤäƤޤϡޥɥ饤󥪥ץѹ뤳ȤǤ
ޤΤǡΤޤޤɤȻפޤ

======================================================================
make
======================================================================

ѥñˡmakeɤȥפǤGNU makemakeɰʳ
̾ƳƤĶǤϡȤäƤ

======================================================================
󥹥ȡ
======================================================================

make installɤǥ󥹥ȡ뤵ޤޤʲΥåȤ
ޤ

install.bin
  ¹ԥե󥹥ȡ
install.tk
  Tcl/Tk󥿥ե󥹥ȡ
install.el
  Emacs󥿥ե󥹥ȡ
install.man
  manڡ󥹥ȡ
install
  󥹥ȡ

󥹥ȡκݤˤ-nץϤơ뤫ǧƤ
Ȼפޤ

% make -n install

======================================================================
ǡõ
======================================================================

TiMidity++ϡñΤǤϲĤ餹ȤǤޤɬǡɬ
ˤʤޤǡȤƤϡGUS/patchSoundFont(ξ)Ȥޤ
ʤΤǡޤΥեꤷơե˻ꤹɬפ
ޤTiMidity++եϡǥեȤǤ
/usr/local/share/timidity/timidity.cfg
(WindowsǤC:\WINDOWS\TIMIDITY.CFG)ˤޤ

եϡ󥿡ͥåȾˤ¸ߤƤޤϰʲ
URL餿ɤ뤳ȤǤǤ礦

* 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)