timidity

名前

TiMidity++ - MIDI-to-WAVE変換およびプレーヤー

書式

timidity [options] filename [...]

説明

TiMidity++ は，標準 MIDI ファイル(*.mid)，RCP ファイル(*.rcp, *.r36, *.g18, *.g36)あるいは Module ファイル(*.mod)を，RIFF WAVE 形式等 のオーディオファイルへ変換するコンバータです。各種 MIDI ファイルからデ ィジタルオーディオデータを生成するために，Gravis Ulstarsound 互換の patch ファイル，あるいは AWE32/64 の SFX，SF2 ファイルなどを使用します。 TiMidity++ によって生成されたデータは，更に加工するためにファイル に格納したり，オーディオデバイスを使ってリアルタイムに演奏したりするこ とができます。 リアルタイム演奏時には，KAR ファイルや WRD ファイルなどを読み込んで，歌 詞を表示することもできます。

ファイル名

filename には，以下の表記が使用可能です。

-

標準入力から読み込んだ MIDI ファイルを演奏します。

path/filename

ディスク上のファイルを演奏します。

dir:directory

 

directory/

directory 内すべてのファイルを演奏します。例えば， % timidity some/where/ として起動すると， some/where/ ディレクトリ内すべてのファイルが演 奏されます。

アーカイブファイル

アーカイブファイルから MIDI ファイルを展開しながら演奏します。アーカイ ブファイル中の個々のファイルを指定するには，アーカイブファイル名の後に 続けて `#' を記述し，その後に続けてアーカイブ中のファイル名を指定します。 `#' の後は UNIX shell の正規表現のパターンになっています。ただし，UNIX shell の正規表現とは少し異なり，大文字/小文字は区別されません。

 

ここで， \xHH という表現は，16 進数 `HH' で表した ASCII 文字列に マッチします。 例:

news://news-server[:port]/Message-ID

 

news://news-server[:port]/newsgroup[/first-last]

news-server に保存されている MIDI ファイルを演奏します。 newsgroup を指定すると，そのグループに投稿されている MIDI ファイ ルを演奏します。

 

news://* で指定したファイルは MIME の Multi Part を認識し，そこに 投稿されている MIDI ファイルを展開して演奏することができます。また通常 のファイルであっても，*.mime という拡張子で保存するか，あるいはファイル 名に mime: というプレフィックスを指定して入力すると MIME を認識し ます。 現在，以下のフォーマットが認識できます。

http://address

 

ftp://address

URL で指定した MIDI ファイルを演奏します。 例:

入力ファイル

TiMidity++ が自分で認識し，演奏することができる MIDI ファイルの形 式は以下の通りです。

.mid, .rmi (Format 0, 1, 2)

標準 MIDI ファイル(SMF)です。

.rcp, .r36, .g18, .g36 (レコンポーザ形式)

カモンミュージック社製レコンポーザ形式ファイルです。

.mfi (MFi Version 3 - i モード用メロディ形式)

最近流行りの携帯電話の着メロも再生できます。

.kar (Karaoke フォーマット)

Lyric Meta Event と同じように，歌詞が表示されます。

.mod, mod.* (Module ファイル)

.wrd (WRD 形式)

オプション

TiMidity++ では次のコマンドラインオプションが使用可能です。

-A [n][,m](a)

 

--amplification=n

 

--drumpower=m

 

--[no-]volume-compensation

全体の音量を n% にします。デフォルトでは 70 です。大きな値 を指定するほど大きな音になります。また，通常音色の音量とドラム音色の音 量の比率(ドラムパワー)を m% にします。デフォルトでは 100 で す。それぞれ， 0 (無音)から 800 までの値が有効です。

 

さらに， -a オプションに `a' の文字を付加するか， --volume-compensation オプションを指定することにより，音量自動 補正機能を有効にします。この機能は，MIDI データの MAINVOLUME を最大音量 (0x7f)に正規化するもので，できるだけダイナミックレンジを稼ぐ，曲間での 音量格差を小さくする，などの目的で使用されます。 例:

-a, --[no-]anti-alias

アンチエイリアシングを有効にします。-s オプションで低いサンプリ ングレートを指定したときに，折り返し雑音と呼ばれる不自然な成分が発生す ることがあります。 -a オプションで起動することで，この不自然な成 分を取り除くことができます。

-B n,m, --buffer-fragments=n,m

