home *** CD-ROM | disk | FTP | other *** search
/ MacPeople 1999 February 15 / MACPEOPLE-1999-02-15.ISO.7z / MACPEOPLE-1999-02-15.ISO / オンラインウエア / 厳選オンラインウエア100 / サウンド / TiMidity++1.0.0.68k.sit / TiMidity++1.0.0.68k / doc / README < prev    next >
Text File  |  1999-01-06  |  17KB  |  401 lines
  1. ==============================================================================
  2.         TiMidity++ -- MIDI to WAVE converter and player
  3.  
  4.                     Masanao Izumo
  5.                     <mo@goice.co.jp>
  6.                     Jan.5.1999
  7.                     version 1.0.0 or lator
  8. ==============================================================================
  9.  
  10.   This program is free software; you can redistribute it and/or
  11.   modify it under  the  terms  of  the  GNU  General  Public
  12.   License  as  published  by  the  Free Software Foundation;
  13.   either version 2 of the License, or (at your  option)  any
  14.   later version.
  15.  
  16.   Original version of this program is written by Tuuka Tiovonen <tt@cgs.fi>
  17.   until TiMidity 0.2i. (he discontinued to develop it because of his busy
  18.   work)  And Masanao Izumo <mo@goice.co.jp> and other people has begun to
  19.   hack it, then we decided TiMidity++ officially release.
  20.  
  21.   TiMidity has originally been a converter that converts MIDI files to WAV
  22.   audio file. But now TiMidity++ is not only a converter but also the
  23.   real-time player that can play a MIDI file in real time. TiMidity does
  24.   not requires external MIDI instrument module to play MIDI file, performs
  25.   with software power.
  26.  
  27.   TiMidity++ uses GUS/patch (Glavis Ultrasound) as the voice data to play.
  28.   And it can also handle SoundFont data for voice data.
  29.  
  30. *Features of TiMidity++:
  31.  
  32.   - Plays MIDI files without external MIDI instruments
  33.   - Converts MIDI file to various formatted audio file
  34.     (ex. wav, au, etc..)
  35.   - Uses GUS/patch and SoundFont for voice data
  36.   - Displays some of information of Music data during the playing
  37.   - Various user interface are available (ncurses, motif, xaw, etc..)
  38.   - Plays the MIDI file via network
  39.   - Plays the MIDI file in archive file
  40.   - Plays not only SMF file but also MOD, RCP/R36/G18/G36
  41.   - Can handle 32 channel data
  42.   - Can handle user interfaces as dynamic link modules
  43.   - Can display the sound spectrogram
  44.   - Automatically detects the mode of MIDI file (GM/GS/XG)
  45.   - Automatically detects drum channels (GS/XG)
  46.   - Trace playing
  47.   - Low load
  48.   - The following MIDI events are supported:
  49.     NoteOn/Off, KeyPressure, Program, ChannelPressure, Pitchwheel,
  50.     ToneBank, ModulationWheel, MainVolume, Panning, Expression,
  51.     Sustain, Portamento, DataEntry, ReverbEffect, ChorusEffect,
  52.     RPN+/-, NRPN, RPN, AllSoundsOff, ResetControllers, AllNotesOff,
  53.     Mono/Poly Part, RandomPan, KeyShift,
  54.     TempoChange, Lyric, InsertText, KARAOKE-Part(@KMIDI),
  55.     MasterVolume, MIDI-Reset, SystemExclusiveMessages
  56.  
  57. (NOTE: Features that are Japanese local are not described in this file for simplify.
  58.        Please refer to timidity.1/timidity.cfg.1 for these features )
  59.  
  60. *Usage:
  61.   -format: timidity [options] midi-filenames
  62.  
  63.   -option:
  64.       -A amplification
  65.               Multiplies  the  master  volume by amplification %.
  66.               Default value is 70%.  The grater number of  amplification
  67.               makes louder sounds.  Range of the amplification is from 0 to 800%.
  68.  
  69.       -a      Turns on anti-aliasing. Samples are  run  through  a
  70.               low-pass filter before playing, which reduces aliasing
  71.               noise at low resampling frequencies.
  72.  
  73.       -B fragments
  74.               For the Linux /  FreeBSD  /  OSS  /  Windows  sound
  75.               driver,  selects  the  number  of buffer  fragments
  76.               in interactive  mode.   Increasing  the  number  of
  77.               fragments  may  reduce  choppiness  when many  proc-
  78.               esses are running.  It will make TiMidity++ seem  to
  79.               respond  sluggishly  to  fast  forward, rewind, and
  80.               volume  controls, and  it  will  throw  the  status
  81.               display off sync.  Specify a fragments of 0 to  use
  82.               the maximum number of fragments available.
  83.  
  84.       -b mode
  85.  
  86.               Enables pseudo surround effects.   mode  parameters
  87.               are the following:
  88.               -bl    Sounds are comes mainly from left.
  89.               -br    Sounds are comes mainly from right.
  90.               -bb    Sounds are comes left and right in random.
  91.               -bc    Disables this feature.
  92.  
  93.       -C ratio
  94.               Sets the ratio of sampling and control frequencies.
  95.               This determines how often  envelopes  are  recalcu-
  96.               lated  -- small ratios yield better quality but use
  97.               more CPU time.
  98.  
  99.       -c filename
  100.               Reads an extra configuration file.
  101.  
  102.       -D channel
  103.               Marks channel as a drum  channel.   If  channel  is
  104.               negative,  channel -channel is marked as an instru-
  105.               mental channel.  If channel is 0, all channels  are
  106.               marked as instrumental.
  107.  
  108.       -d dir  Specifies the directory contains installed dynamic-
  109.               link interface modules.
  110.  
  111.  
  112.       -e      Make   TiMidity++   evil.   On  Win32  version,  this
  113.               increases the task priority by  one.  It  can  give
  114.               better  playback  when  you  switch  tasks  at  the
  115.               expense of slowing all other tasks down.
  116.  
  117.       -E mode
  118.               Set  TiMidity++ extend modes. The following modes are
  119.               available (capitalized switch  means  disable  this
  120.               feature):
  121.               w/W    Enables/disables modulation controlling.
  122.               p/P    Enables/disables portamento controlling.
  123.               v/V    Enables/disables NRPM vibration.
  124.               r/R    Enables/disables  reverb effect controlling.
  125.               c/C    Enables/disables chorus effect  controlling.
  126.               c ratio
  127.                      Sets the chorus effect value of all channels
  128.                      to ratio.
  129.               s/S    Enables/disables channel  pressure  control-
  130.                      ling.
  131.               t/T    Enables/disables   tracing   all  Text  Meta
  132.                      Events.
  133.               o/O    Accepts/rejects  pronouncing  multiple  same
  134.                      notes.
  135.               m HH   Sets  the  manufacture  ID to HH ( HH is the
  136.                      two hex-digits ).
  137.                      In addition if HH is GM/gm , GS/gs or  XG/xg
  138.                      that are same as to 41 , 43 and 7e.
  139.               B bank Sets  the  bank  number  of  all channels to
  140.                      bank.
  141.  
  142.       -F      Turns  on  fast  panning to accommodate MIDI pieces
  143.               that expect panning  adjustments  to  affect  notes
  144.               that  are  already  playing.  Some files that don't
  145.               expect  this  have  a  habit  of  flipping  balance
  146.               rapidly  between  left  and  right, which can cause
  147.               severe popping when the -F flag is used.
  148.               In  current  versions  of  TiMidity++ this option are
  149.               toggled.
  150.  
  151.       -f      Toggles fast envelopes. This option makes  TiMidity++
  152.               do  fast  but  the  release  time  of the notes are
  153.               shorten.
  154.  
  155.       -g sec  Open the Sound-Spectrogram window. This  option  is
  156.               activated  if  the  system has support for X Window
  157.               System.
  158.  
  159.       -h     Show the help message.
  160.  
  161.       -I voice[/c]
  162.               Uses the program number as the default  instrument.
  163.               Any  Program Change events in MIDI files will over-
  164.               ride this option.
  165.               If the voice followed by  /c  the  default  program
  166.               number  of the channel c is specified by the voice.
  167.  
  168.       -i interface
  169.               Selects the user interfaces  from  the  compiled-in
  170.               alternatives.  interface  must be begun with one of
  171.               the supported interface identifiers.  Run  TiMidity++
  172.               with  the  -h  option to see a list.  The following
  173.               identifiers may be available:
  174.               -id    dumb interface
  175.               -in    ncurses interface(old version)
  176.               -iN    NEW ncurses interface
  177.               -is    slang interface
  178.               -ia    X Ahtena Widget interface
  179.               -ik    Tcl/Tk interface
  180.               -im    motif interface
  181.               -iT    vt100 interface
  182.               -ie    Emacs  interface  (press  M-x  timidity   on
  183.                      Emacs)
  184.               -ii    skin interface
  185.                      Environment  variable  TIMIDITY_SKIN must be
  186.                      specified with path of  the  skin  data(com-
  187.                      pressed data are also available).
  188.  
  189.               Interface options
  190.                      Option characters may be  added  immediately
  191.                      after the interface identifier.  The follow-
  192.                      ing options are recognized:
  193.  
  194.               v      Increases  verbosity  level.  This option is
  195.                      cumulative.
  196.               q      Decreases verbosity level.  This  option  is
  197.                      cumulative.
  198.               t      Toggles  trace mode.  In trace  mode, TiMid-
  199.                      ity attempts  to  display  its current state
  200.                      in real time.  For the Linux  sound  driver,
  201.                      this is  accomplished  through  the  use  of
  202.                      short  DMA  buffer  fragments,  which can be
  203.                      tuned via the -B option.
  204.  
  205.       -j      This option enables to load the  patch  file  while
  206.               playing.
  207.  
  208.       -L  directory
  209.               Adds directory to the library path.  Patch, config-
  210.               uration, and  MIDI  files  are searched along  this
  211.               path.  Directories  added  last  will  be  searched
  212.               first.   Note  that the current directory is always
  213.               searched first before the library path.
  214.  
  215.       -n degree
  216.               Enables Noise Shaping Filter. degree is from 0(min)
  217.               to 4(max).
  218.  
  219.       -O mode
  220.               Selects the output mode from the compiled-in alter-
  221.               natives.  mode must begin with one of the supported
  222.               output mode identifiers.  Run TiMidity++ with the  -h
  223.               option  to  see  a list.  The following identifiers
  224.               should be available in all versions:
  225.               -Od    Output via audio device (default)
  226.               -Or    Generate  raw  waveform  data.   All  format
  227.                      options   are   supported.   Common  formats
  228.                      include:
  229.                       -OrU   uLaw
  230.                       -Or1sl 16-bit signed linear PCM
  231.                       -Or8ul 8-bit unsigned linear PCM
  232.               -Ou    Generate Sun Audio (au) file
  233.               -Oa    Generate AIFF file
  234.               -Ow    Generate RIFF WAVE format output.  If output
  235.                      is  directed  to  a non-seekable file, or if
  236.                      TiMidity++ is interrupted before  closing  the
  237.                      file,   the   file   header   will   contain
  238.                      0xFFFFFFFF in the RIFF and data block length
  239.                      fields.   The popular sound conversion util-
  240.                      ity sox  is  able  to  read  such  malformed
  241.                      files,  so you can pipe data directly to sox
  242.                      for on-the-fly conversion to other  formats.
  243.               Format options
  244.                      Option  characters  may be added immediately
  245.                      after the mode identifier to change the out-
  246.                      put  format.  The following options are rec-
  247.                      ognized:
  248.                       8      8-bit sample width
  249.                       1      6-bit sample width
  250.                       l      Linear encoding
  251.                       U      uLaw (8-bit) encoding
  252.                       M      Monophonic
  253.                       S      Stereo
  254.                       s      Signed output
  255.                       u      Unsigned output
  256.                       x      Byte-swapped output
  257.               Note that some  options  have  no  effect  on  some
  258.               modes.   For  example,  you cannot generate a byte-
  259.               swapped RIFF WAVE file, or force uLaw output  on  a
  260.               Linux PCM device.
  261.  
  262.       -o filename
  263.               Place  output  on  filename,  which  may be a file,
  264.               device, or HP-UX audio  server,  depending  on  the
  265.               output  mode  selected with the -O option. The spe-
  266.               cial filename ``-'' causes output to be  placed  on
  267.               stdout.
  268.  
  269.       -p voices
  270.               Sets  polyphony  (maximum  number  of  simultaneous
  271.               voices) to voices.
  272.  
  273.       -Q channel
  274.               Causes channel to be quiet.  If  channel  is  nega-
  275.               tive, channel -channel is turned back on.  If chan-
  276.               nel is 0, all channels are turned on.
  277.  
  278.       -R value
  279.               Enables Pseudo Reverb Mode. value are  the  follow-
  280.               ing:
  281.               0      Long slight release
  282.               1      Long loud release
  283.               2      Short release
  284.               3      No release
  285.  
  286.       -r      This options causes another reverb effects.
  287.  
  288.       -s frequency
  289.               Sets  the resampling frequency(Hz or kHz).  Not all
  290.               sound devices are capable of all frequencies --  an
  291.               approximate frequency may be selected, depending on
  292.               the implementation.
  293.  
  294.       -U      Instructs  TiMidity++  to unload all instruments from
  295.               memory between MIDI files.  This can reduce  memory
  296.               requirements when playing many files in succession.
  297.  
  298.       -w mode
  299.           Extend mode for MS-Windows. The following  options  are
  300.           available:
  301.           -wr  Use rcpcv.dll to play RCP/R36 files.
  302.           -wR  Not use rcpcv.dll (default).
  303.  
  304.       -W mode
  305.           Play with WRD file.  mode are the follwing:
  306.           x    X Window System mode
  307.           t    TTY mode
  308.           d    Dumb mode (outputs WRD events directry)
  309.           -    not traces WRD
  310.               WRD mode must be with trace mode(option -i?t) or  timing  of
  311.               WRD events are terrible.
  312.  
  313.       -WR[opts]
  314.           Sets WRD options:
  315.  
  316.           a1=b1,a2=b2, ...
  317.               Sets the WRD options. an is the name of option and
  318.               bn is the value.
  319.  
  320.           -WRd=n
  321.               Emulates timing(@WAIT,@WMODE) bugs of the original
  322.               MIMPI player.  The emulate level is following:
  323.               -WRd=0
  324.               not emulates any bugs of MIMPI
  325.               -WRd=1
  326.               only emulates some bugs (default)
  327.               -WRd=2
  328.               emulates all known bugs
  329.           -WRF=filename
  330.               Uses    filename     as        WRD        file     only
  331.               (input-file-name):r.wrd    (like  csh syntax) is not
  332.               available.
  333.           -WRf=filename
  334.               Uses filername as WRD file.
  335.  
  336.       -x string
  337.               Configure  TiMidity++  by  the  string. The format of
  338.               string is the same as timidity.cfg.
  339.               For example:
  340.               -x'bank 0¥n0 violin.pat'
  341.               Sets the instrument number 0 to violin.
  342.  
  343. *Play the MIDI file in archive file:
  344.  
  345.  TiMidity++ can play a file contained in various archive file. The
  346.  following archive format are supported:
  347.  
  348.   - tar           (*.tar)
  349.   - tar + gzip'ed (*.tar.gz, *.tgz)
  350.   - zip file      (*.zip)
  351.   - lzh file      (*.lzh)
  352.  
  353.  If you  want  to  specify  a  certain MIDI file in the archive, describe
  354.  the  #<MIDI-filename>  expression following  to  the  archive  name.  The
  355.  expressions after the # is allowed to use  regular  expressions
  356.  (case insensitive). For example:
  357.  
  358.               timidity'file.zip#file.mid'
  359.                      Plays file.mid in file.zip
  360.  
  361.               timidity'file.lzh#*.mid'
  362.                      Plays  any  files  that  match  the  regular
  363.                      expression '*.mid' in file.zip
  364.  
  365.               timidity'file.tgz#*'
  366.                      This  expression   is   same   as   timidity
  367.                      'file.tgz'
  368.  
  369. *Play the MIDI file via network
  370.  TiMidity++ can access a file via networks. Supported network protocol is
  371.  HTTP, FTP and NNTP(NetNews). And specify these as
  372.  http://foo, ftp://foo, and news://foo respectively.
  373.  An archived file also accessible via network.
  374.  
  375.  On NNTP access, if you specify newsgroup in the message-ID field
  376.  TiMidity++ plays all MIDI files posted in specified newsgroup. These MIDI
  377.  files must be encoded in uuencode or the Multipart encoded uuencode /
  378.  base64 / hexbin.
  379.  
  380. *Availability:
  381.  The latest release of TiMidity++ are available in these sites:
  382.  
  383.      http://www.goice.co.jp/member/mo/timidity/
  384.         (unix version, and developer's site)
  385.  
  386.      http://www.asahi-net.or.jp/~gb7t-ngm/timidity/
  387.         (Macintosh version)
  388.  
  389.      http://www2.off.ne.jp/~dai/timidity/timidity-izumo.html
  390.         (Windows version)
  391.  Now, the original release of Tuukka Toivonen is discontinued.  If you
  392.  want to get the original, please download from follow.
  393.      http://www.goice.co.jp/member/mo/timidity/dist/timidity-0.2i.tar.gz
  394.  
  395.  
  396. -------------------------------------------------------------------------
  397. This document is translated from original README.jp (written in Japanese).
  398. Translator: NAGANO Daisuke <breeze_geo@geocities.co.jp>
  399.             (And modified by Masanao Izumo <mo@goice.co.jp>)
  400. If you have any comment for this translation, please tell me.
  401.