home *** CD-ROM | disk | FTP | other *** search
/ Bila Vrana / BILA_VRANA.iso / 031A / KARDP17.ZIP / KARA.EN < prev    next >
Text File  |  1996-05-08  |  12KB  |  299 lines
  1.  
  2.  
  3.  
  4. KARA(1)                KaraDos Release 1.7                 KARA(1)
  5.  
  6.  
  7.  
  8.      kara.exe - karaoke player
  9.  
  10. SYNOPSIS
  11.      [path1]kara [path2]song
  12.        [-do={v/f}] [-po={s/m}]
  13.        [-hd={GUS/SB/MPU401/COM1/COM2/COM3/COM4}]
  14.        [-dl=xxxx]
  15.        [-re=name@keynumber]
  16.        [-rl]
  17.        [-ts={ns.100}]  [-ns={0.ts}] [-ls={y/n}]
  18.        [-dc=x] [-tc=x]
  19.        [-sz=x] [-ft=x]
  20.        [-ff=x] [-nb=x] [-af=x] [-ab=x] [-pf=x] [-st=x]
  21.        [-up={y/n}] [-sh={y/n}]
  22.        [-ry=[+|-]x] [-tr=[+|-]x] [-ve=[+|-]x] [-mu=x]
  23.  
  24.     with x = numerical value (see OPTIONS)
  25.  
  26.  
  27.  
  28. AVAILABILITY
  29.      The kara command is available within the kardp17.zip package
  30.      This package contains the KaraDos product delivery.  KaraDos
  31.      is a shareware. See the readme file  in  the  product.   The
  32.      package kards02.zip and kards03.zip contains karaoke files
  33.      collection 02 and 03
  34.  
  35.  
  36. DESCRIPTION
  37.      kara is a midi song player with  karaoke  features  for  dos
  38.      (lyrics synchronized with the music).
  39.  
  40.      Midi files with lyrics are automatically detected as Karaoke
  41.      files.
  42.  
  43.      Song may be directed to :
  44.      - the Gravis UltraSound card (GUS) internal synth with the
  45.       ultramid utility
  46.      - or directed to the midi output of the GUS
  47.      - or to the SoundBlaster FM synthetiser (with the
  48.       ameblast.exe TSR)
  49.      - or to the SoundBlaster MIDI port or Daughter board
  50.       wave card.
  51.      The hardware is automatically detected or specified with a
  52.       -hd=  option. The setup.exe program is an easy  way  to
  53.       specify the choice.
  54.      -  a MPU401 compatible card (complete or uart mode)
  55.      -  a serial port of the computer at 38400 bps.
  56.      No automatic detection is provided for these and the option
  57.       -hd= must be given.
  58.      Depending of the -hd choice,  some  environmental  variables
  59.      are used:
  60.      ULTRASND=xxx,y,z,... xxx is the base address of the GUS card
  61.       (see your documentation). Must be present if a  GUS  is
  62.       used.  (sure it is)
  63.      BLASTER=Axxx ...   xxx is the base address of a SoundBlaster
  64.       or compatible card. Mandatory.
  65.      MPU401=xxx  if the hexa base address is not equal to 330h,
  66.       the base address must be given.
  67.  
  68.      Text is directed to the screen in either  full  screen  with
  69.      full background and foreground colors capacity and choice of
  70.      characters size and style, or either in a video mode used to
  71.      become embedded in a video signal on tv set at the bottom of
  72.      the screen. In video mode the background color is black.
  73.  
  74.      Two kinds of song files are understood by kara :
  75.         - midi file with .mid extension
  76.         - karaoke file with .kar extension (karasoft format)
  77.  
  78.      Midi files may have a text file associated with  each  song.
  79.      The  file  name  of these text files must be the same as the
  80.      midi file with a .txk extension. Synchronization is made  on
  81.      the  note  on and off of a midi channel. A complete descrip-
  82.      tion of the .txk format is done in the following.
  83.  
  84.      Midi files with lyrics events embedded are  also  understood
  85.      as karaoke files.
  86.  
  87.      Karaoke files (.kar) are read in accordance with  the  Midi-
  88.      Soft format.
  89.  
  90.      If no lyric, the display will show the midi channel activity
  91.      while the music play.
  92.  
  93.      KaraDos support a display from right to left with
  94.      a special font.
  95.      See the Hebrew songs from Eyal Retter.
  96.  
  97.      While playing, the music can be  stopped,  continued,  tran-
  98.      sposed.   Each channel may be muted individually.  The tempo
  99.      can be adjusted and the volume of the synchronization  chan-
  100.      nel tuned.
  101.  
  102.      Permanent options may be saved in the kara.cfk file.
  103.  
  104.   VALID KEYS
  105.      SPACE to start and stop the music (toggle),
  106.      D : DOS session, type exit to return to KaraDos,
  107.      R (rythm) T (transpose) V (volume) followed with + or -
  108.      M (mute/unmute) followed with + or -
  109.       to choose the channel and space to toggle.
  110.      For each key, an indication is briefly displayed at the left
  111.       upper corner of the screen.
  112.  
  113.      Note on the volume: with a .mid & .txk set, the volume is
  114.       adjusted only for the synchro channel.
  115.      For a .kar file, the volume is adjusted for all channels at the
  116.       same time.
  117.  
  118.      L (line scroll) Toggle the display of the scroll marks
  119.       Valid only on full screen output.
  120.      S (shadow) Toggle the display of lyrics with shadow,
  121.      ESC or ALT X to quit.
  122.      PAGEUP will restart song and lyrics at the previews
  123.       scrolling
  124.      PAGEDOWN will advance to the next scrolling,
  125.      HOME will restart song and lyrics from the beginning,
  126.      RIGHT ARROW  will temporary speed up while the key is
  127.       depressed.
  128.      If no lyric, PAGE UP and DOWN give +/- 10% in music.
  129.      F1 or F2 : help in English or French,
  130.      F5 F6 F7 : XG GM GS Sysex reset
  131.      ENTER toggles the Midi channel display.
  132.  
  133.   MOUSE SUPPORT
  134.       Left button  : toggle the MIDI CHANNEL DISPLAY
  135.       Middle button: Speed up the music
  136.       Right button : Exit
  137.  
  138.   MIDI CHANNEL DISPLAY
  139.      The MIDI channel display is  a  screen  displayed  when   no
  140.      lyric  is  associated  to a .mid file or for others when the
  141.      enter key is depressed (toggle mode). This screen shows  the
  142.      channels activities while playing and the instrument associ-
  143.      ated.
  144.  
  145.   DEFAULT CONFIGURATION
  146.      Options that must remain permanent for a  configuration  may
  147.      be  given  in  a  kara.cfk  file  in the same directory than
  148.      kara.exe.  the format of this file is identical to the  text
  149.      song  file  without lyric obviously (options begin with # in
  150.      place of - in the command line).  kara.cfk options  overload
  151.      kara.exe default options.
  152.  
  153.   OPTIONS
  154.      [path2]song:if an extension is given to  song,  then  it  is
  155.      taken  into  account,  otherwise a default extension .kar is
  156.      assumed.  If song.kar does not exist, a song.mid is assumed.
  157.  
  158.      OPTION     COMMENT                                   DEFAULT
  159.      ------------------------------------------------------------
  160.   Kara options
  161.      -do={v/f}  display text in full screen or video mode    do=f
  162.      -po={s/m}  music to ultramid (synth) or midi port       po=s
  163.      -hd={GUS/SB/MPU401/COMx} Skip the automatic detection   none
  164.       this option is usefull only for the midi port output.
  165.      -re=name@keynumber for registered user. This option is
  166.       preferably put in the kara.cfk file.
  167.      -dl=xxxx  with xxxx a number of loops to adapt the serial
  168.       output speed                                   dl=2300
  169.  
  170.   Midi options
  171.      best used in a kdir catalogue .cat for particular songs (see
  172.      kdir.en)
  173.      -dc={1.16} drum channel number                         dc=10
  174.      -tc={1.16} text synchro channel (for .mid file)         tc=1
  175.      -ry=[[+]|-]{0.127} adjust rythm (delta) from original   ry=0
  176.      -tr=[[+]|-]{0.127} adjust transpose (delta)             tr=0
  177.      -ve=[[+]|-]{0.127}adjust velocity (delta)               ve=0
  178.      -mu={1.16} mute a channel at start                      none
  179.  
  180.   Screen options
  181.      -sz={0.10}  size of the text on the screen              sz=4
  182.      -ft={0.9}  type of font                                 ft=1
  183.      -rl        display text from right to left               -
  184.      -ts={ns.100} in %, the trigger point of the scroll     ts=90
  185.     The screen scroll when the active text reach
  186.     ts/100 of the total number of lines.
  187.      -ns={0.ts} in %, percent of the return point of the scroll
  188.       0 means a scroll to the beginning of the screen.   ns=0
  189.      -ls={y/n}  display or not the scroll mark lines         ls=y
  190.       Scroll options are valids only in full screen mode.
  191.  
  192.   Text options
  193.      -up={y/n}  insert a new line if a word begins with an   up=n
  194.     upper case and up=y. This option improves some .kar
  195.     files.
  196.      -ff={0.15} first text foreground color                 ff=15
  197.      -nb={0.15} normal background color in full screen       nb=1
  198.      -af={0.15} active text foreground color                 af=0
  199.      -ab={0.15} active text background color in full screen ab=14
  200.      -pf={0.15} post text foreground color