音源にデータを書き込む時の分割数(バッファフラグメント) n およびバ ッファサイズ 2^ m を指定します。 n は， 0 から 1000 までの値が有効です。フラグメントの数を大きくすると，プロセス が多数動いている時の音切れが減りますが，早送り，巻き戻し，ボリューム制 御などに対する反応は遲くなります。また，状態表示も同期が取れなくなりま す。 n を 0 にすると，できるだけ大きなフラグメントの値を取り ます。このオプションは Linux，FreeBSD，Windows のみで有効です。

-C n, --control-ratio=n

制御レートを指定します。TiMidity++ では，エンベロープやトレモロな どの音量計算を 1 サンプルごとに行うのではなく，複数のサンプルをまとめて 計算することで高速化を図っています。すなわち， n サンプルごとに， エンベロープやトレモロの音量が再計算されています。 n の値を小さく すればするほど音質が良くなりますが，その分 CPU パワーを必要とします。 n には 1 から 255 までの値を指定することができます。 デフォルトでは 1 msec に相当するサンプル数となっています。

-c file, --config-file=file

TiMidity++ の設定ファイル file を読み込みます。 TiMidity++ のデフォルトの設定ファイルを読み込んだ後， file が読み込まれます。

-D n, --drum-channel=n

n チャンネル目をドラムチャンネルにします。 -D -n の ように指定すると， n チャンネル目をドラムではなく，メロディチャン ネルにすることできます。 n に 0 を与えると，すべてのチャンネ ルがメロディチャンネルになります。

-d dir, --interface-path=dir

ダイナミックリンクインタフェースモジュールがインストールされているディ レクトリを dir で指定します。

-E mode, --ext=mode

TiMidity++ シーケンサの拡張モードを指定します(複数指定可)。以下の mode が指定できます。

-e, --evil

TiMidity++ のスレッドプライオリティを上げます。Windows のみで有効 です。このオプションを有効にすると， TiMidity++ 以外のプログラムが ほとんど動作できなくなる evil モードに入ります。

-F, --[no-]fast-panning

ファーストパンを指定します。このオプションを指定すると，Note ON のまま の状態で Midi control change 10: Panning が有効になります。デフォルトで はすぐには変化しないで，音量の再計算が必要になったときに変化します。改 良版ではトグルオプションになっています。

-f, --[no-]fast-decay

ファーストディケイを指定します。このオプションを指定にすると，エンベロ ープの変化時間が半分になり高速に動作します。ただし，音の立ち上がりとリ リース時間が短くなってしまいます。

-g sec, --spectrogram=sec

サウンドスペクトログラムを表示する Window を開きます。このオプションは X Window System がサポートされている環境のみで動作します。サウンドスペ クトログラムは声紋のようなもので，スペクトラムの時間変化を表現したもの です。

-H n, --force-keysig=n

調号の数を指定します。n が正の場合は♯(シャープ)の数， n が 負の場合は♭(フラット)の数のキーに移調ながら，MIDI ファイルを演奏します。 n には -7 から 7 までの値を指定することができます。 例えば， n に -1 を与えると，いかなる調性の MIDI ファイルで あっても，♭(フラット)が 1 個のヘ長調あるいはニ短調に移調しながら演奏す るので，演奏しやすい調性で楽器を練習するときの伴奏などに使うと便利です。

-h, --help

TiMidity++ のオプションの簡単な説明を表示します。

-i mode, --interface=mode

 

--realtime-priority=n

 

--sequencer-ports=n

ユーザインタフェースを指定します。環境によって利用可能なインタフェー スが異なります。

 

ALSA シーケンサインタフェースでは，別途 --realtime-priority オプションにより，リアルタイム・プライオリティを指定できます。また， --sequencer-ports オプションにより，シーケンサのポート数を指定 できます。デフォルトでは 4 です。

 

以下の mode が存在します。

-j, --[no-]realtime-load

このオプションを有効にすると，演奏しながらパッチファイルを読み込みます。

-K n, --adjust-key=n

n 半音単位でキーを調節(移調)します。 n には -24 から 24 までの値を指定することができます。

-k msec, --voice-queue=msec

ボイスを減少させるオーディオキュータイムを指定します。

-L path, --patch-path=path

サーチパスに path を追加します。patch ファイル，設定ファイル， MIDI ファイルなどは，このサーチパスに従って探索されます。最後に加えられ たディレクトリは最初に探索されます。ただし，このサーチパスに関係なく， カレントディレクトリがいつも最初に探索されるので注意すること。

-M name, --pcm-file=name

演奏する PCM ファイル名(*.wav または *.aiff)を指定します。 name に auto を指定すると，*.mid.wav または *.mid.aiff を演奏します。 name に none を指定すると，この機能を無効にします(デフォル ト)。

-m msec, --decay-time=msec

サステインしたノートがディケイされるまでの最大時間を指定します。

