.TH timidity.cfg 5 "2004年04月25日" "2.13.0"
.SH 名前
timidity.cfg \- TiMidity++ の設定ファイル
.SH 説明
\fBtimidity.cfg\fP は，timidity(1) の実行時の様々な設定を行うための設定
ファイルです。音色データの置き場所，音色自体の設定，その他諸々を設定す
ることができます。
.br
\fBTiMidity++\fP は，起動時にコマンドラインオプションを見る前に，
\fBtimidity.cfg\fP を探索します。このファイルにアクセスできない場合，ま
たライブラリパスがコマンドラインで \fB\-L\fP オプションによって変更され
ている場合は，すべてのオプションを見た後に，新しいライブラリパスに従っ
てデフォルトファイルを(\fB\-c\fP オプションで別の設定ファイルが指定され
ていないならば)再探索します。
.br
設定ファイルは，MIDI プログラムのインスツルメントファイルへのマッピング
を定義します。もし，複数のファイルが指定された場合には，後に読み込まれ
た設定によって前の設定が上書きされます。
.SH 変数
ドル記号 `$' に続けて英数字やアンダースコア `_' が続いている場合，その
文字列は変数と見なされ，設定ファイルを処理する際に別の文字列に置き換え
られます。この変数名は，後続の文字と区別するために，中括弧付きで表記す
ることもできます。
.sp
例:
.br
$variable
.br
${variable} # $variable と同義
.sp
変数を新たに定義する命令は，今のところ用意されていません。未定義の変数
は，空文字に置き換えられます。
.br
規定の変数として定義されている変数は，次の 1 つだけです。
.TP
.B $basedir
設定ファイルが存在するディレクトリを表します。主にパスを指定する命令で，
設定ファイルからの相対パスを指定する目的で使います。
.br
$basedir に空白が含まれるかも知れない場合は，"" で括る必要があります。
.sp
例:
.br
/usr/local/share/timidity/timidity.cfg 内で
.br
dir $basedir/inst # source /usr/local/share/timidity/inst と解釈される
.SH 文法
設定ファイル中には以下の書式が指定可能です。
.TP
.BI "dir " "directory [...]"
\fIdirectory\fP を探索パスに加えます。加え方は \fB\-L\fP オプションと同
様です。
.br
\fBTiMidity++\fP では，アーカイブファイルをパッチセットにすることができ
ます。
.sp
例:
.br
dir /usr/local/share/timidity/inst/foo.zip#
.br
bank 0
.br
0 bar.pat
.br
1 baz.pat
.br
2 zoo.pat
.sp
まず，\fBdir\fP で通常のディレクトリのようにアーカイブファイル(上の例で
は/usr/local/share/timidity/inst/foo.zip)を指定します。このとき，アーカ
イブファイル名の最後に `#' を付けてください。この `#' があることで，ア
ーカイブファイルであることを \fBTiMidity++\fP は認識します。こうしてお
くと，\fBdir\fP で指定されたアーカイブファイルの中のパッチファイルも読
み込み対象になります。上の例では，foo.zip の中にある bar.pat，baz.pat，
zoo.pat が読み込まれます。
.TP
.BI "source " "file [...]"
他の設定ファイルをその場所に挿入し，続行します。\fBsource\fP のネストは
50 段まで可能です。
.TP
.BI "progbase " number
これ以降，プログラム番号を \fInumber\fP から \fInumber\fP+128 で設定・
表示します。例えば，\fBprogbase 1\fP とした場合は，それ以降プログラム番
号は \fB1\fP から \fB128\fP で設定・表示されます。
.TP
.BI "bank " "[MapID1] number"
これ以降変更するトーンバンクを選択します。この文以後の patch の対応付け
は，指定されたトーンバンクに対して行われます。\fIMapID1\fP に
\fBgm2\fP，\fBsc55\fP，\fBsc88\fP，\fBsc88pro\fP，\fBsc8850\fP，
\fBxg\fP，\fBxgsfx64\fP のいずれかを指定することで，特定のマップを対象
にできます。
.TP
.BI "drumset " "[MapID2] number"
変更するドラムセットを選択します。この文以後の patch の対応付けは，指定
されたドラムセットに対して行われます。\fIMapID2\fP に \fBgm2drum\fP，
\fBsc55drum\fP，\fBsc88drum\fP，\fBsc88prodrum\fP，\fBsc8850drum\fP，
\fBxgdrum\fP，\fBxgsfx126\fP のいずれかを指定することで，特定のマップを
対象にできます。
.TP
.BI "number " "file [options]"
.br
.ns
.TP
.BI "number %font " "file bank prog [key] [options]"
.br
.ns
.TP
.BI "number %sample " "file [options]"
現在のトーンバンクやドラムセットで，MIDI プログラムナンバー
\fBnumber\fP で使用する patch ファイルを指定します。\fIfile\fP が
SoundFont の場合は，\fBnumber %font\fP の書式で特定の \fIbank\fP，
\fIprog\fP，\fIkey\fP の音色データを取り出します。\fIfile\fP が無圧縮の
WAV 形式または AIFF 形式のサンプルファイルの場合は，\fBnumber
%sample\fP の書式で指定します。\fIoptions\fP は，次のものが使用可能です。
.RS
.TP
.BI amp= amplification
インスツルメントのボリュームを \fIamplification\fP% にします。もし値が
指定されていない場合，インスツルメントが読み込まれる時に自動的に設定さ
れます。
.TP
.BI note= note
インスツルメントを演奏する時に決まった MIDI ノート(音階)を使用します。
\fInote\fP を \fB0\fP にすると，最初に Note On イベントが発生した時点で
のノートを使用します。パーカッションインスツルメントに対しては，もし設
定ファイルで値が設定されていなければ，patch ファイルに入っている値を使
用します。
.TP
.BI pan= panning
インスツルメントのデフォルトのパンニングを設定します。\fIpanning\fP は
\fBleft\fP，\fBright\fP，\fBcenter\fP，あるいは \fB\-100\fP から
\fB100\fP までの整数値を取ることができます。\fB\-100\fP が最も左，
\fB100\fP が最も右になります。値が与えられていない場合には，patch ファ
イルに入っている値を使用します。もちろん，MIDI ファイル中のパンニングコ
ントロールの方が優先されます。
.TP
.BI tune= tuning[,...]
インスツルメントのルート周波数を調整します。\fBtune=1\fP とすれば
\fB1\fP 半音上がります。\fItuning\fP には小数が利用可能なので，
\fBtune=\-0.2\fP などの微調整も可能です。二つ目以降の引数は，音域別に複
数のサンプルデータが含まれている場合に，それぞれ別の値を指定できます。
.TP
.BI rate= attack:decay:sustain:release1:release2:release3[,...]
インスツルメントの ADSR レートを設定するオプションです。\fB0\fP から
\fB255\fP までの値が指定できます。サステインレートだけを補正したい場合
など，
.sp
6 GUS/hrpschrd.pat rate=::60
.sp
のような狙い撃ち設定も可能です。また，アタックタイムを速くしたいだけで
あれば，
.sp
6 GUS/hrpschrd.pat rate=255
.sp
という書き方ができます。二つ目以降の引数は，音域別に複数のサンプルデー
タが含まれている場合に，それぞれ別の値を指定できます。
.TP
.BI offset= attack:decay:sustain:release1:release2:release3[,...]
インスツルメントの ADSR オフセットを設定するオプションです。\fB0\fP か
ら \fB255\fP までの値が指定できます。 書式については，ほぼ \fBrate=\fP
と同様です。
.TP
.B keep={loop|env}
パーカッションインスツルメントでは，デフォルトでループ情報とエンベロー
プ情報が破棄されます。また，メロディーインスツルメントに異常なエンベロ
ープが存在した場合にも，エンベロープ情報は自動的に破棄されます。
\fBkeep=\fP を指定することで，ループ情報やエンベロープ情報が破棄される
のを防ぎます。例えば，Short，Long Whistle パーカッションインスツルメン
ト(General MIDI の 71，72 番)に対しては，設定ファイルで
\fBkeep=loop keep=env\fP としておく必要があります。
.TP
.B strip={loop|env|tail}
インスツルメントとして使用する patch のループ情報やエンベロープ情報やテ
ール(ループの後にあるデータ)をすべて強制的に破棄します。サードパーティ
ーのインスツルメントには，ループの後にゴミが付いているものがあり，イン
スツルメントを演奏する度にクリッキングノイズが入ってしまうことがありま
す。その場合，\fBstrip=tail\fP オプションを指定すれば音質が改善されます。
.TP
.BI tremolo= sweep_increment:control_ratio:depth[,...]
トレモロを設定するオプションです。\fB0\fP から \fB255\fP までの値が指定
できます。\fBrate=\fP 同様，狙い撃ち設定や不要部分の省略が可能です。
\fIsweep_increment\fP は発音してからトレモロが掛かり始めるまでの時間，
\fIcontrol_ratio\fP は振幅が変化する速さ，\fIdepth\fP は振幅が変化する
深さです。\fBrate=\fP 同様，複数のサンプルに対する設定が可能です。
.TP
.BI vibrato= sweep_increment:phase_increment:depth[,...]
ビブラートを設定するオプションです。\fB0\fP から \fB255\fP までの値が指
定できます。\fBrate=\fP 同様，狙い撃ち設定や不要部分の省略が可能です。
\fIsweep_increment\fP は発音してからビブラートが掛かり始めるまでの時間，
\fIphase_increment\fP は周波数が変化する速さ，\fIdepth\fP は周波数が変
化する深さです。\fBrate=\fP 同様，複数のサンプルに対する設定が可能です。
.TP
.BI sclnote= note[,...]
インスツルメントのスケールチューニングの基準とするノートを設定します。
例えば，\fBsclnote=60\fP とすれば，真ん中のドを中心にスケールチューニン
グが行われます。二つ目以降の引数は，音域別に複数のサンプルデータが含ま
れている場合に，それぞれ別の値を指定できます。
.TP
.BI scltune= tune[,...]
インスツルメントのスケールチューニングの度合いを cent 単位で設定します。
例えば，\fBscltune=50\fP とすれば，ノート間隔が \fB50\fP cent になりま
す。二つ目以降の引数は，音域別に複数のサンプルデータが含まれている場合
に，それぞれ別の値を指定できます。
.TP
.BI comm= comment
\fIcomment\fP が指定できます。\fB#extension comm\fP と同じ効果です。
.TP
.BI modrate= attack:decay:sustain:release1:release2:release3[,...]
.br
.ns
.TP
.BI modoffset= attack:decay:sustain:release1:release2:release3[,...]
モジュレーション・エンベロープの変化の仕方を設定します。設定方法や値は，
基本的にボリューム・エンベロープと同じです。一部の SoundFont を除けば，
このオプションだけを指定しても何も起こりません。
.TP
.BI envkeyf= attack:decay:sustain:release1:release2:release3[,...]
ボリューム・エンベロープ・キーフォローを設定します。\fBnote=60\fP を基
準として，ノートに従いエンベロープ・タイムを変化させます。単位は
+\-cent/key です。例えば \fBenvkeyf=100\fP と指定すると，1 オクターブ上
がるたびにアタック・タイムが 2 倍になります。\fBrate=\fP 同様，複数のサ
ンプルに対する設定が可能です。一部の SoundFont では，\fIdecay\fPと
\fIsustain\fP のパラメータが予め設定されている場合があります。
.TP
.BI envvelf= attack:decay:sustain:release1:release2:release3[,...]
ボリューム・エンベロープ・ベロシティフォローを設定します。
\fBvelocity=64\fP を基準として，ベロシティに従いエンベロープ・タイムを
変化させます。単位は +\-cent/velocity です。例えば \fBenvvelf=100\fP と
指定すると，\fBvelocity=127\fP でアタック・タイムが約 38 倍になります。
\fBrate=\fP 同様，複数のサンプルに対する設定が可能です。このオプション
は，近い将来仕様変更される可能性があります。
.TP
.BI modkeyf= attack:decay:sustain:release1:release2:release3[,...]
モジュレーション・エンベロープ・キーフォローを設定します。\fBnote=60\fP
を基準として，ノートに従いエンベロープ・タイムを変化させます。単位は
+\-cent/key です。例えば \fBmodkeyf=100\fP と指定すると，1 オクターブ上
がるたびにアタック・タイムが 2 倍になります。\fBrate=\fP 同様，複数のサ
ンプルに対する設定が可能です。一部の SoundFont では，\fIdecay\fPと
\fIsustain\fP のパラメータが予め設定されている場合があります。
.TP
.BI modvelf= attack:decay:sustain:release1:release2:release3[,...]
モジュレーション・エンベロープ・ベロシティフォローを設定します。
\fBvelocity=64\fP を基準として，ベロシティに従いエンベロープ・タイムを
変化させます。単位は +\-cent/velocity です。例えば \fBmodvelf=100\fP と
指定すると，\fBvelocity=127\fP でアタック・タイムが約 38 倍になります。
\fBrate=\fP 同様，複数のサンプルに対する設定が可能です。このオプション
は，近い将来仕様変更される可能性があります。
.TP
.BI trempitch= num[,...]
トレモロに従って，ピッチを変化させる深度を設定します。効果そのものはビ
ブラートと一緒ですが，別系統で動作させたいときに利用します。単位は
+\-cent です。\fBrate=\fP と同様，複数のサンプルに対する設定が可能です。
.TP
.BI tremfc= num[,...]
トレモロに従って，フィルタ・カットオフ周波数を変化させる深度を設定しま
す。いわゆる「グロウル効果」を表現できます。単位その他は
\fBtrempitch=\fP と同一です。
.TP
.BI modpitch= num[,...]
モジュレーション・エンベロープに従って，ピッチを変化させる深度を設定し
ます。アタック時だけ一時的に音程が上がるなどの表現が可能です。単位その
他は \fBtrempitch=\fP と同一です。
.TP
.BI modfc= num[,...]
モジュレーション・エンベロープに従って，フィルタ・カットオフ周波数を変
化させる深度を設定します。単位その他は \fBtrempitch=\fP と同一です。
.TP
.BI fc= num[,...]
フィルタ・カットオフ周波数の基準値を設定します。単位は Hz です。
\fBrate=\fP と同様，複数のサンプルに対する設定が可能です。
.TP
.BI q= num[,...]
フィルターの Q(レゾナンス)を設定します。単位は cB です。\fBrate=\fP と
同様，複数のサンプルに対する設定が可能です。
.TP
.BI fckeyf= num
フィルタ・キーフォローを設定します。\fBnote=60\fP を基準として，ノート
に従いカットオフ周波数を変化させます。単位は +\-cent/key で，例えば
\fB100\fP を指定すれば，音程と同じだけ変化します。
.TP
.BI fcvelf= num
フィルタ・ベロシティフォローを設定します。\fBvelocity=127\fP を基準とし
て，ベロシティに従いカットオフ周波数を変化させます。単位は +\-cent で，
SoundFont では \fB\-2400\fP が固有値として設定されています。
.TP
.BI qvelf= num
レゾナンス・ベロシティフォローを設定します。\fBvelocity=0\fP を基準とし
て，ベロシティに従いレゾナンスを変化させます。単位は +\-cB です。
.RE
.TP
.BI "default " file
他のどこにも設定がないような音に出合った場合，このファイルが代理として
発音されます。
.TP
.BI "map " "MapID1 from\-bank from\-prog to\-bank to\-prog"
GS/XG 各マップのトーン音色として既存のトーン音色を割り当てます。
\fIMapID1\fP には，\fBgm2\fP, \fBsc55\fP，\fBsc88\fP，\fBsc88pro\fP，
\fBsc8850\fP，\fBxg\fP，\fBxgsfx64\fP が指定できます。
.TP
.BI "map " "MapID2 from\-drumset from\-keynote to\-drumset to\-keynote"
GS/XG 各マップのドラム音色として既存のドラム音色を割り当てます。
\fIMapID2\fP には，\fBgm2drum\fP, \fBsc55drum\fP，\fBsc88drum\fP，
\fBsc88prodrum\fP，\fBsc8850drum\fP，\fBxgdrum\fP，\fBxgsfx126\fP が指
定できます。
.TP
.BI "soundfont " "file [options]"
SoundFont を最初から最後まで読み込みます(部分的に読み込むには，
\fBnumber %font\fP を使います)。\fIoptions\fP は，次のものが使用可能で
す。
.RS
.TP
.BI order= number
音色データを探す順番を設定します。\fBorder=0\fP のときは，まず
SoundFont を読み込んで，その後に足りないサンプルを GUS/patch から探しま
す。\fBorder=1\fP のときは，GUS/patch を読み込んだ後に SoundFont を読み
込みます。
.TP
.BI amp= amplification
SoundFont 全体の音量を \fIamplification\fP% にします。もし値が指定され
ていない場合，\fB100\fP% に設定されます。
.TP
.BI cutoff= number
SoundFont に設定された LPF の有効(\fB1\fP)/無効(\fB0\fP)を指定します。
もし値が指定されていない場合，有効となります。
.TP
.BI reso= number
SoundFont に設定されたレゾナンスの有効(\fB1\fP)/無効(\fB0\fP)を指定しま
す。もし値が指定されていない場合，有効となります。
.TP
.B remove
対象の SoundFont を逆にメモリ上から廃棄します。
.RE
.TP
.BI "font exclude " "bank [prog [key]]"
SoundFont の検索を，\fIbank\fP 上の \fIprog\fP で行わないように指定しま
す。ドラムの場合はバンクが \fB128\fP でドラムセットが \fIprog\fP，キー
番号が \fIkey\fP になります。
.TP
.BI "font order " "number bank [prog [key]]"
SoundFont の検索順序(上記参照)を，個別に指定するためのものです。引数の
意味は \fBfont exclude\fP と同じです。
.LP
\fBTiMidity++\fP では，以下の拡張命令が追加されています。
.TP
.BI "#extension altassign " "program1 program2 ..."
ドラムセットについて，オルタネートアサインを設定します。
.sp
drumset 0
.br
altassign 42 44 46
.sp
と書くと，\fBdrumset 0\fP の \fB42\fP，\fB44\fP，\fB46\fP が排他的に鳴
ります。\fBdrumset 0\fP で定義されたオルタネートアサインはデフォルトで
使用されます。
.TP
.BI "#extension comm " "program comment"
インスツルメント番号 \fIprogram\fP にコメント \fIcomment\fP を指定しま
す。ここで設定した \fIcomment\fP は，\fB\-int\fP や \fB\-iTt\fP オプシ
ョンで起動した時に，インジケータラインに表示されます。
.TP
.BI "#extension timeout " "program second"
インスツルメント番号 \fIprogram\fP で，\fIsecond\fP 秒以上サスペンド状
態が続いた場合，その音をオフにします。
.TP
.BI "#extension copydrumset " drumset
\fIdrumset\fP 番号の状態すべてを，現在の \fIdrumset\fP にコピーします。
.TP
.BI "#extension copybank " bank
\fIbank\fP 番号の状態すべてを，現在の \fIbank\fP にコピーします。
.TP
.BI "#extension copymap " "to\-MapID from\-MapID"
マップ \fIfrom\-MapID\fP に定義されたバンクの状態すべてを，マップ
\fIto\-MapID\fP にコピーします。
.TP
.BI "#extension HTTPproxy " hostname:port
HTTP のプロキシを設定します。プロキシのホスト名を \fIhostname\fP に，ポ
ート番号を \fIport\fP に指定します。
.TP
.BI "#extension FTPproxy " hostname:port
FTP のプロキシを設定します。プロキシのホスト名を \fIhostname\fP に，ポ
ート番号を \fIport\fP に指定します。
.TP
.BI "#extension mailaddr " your\-mail\-address
ユーザのメールアドレスを，\fIyour\-mail\-address\fP に指定します。この
メールアドレスは，FTP 接続をプロキシを介さずにダイレクトに繋ぐ場合に用
いられます。
.TP
.BI "#extension opt " option
起動時のオプションを指定します。
.TP
.BI "#extension undef " progno
現在のバンクのプログラム番号 \fIprogno\fP を未定義にします。
.TP
.BI "#extension legato " "progno " {0|1}
\fIprogno\fP でレガートを掛ける(\fB1\fP)，掛けない(\fB0\fP)を指定します。
.TP
.BI "#extension level " "progno tva_level"
NRPN の Drum Instrument TVA Level を処理する際，音量を変化させる基準と
なる値を設定します。曲中で Drum Instrument TVA Level が指定されない限り，
音量には一切影響しません。あくまで基準値です。\fIprogno\fP は `,' や 
``[\fIstart\fP]\-[\fIend\fP]'' で一括指定できます。\fIstart\fP，
\fIend\fP は省略すると，それぞれ \fB0\fP，\fB127\fP と見なされます。
.TP
.BI "#extension damper " "progno " {0|1}
\fIprogno\fP でリダンパー効果およびハーフダンパーを有効にする(\fB1\fP)，
無効にする(\fB0\fP)を指定します。
.TP
.BI "#extension playnote " "progno note"
ドラムセット音色の出音周波数を \fInote\fP とします。GS SysEx Play Note
で出音周波数が指定された場合に，この設定値を元にピッチを適切に変化させ
ます。\fIprogno\fP は `,' や ``[\fIstart\fP]\-[\fIend\fP]'' で一括指定
できます。\fIstart\fP，\fIend\fP は省略すると，それぞれ \fB0\fP，
\fB127\fP と見なされます。
.sp
例:
.br
drumset 0
.br
#extension playnote \-37,39,44\-46,55\-60
.TP
.BI "#extension delaysend " "progno level"
.br
.ns
.TP
.BI "#extension chorussend " "progno level"
.br
.ns
.TP
.BI "#extension reverbsend " "progno level"
ドラムパート・エフェクトがオンの場合のセンドレベルを設定します。初期値
はすべて \fB127\fP ですが，delay，chorus，reverb のどれか一つでも設定さ
れていれば，その音色に設定されていないエフェクトは初期値 \fB0\fP になり
ます。\fIprogno\fP は `,' や ``[\fIstart\fP]\-[\fIend\fP]'' で一括指定
できます。\fIstart\fP，\fIend\fP は省略すると，それぞれ \fB0\fP，
\fB127\fP と見なされます。
.TP
.BI "#extension rnddelay " "progno msec"
最大 \fImsec\fP 以内のディレイを，発音毎にランダムで付加します。ランダ
ム値の分布はホワイトノイズというより，むしろピンクノイズ(1/f ゆらぎ)で
す。
.LP
これらの拡張命令は `#' から始まっており，古い TiMidity では単なるコメン
トと扱われ無視されます。よって，古い TiMidity との互換性を保つことがで
きます。
.br
なお，\fBTiMidity++\fP では \fB#extension\fP は空白として扱われるように
なっています。
.LP
\fBTiMidity++\fP の設定ファイル(*.cfg)中の \fBsource\fP の引数に UNIX
のコマンドからの出力を利用できます(UNIX のみ)。ファイル名の最後に `|'
(ASCII 0x7c)を記述すると UNIX コマンドとみなされ，そのコマンドの出力が
\fBsource\fP の引数になります。
.br
\fBsource\fP \fIcommand\fP| のようにすると，\fIcommand\fP の出力が
\fBsource\fP の引数になります。環境によって \fBTiMidity++\fP の設定を選
択したい場合などに便利です。なお，\fIcommand\fP | のように，途中にスペ
ースが入ると，設定ファイル読み込み時に区切られてしまい，コマンドと見な
されなくなってしまいます。この機能はファイル名を指定できるすべての場所
に適用できます。
.sp
.RS
timidity 'cat fild.mid|'
.RE
.sp
は，cat fild.mid の出力結果から読み取ります。
.SH ファイル
.TP
.B /etc/timidity.cfg
.SH 関連項目
timidity(1), lsmidiprog(1), mididump(1), patinfo(1), sf2text(1), wav2pat(1)
.SH 著作権
Copyright (C) 1999\-2004 Masanao Izumo <iz@onicos.co.jp>
.br
Copyright (C) 1995 Tuukka Toivonen <tt@cgs.fi>
.LP
The original version was developed by Tuukka Toivonen <tt@cgs.fi>
until the release of TiMidity\-0.2i.  His development was discontinued
because of his being busy with work.
.LP
This program is free software; you can redistribute it and/or modify
it under the terms of the \fIGNU General Public License\fP as
published by the Free Software Foundation; either version 2 of the
License, or (at your option) any later version.
.LP
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 \fIGNU
General Public License\fP for more details.
.LP
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., 59 Temple Place, Suite 330, Boston, MA 02111\-1307
USA
.SH 入手元
\fBTiMidity++\fP は 改良版 TiMidity のページ
.LP
URL http://www.timidity.jp/
.LP
で手に入ります。