home *** CD-ROM | disk | FTP | other *** search
/ Sound, Music & MIDI Collection 2 / SMMVOL2.bin / MIDI_PAT / KARDP16.ZIP / KARA.EN < prev    next >
Encoding:
Text File  |  1995-05-15  |  10.4 KB  |  331 lines
  1.  
  2.  
  3.  
  4. KARA(1)                KaraDos Release 1.6                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.        [-re=name@keynumber]
  15.        [-dc=x] [-tc=x]
  16.        [-sz=x] [-ft=x]
  17.        [-ff=x] [-nb=x] [-af=x] [-ab=x] [-pf=x] [-st=x]
  18.        [-ry=[+|-]x] [-tr=[+|-]x] [-ve=[+|-]x] [-mu=x]
  19.  
  20.         with x = numerical value (see OPTIONS)
  21.  
  22.  
  23.  
  24. AVAILABILITY
  25.      The kara command is available within the kardp16.zip package
  26.      This package contains the KaraDos product delivery.  KaraDos
  27.      is a shareware. See the readme file  in  the  product.   The
  28.      package kards02.zip contains karaoke files collection 02
  29.  
  30.  
  31. DESCRIPTION
  32.      kara is a midi song player with karaoke features for dos.
  33.  
  34.      Song may be directed to :
  35.      - the Gravis UltraSound card (GUS) internal synth with the
  36.           ultramid utility
  37.      - or directed to the midi output of the GUS or SoundBlaster
  38.           and compatible card.
  39.      The hardware is automatically detected or specified with a
  40.           -hd=  option.
  41.      -  a MPU401 compatible card (complete or uart mode)
  42.      -  a serial port of the computer at 38400 bps.
  43.      No automatic detection is provided for these and the option
  44.           -hd= must be given.
  45.      Depending of the -hd choice,  some  environmental  variables
  46.      are used:
  47.      ULTRASND=xxx,y,z,... xxx is the base address of the GUS card
  48.           (see your documentation). Must be present if a  GUS  is
  49.           used.  (sure it is)
  50.      BLASTER=Axxx ...   xxx is the base address of a SoundBlaster
  51.           or compatible card. Mandatory.
  52.      MPU401=xxx  if the hexa base address is not equal to 330h,
  53.           the base address must be given.
  54.  
  55.      Text is directed to the screen in either  full  screen  with
  56.      full background and foreground colors capacity and choice of
  57.      characters size and style, or either in a video mode used to
  58.      become embedded in a video signal on tv set at the bottom of
  59.      the screen. In video mode the background color is black.
  60.  
  61.  
  62.  
  63. KaraDos             Last change: 22 May 1995                    1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. KARA(1)                KaraDos Release 1.6                KARA(1)
  71.  
  72.  
  73.  
  74.      Two kind of song files are understood by kara :
  75.             - midi file with .mid extension
  76.             - karaoke file with .kar extension (karasoft  format)
  77.      Midi  files must have a text file associated with each song.
  78.      The file name of these text files must be the  same  as  the
  79.      midi  file with a .txk extension. Synchronization is made on
  80.      the note on and off of a midi channel. A  complete  descrip-
  81.      tion of the .txk format is done in the following.
  82.  
  83.      If no lyric, the display will show the midi channel activity
  84.      while the music play.
  85.  
  86.      While playing, the music can be  stopped,  continued,  tran-
  87.      sposed.   Each channel may be muted individually.  The tempo
  88.      can be adjusted and the volume of the synchronization  chan-
  89.      nel tuned.
  90.  
  91.      Permanent options may be saved in the kara.cfk file.
  92.  
  93.   VALID KEYS
  94.      SPACE to start and stop the music,
  95.      r (rythm) t (transpose) v (volume) followed with + or -
  96.      m (mute/unmute) followed with + or -
  97.           to choose the channel and space to toggle.
  98.      ESC to quit.
  99.      For each key, an indication is briefly displayed at the left
  100.           upper corner of the screen.
  101.      Note on the volume: with a .mid & .txk set, the volume is
  102.           adjusted only for the synchro channel.
  103.      For a .kar file, the volume is adjusted for all channels.
  104.      PAGEUP will restart song and lyrics at the previews
  105.           scrolling
  106.      PAGEDOWN will advance to the next scrolling,Home will
  107.           restart song and lyrics from the beginning,
  108.      RIGHT ARROW  will temporary speed up while the key is
  109.           depressed.
  110.      If no lyric, PAGE UP and DOWN give +/- 10% in music.
  111.      ENTER toggles the Midi channel display.
  112.  
  113.   MOUSE SUPPORT
  114.       Left button  : toggle the MIDI CHANNEL DISPLAY
  115.       Middle button: Speed up the music
  116.       Right button : Exit
  117.  
  118.   MIDI CHANNEL DISPLAY
  119.      The MIDI channel display is  a  screen  displayed  when   no
  120.      lyric  is  associated  to a .mid file or for others when the
  121.      enter key is depressed (toggle mode). This screen shows  the
  122.      channels activities while playing and the instrument associ-
  123.      ated.
  124.  
  125.  
  126.  
  127.  
  128.  
  129. KaraDos             Last change: 22 May 1995                    2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. KARA(1)                KaraDos Release 1.6                KARA(1)
  137.  
  138.  
  139.  
  140.   DEFAULT CONFIGURATION
  141.      Options that must remain permanent for a  configuration  may
  142.      be  given  in  a  kara.cfk  file  in the same directory than
  143.      kara.exe.  the format of this file is identical to the  text
  144.      song  file  without lyric obviously (options begin with # in
  145.      place of - in the command line).  kara.cfk options  overload
  146.      kara.exe default options.
  147.  
  148.   OPTIONS
  149.      [path2]song:if an extension is given to  song,  then  it  is
  150.      taken  into  account,  otherwise a default extension .kar is
  151.      assumed.  If song.kar does not exist, a song.mid is assumed.
  152.  
  153.      OPTION     COMMENT                                   DEFAULT
  154.      ------------------------------------------------------------
  155.   Kara options
  156.      -do={v/f}  display text in full screen or video mode    do=f
  157.      -po={s/m}  music to ultramid (synth) or midi port       po=s
  158.      -hd={GUS/SB/MPU401/COMx} Skip the automatic detection   none
  159.           this option is usefull only for the midi port output.
  160.      -re=name@keynumber for registered user. This option is
  161.           preferably put in the kara.cfk file.
  162.   Midi options
  163.      best used in a kdir catalogue .cat for particular songs (see
  164.      kdir.en)
  165.      -dc={1.16} drum channel number                         dc=10
  166.      -tc={1.16} text synchro channel (for .mid file)         tc=1
  167.      -ry=[[+]|-]{0.127} adjust rythm (delta) from original   ry=0
  168.      -tr=[[+]|-]{0.127} adjust transpose (delta)             tr=0
  169.      -ve=[[+]|-]{0.127}adjust velocity (delta)               ve=0
  170.      -mu={1.16} mute a channel at start                      none
  171.   Screen options
  172.      -sz={0.10}  size of the text on the screen              sz=4
  173.      -ft={0.9}  type of font                                 ft=1
  174.   Text options
  175.      -ff={0.15} first text foreground color                 ff=15
  176.      -nb={0.15} normal background color in full screen       nb=1
  177.      -af={0.15} active text foreground color                 af=0
  178.      -ab={0.15} active text background color in full screen ab=14
  179.      -pf={0.15} post text foreground color                   pf=3
  180.      -st={0.11} fill style of the background                 st=0
  181.               See also DEFAULT CONFIGURATION
  182.       --------------------
  183.       Color        |Value|
  184.       --------------------
  185.       BLACK        |  0  |
  186.       BLUE         |  1  |
  187.       GREEN        |  2  |
  188.       CYAN         |  3  |
  189.       RED          |  4  |
  190.       MAGENTA      |  5  |
  191.       BROWN        |  6  |
  192.  
  193.  
  194.  
  195. KaraDos             Last change: 22 May 1995                    3
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. KARA(1)                KaraDos Release 1.6                KARA(1)
  203.  
  204.  
  205.  
  206.       LIGHTGRAY    |  7  |
  207.       DARKGRAY     |  8  |
  208.       LIGHTBLUE    |  9  |
  209.       LIGHTGREEN   | 10  |
  210.       LIGHTCYAN    | 11  |
  211.       LIGHTRED     | 12  |
  212.       LIGHTMAGENTA | 13  |
  213.       YELLOW       | 14  |
  214.       WHITE        | 15  |
  215.       ---------------------
  216.       Note  :Colors  depends  on  your  hardware,CGA,EGA  or  VGA
  217.      screen.
  218.   FONTS
  219.      9 fonts are available
  220.  
  221.   STYLES
  222.       -----------------------
  223.       Style name      |Value|
  224.       -----------------------
  225.       EMPTY FILL      |  0  |
  226.       SOLID FILL      |  1  |
  227.       LINE  FILL      |  2  |
  228.       LTSLASH FILL    |  3  |
  229.       SLASH FILL      |  4  |
  230.       BKSLASH FILL    |  5  |
  231.       LTBKSLASH FILL  |  6  |
  232.       HATCH FILL      |  7  |
  233.       XHATCH FILL     |  8  |
  234.       INTERLEAVE FILL |  9  |
  235.       WIDE DOT FILL   | 10  |
  236.       CLOSE DOT FILL  | 11  |
  237.       -----------------------
  238.  
  239.  
  240.   FORMAT
  241.   Format of the .txk ascii file
  242.   -----------------------------------------------
  243.      The two first lines are reserved for the title,  author  and
  244.      copyright  if any (.TXK only).  Following lines are a mix of
  245.      text lines and attribut lines.
  246.  
  247.      Text lines are as you want to see it on the screen  apart  a
  248.      syllable  separator.  Valid separators are blank - , ; the -
  249.      separator is not displayed for example the line:  i  be-come
  250.      la-zy  is displayed as : i become lazy  but is "karaoked" as
  251.      : i be come la zy. It is more easy  to  understand  than  to
  252.      explain.
  253.  
  254.      Attribut  lines  begin  with  #  followed  with  one  option
  255.      described  in  the  OPTIONS  .  Warning: the # replace the -
  256.      character.  A new option is added : #rem for adding  a  com-
  257.      ment  line.   Kara  option #do and #po are disabled and will
  258.  
  259.  
  260.  
  261. KaraDos             Last change: 22 May 1995                    4
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. KARA(1)                KaraDos Release 1.6                KARA(1)
  269.  
  270.  
  271.  
  272.      not work.  Only music, screen and line options will be given
  273.      in a  .txk file.  A line option remains valid until the same
  274.      is given.  The screen options taken  into  account  are  the
  275.      last given.
  276.  
  277.      .txk options overload options given in the command  line  or
  278.      in the kara.cfk file.
  279.  
  280.      kara.cfk options are overloaded with any other options  from
  281.      the command line or the .txk file.
  282.  
  283.   Formatting the ascii text in .kar
  284.   ----------------------------------------
  285.      A text beginning with the character / or with  an  uppercase
  286.      is displayed on a new line.  A text beginning with the char-
  287.      acter  is displayed after two empty line ( note: normally it
  288.      will be a new screen. It's my choice).
  289.  
  290.  
  291. SEE ALSO
  292.      kdir.en
  293.  
  294. BUGS AND RESTRICTIONS
  295.      Some font and size  combinations  may  not  work  perfectly.
  296.      Files  *.chr  and *.bgi must reside in the same directory as
  297.      kara.exe.  Files .txk must be in  the  same  directory  than
  298.      corresponding .mid files Some karaoke files may be too large
  299.      to fit in DOS memory.  (Never seen but  ...)  Please  report
  300.      bug if you find one.
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327. KaraDos             Last change: 22 May 1995                    5
  328.  
  329.  
  330.  
  331.