-N n, --interpolation=n

補完パラメータを指定します。-N オプションの挙動は -EFresamp オプション指定に依存します。

-O mode, --output-mode=mode

 

--flac-verify

 

--flac-padding=n

 

--flac-complevel=n

 

--oggflac

 

--speex-quality=n

 

--speex-vbr

 

--speex-abr=n

 

--speex-vad

 

--speex-dtx

 

--speex-complexity=n

 

--speex-nframes=n

出力モードやフォーマットを指定します。

 

Ogg FLAC 出力モードでは，別途 --flac-verify， --flac-padding，--flac-complevel， --oggflac オプションにより，それぞれ元波形とのべリファイ(圧縮速度が少し遅くなる)， ファイルヘッダのパディング長(デフォルトでは 4096)，0 から 8 までの圧縮レベル(デフォルトでは 5)，OggFLAC ストリームで出 力を指定できます。

 

Ogg Speex 出力モードでは，別途 --speex-quality， --speex-vbr，--speex-abr， --speex-vad， --speex-dtx，--speex-complexity オプションにより，そ れぞれ 0 から 10 までの圧縮品質(デフォルトでは 8)， VBR で出力，レート n の ABR で出力，VAD(voice activity detection) で出力，DTX(discontinuous transmission) で出力， 0 から 10 までの解析の複雑さ(デフォルトでは 3)，0 から 10 まで のOgg パケット内のフレーム数(Speex の処理単位)(デフォルトでは 1) を指定できます。

 

以下の mode が有効です。

-o file, --output-file=file

出力ファイル名を指定します。出力先がファイルでない場合はこのオプション は無視されます。 file を `-' にすると標準出力に出力されます。

-P file, --patch-file=file

すべての楽器を file(パッチ) を用いて演奏します。

-p [n](a)

 

--polyphony=n

 

--[no-]polyphony-reduction

最大同時発音数を n にします。

 

さらに， -p オプションに `a' の文字を付加するか， --polyphony-reduction オプションを指定することにより，自動で発 音数の減少させることを可能にします。デフォルトでは有効です。

-Q n[,...](t)

 

--mute=n[,...]

 

--temper-mute=n[,...]

n チャンネル目を演奏しないようにします。`,' で区切って，複数のチ ャンネルを指定することができます。 n に 0 を指定すると，すべ てのチャンネルを演奏しないようにします。続けて，- n を指定するこ とにより， n チャンネル目だけを演奏することができます。

 

一方， -Q オプションに `t' の文字を付加するか， --temper-mute オプションを指定することにより，音律種別 n をミュートします。 n には，プリセット音律種別として 0 から 3 までの値を，ユーザ定義音律種別として 4 から 7 までの値を指定することができます。

-q sec/n, --audio-buffer=sec/n

オーディオ最大バッファを sec 秒，オーディオ開始バッファを n% にします。デフォルトでは 5.0/100 です。100% のサイズはデ バイスバッファサイズと等価です。

-R msec

エンベロープリリースを msec に修正して音響効果を得ます(疑似リバー ブ)。 msec が 0 のとき， msec は 800 に設定されま す。

-S n, --cache-size=n

リサンプリングキャッシュの大きさをバイト数で指定します。頻繁に用いられ るサンプルは，あらかじめリサンプリングしておくことで高速化しています。 ただし，ビブラートやピッチベンドなどによってピッチが変化するサンプルは キャッシュされません。 0 を指定すると，まったくキャッシュしません。 デフォルトでは n は 2097152 (2MB)となっています。

-s freq, --sampling-freq=freq

再生サンプルレート(Hz または kHz)を指定します。

-T n, --adjust-tempo=n

テンポを n% に調節します。 n を 120 にすると，MOD ファ イルを NTSC Amiga のタイミングで演奏します。

-t code, --output-charset=code

テキストの出力文字コードを指定します。以下の code が指定可能です (大文字小文字は区別されません)。

-U, --[no-]unload-instruments

このオプションを有効にすると，演奏ごとに毎回，パッチに割り当てられてい たメモリを解放します。

-V power, --volume-curve=power

ベロシティ/ボリューム/エクスプレッションカーブを amp=vol^ power で power の値が 0 で自動， 1 で線形，約 1.661 で理 想，約 2 で GS 設定となります。

-v, --version

TiMidity++ のバージョン情報を表示します。

-W mode, --wrd=mode

入力ファイルの拡張子を .WRD または .wrd に変更したファイルが存在すれば， それを WRD ファイル として読み込み，そのコマンドと歌詞を表示します。 表示方法は以下の通りです。

-w mode, --rcpcv-dll=mode

Windows 用の拡張モードのオプションです。以下の mode が有効です。

-x str, --config-string=str

指定した文字列で TiMidity++ の設定を行います。 str の書式は timidity.cfg と同じです。例えば -x'bank 0\n0 violin.pat' とすると 0 番で指定される音色ををバイオリンにすることができます。 -x に続く文字列中の `\' (ASCII 0x5c)は特別文字として扱われ，そ れ以降の文字(列)に対し，C 言語のリテラルと同様の展開が行われます。例え ば，`\n' は改行を意味します。

-Z file, --freq-table=file

周波数テーブルを読み込みます。file に ``pure'' を指定すると，簡易 純正律で演奏します。

--module=n

特定の音源モジュールの動作をできるだけ真似ます。今のところ，定義されて いる n の値は次のとおりです。

関連項目

lsmidiprog(1), mididump(1), patinfo(1), sf2text(1), wav2pat(1), timidity.cfg(5)

著作権

Copyright (C) 1999-2004 Masanao Izumo <[email protected]> Copyright (C) 1995 Tuukka Toivonen <[email protected]> The original version was developed by Tuukka Toivonen <[email protected]> until the release of TiMidity-0.2i. His development was discontinued because of his being busy with work. 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 of the License, 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA

入手元

TiMidity++ は 改良版 TiMidity のページ URL http://www.timidity.jp/ で手に入ります。

バグ

小さな CPU-time-eating 獣よりも CPU time を喰う。

著者

Version 0.2i and earlier:

Tuukka Toivonen <[email protected]>

 

Vincent Pagel <[email protected]>

 

Takashi Iwai <[email protected]>

 

Davide Moretti <[email protected]>

 

Chi Ming HUNG <[email protected]>

 

Riccardo Facchetti <[email protected]>

TiMidity++:

出雲正尚 (IZUMO Masanao) <[email protected]>

 

原田智和 (HARADA Tomokazu) <[email protected]>

 

山手圭一郎 (YAMATE Keiichirou) <[email protected]>

 

木竜雅樹 (KIRYU Masaki) <[email protected]>

 

青木大輔 (AOKI Daisuke) <[email protected]>

 

松本庄司 (MATSUMOTO Shoji) <[email protected]>

 

小柳雅明 (KOYANAGI Masaaki) <[email protected]>

 

今井邦彦 (IMAI Kunihiko) <[email protected]>

 

野上貴哉 (NOGAMI Takaya) <[email protected]>

 

渡辺尊紀 (WATANABE Takanori) <[email protected]>

 

竹川視野 (TAKEKAWA Hiroshi) <[email protected]>

 

長野大介 (NAGANO Daisuke) <[email protected]>

 

木下浩介 (KINOSHITA Kosuke) <[email protected]>

 

重村法克 (SHIGEMURA Norikatsu) <[email protected]>

 

山幡為佐久 (YAMAHATA Isaku) <[email protected]>

 

荒井良重 (ARAI Yoshishige) <[email protected]>

 

Glenn Trigg <[email protected]>

 

Tim Allen <[email protected]>

 

Michael Haardt <[email protected]>

 

Eric A. Welsh <[email protected]>

 

Paolo Bonzini <[email protected]>

 

木本雅彦 (KIMOTO Masahiko) <[email protected]>

 

岩井隆 (IWAI Takashi) <[email protected]>

 

Saito <[email protected]>

 

佐藤研太郎 (SATO Kentaro) <[email protected]>

 

田向正一 (TAMUKI Shoichi) <[email protected]>

 

卜部昌平 (URABE Shohei) <[email protected]>

 

末永圭司 (SUENAGA Keishi) <[email protected]>

 

SUZUKI Koji <[email protected]>

(敬称略・順不同) これ以外にも， TiMidity++ メーリングリストの皆様をはじめ多くの方か ら情報，バグ報告などを頂いています。 WRDで使用される端末ターミナルエミュレーションのコードは X Consotium 等の kterm のコードの一部を取り込み，またそれを参考に実装を行いました。 和訳は松本庄司(MATSUMOTO Shoji <[email protected]>)。この和訳は正 確かどうかは保証できません。あなたがこの和訳の使用でいかなる損害を受け ても責任は持ちません。 TiMidity++ のオプション，cfg ファイルの解説は出雲正尚(IZUMO Masanao <[email protected]>)が， その nroff 化，およびマニュアルのリライトは長野大介(NAGANO Daisuke <[email protected]>)が行いました。 現在は，田向正一(TAMUKI Shoichi <[email protected]>)と卜部昌平(URABE Shohei <[email protected]>)が，マニュアルをメンテナンスしています。