===========================================================================
Name       : Discs.txt CD Player
Version    : 1.47
Release    : 05 May 2004
Require OS : MS-Windows 98/ME/2000/XP
Author     : Takabin (Bin TAKANAMI)
             This program is copyrighted Takabin,
             but you can use Free WIHTOUT Commercial Use.
             (Use it at your own risk.)
===========================================================================

About:

  This program is a CD player that supports Discs.txt and lyrics database
  of Audiograbber. You can use CDPlayer.ini instead of Discs.txt.

  If your PC is installed ASPI manager, this program can digital playback.
  Win9x come with adaptec's ASPI manager, but WinNT/2000/XP do not, so you
  need to install manually. Under WinNT/2000/XP, you can chose "NT/2000
  calls" (SPTI) instead of ASPI manager. Under Win2000/XP, your account
  must have administrator privileges. ASPI/SPTI playback Supports hidden
  track playback. 


Usage:

   1. Run the program and select general settings menu and specify your 
      discs.txt or cdplayer.ini. Select lyrics settting menu and specify
      Audiograbber's lyrics folder. Select playback method setting menu
      and chose playback method.
   2. Open track selector and push a drive button that an audio disc is 
      inserted. Check tracks you want to play. You can select all drives
      that your PC have.
   3. Select Play menu or push the playback button.


Lyrics:
   This program support two format of lyrics files. The first is a file
   format created by Audiogabber. One file contains lyrics for all tracks
   and named CDDBID.lyr. The second is separeted file, one file for one 
   track and names CDDBID_??.lrc or CDDBID_??.txt. ?? is specified by
   track No. written in decimal and two figures.
   Ex.) CDDBID is 1E02700D and root folder for Lyrics is C:\Lyrics.
          For track 1
            C:\Lyrics\1E02700D\1E02700D_01.lrc
          For track 2
            C:\Lyrics\1E02700D\1E02700D_02.lrc
          For track 12
            C:\Lyrics\1E02700D\1E02700D_12.lrc

   This program support time tag for lyrics. This tag is written at the
   head of each line and used for synchronizing music and lyrics.
   [xx:yy:zz]
      xx:Minutes in decimal and two figure.
      yy:Seconds in decimal and two figure.
      zz:10 Milliseconds in decimal and two figure.
   Ex) A lyrics is "This is a sample for time tag." and start at 03:12:758
          [03:12:75]This is a sample for time tag.
       or
          [03:12:76]This is a sample for time tag.

   You can write some information for the track as @Tag. Any lines that the
   first character is "@" are not displayed on Lyrics displayer. 
   This program supports these @Tags
     @Title
        The title of the song.
     @Album
        The name of the disc.
     @Artist
        The name of the artist who has made the track.
     @TaggingBy
        The name of the man who add time tags to the file.

   More about the time tag and @tags are written in TimeTag.html
   (Japanese only)


Playback method:

  1. MCI
    Send playback commands via MCI(Media Control Interface) of Windows. 
    digital/analog depends on the multimedia setting of windows. Win98 
    supports digital playback for atapi connected drive only, but Win2000
    supports both atapi and scsi. Win95&NT4 don't support it.

  2. ASPI(Analog)
    Send analog playback commands via ASPI manager or NT/2000 calls. All
    drives must be conncted to soundcard. You can play the hidden track.
    And some drives suppors CDG-KARAOKE.

  3. ASPI(Digital)
    Send DAE(Digital Audio Extraction) command via ASPI manager or NT/2000
    calls, and play the ripped music continuously. This program sends 
    ReadCD in MMC (SCSI-3 Multi-Media Commands) or ReadCDDA or ReadCDDAMSF
    as a DAE command, so your drive must support one of these commands. 
    In this mode, a pre-emphasized track will be de-emphasized. You can 
    play the hidden track. And some drives suppors CDG-KARAOKE.


Sound Effects:

  You can use these sound effects during ASPI Digital playback.
    * Stereo Mode
    * Speed Control
    * Equalizer
    * Normalized(Compressed) playback
    * Reversed playback


Hidden Track:

  Some discs have a pre-gap field of the 1st track that contains sound 
  data. We call the field hidden track. This field contains special music
  or artist's message.
  
  To play the hidden track, right click the drive button on the track 
  selector. Hidden track will be shown as track0. You can combine the 
  hidden track with the first normal track.

  This program regard all field between sector 150 and the head of the 1st
  track. Some discs start the 1st track from a bit later, so this program 
  may mistake some times. In this case the data is usually silence, but if
  not, it causes terrible noise and may damage your ears and audio devices.
  Be carefull.


CDG-Karaoke:

  If your drive can read R-W subcode, this program can decode and display
  CDG-Karaoke. To display CDG, you need some confiugrations below.

  1. ASPI-Analog playback
     No configuration is required.
     If you want to adjust frames readed/diplayed at once, edit these keys
     in drive.ini. Each drive can have own configuration.
       [?:] 
       AWaitFirst=100   // Wait time for the first state check after start.
       AInterval=20     // Interval of the state check and CDG read.
       ACdgEnabled=True // False = disabled, True = Enabled
       ACdgReadAtOnce=2 // Number of frames that readed at once.
       ACdgDispAtOnce=5 // Number of frames that decoded at once.

  2. ASPI-Digital playback
     You must specify "Sector Size" on playback method settings "Data + 
     SubRW" or "Data + SubRAW". If you want to adjust frames diplayed at
     once, specify following options.
       Read at once = 10
       Overlap size = 5
       Compare size = 2
       Buffer length = 100
       Playback buffers = 2


Help File:

  You can download a help for the program from my webpage. Download and 
  extract zipped files, then put them in the same directory as the program.


Credit:

  Computing Freedb disc ID routine is written by Thomas Chevereau 
  (discid.c) and Jay A. Key (CDDBIDGEN).
  http://www.tchev.home.ml.org/
  http://www.freedb.org

  De-Emphasizing filter used internally is copyrighted WTC.

  TimeTag.html is written by Dagashiya.
  You can know more about time tag and @tag here:
  http://get.to/dagashiya (Japanese Only)

  CD+G decoding engine is based on a document written by Jim Bumgardner.

  ASIO is a trademark of Steinberg Soft- und Hardware GmbH.
  http://www.steinberg.net/

  Calliasio is a good interface written by Ross Bencina to handle ADIO SDK
  with Borland compiler.
  http://www.audiomulch.com/~rossb/code/calliasio


Version history:

  Version 1.47 (2003-11-30)
    Added "Mute pre-gap of data tracks" option.
    Supports auto playback of inserted disc, when program is idling.
  Version 1.46 (2003-09-29)
    Supports in_cdda.cdb of Winamp5.0superearlyalphaness.
    Supports cent mode for optional speed control.
    Improved internal FLOAT32/64 data type.
    Improved ASIO playback.
    Fixed a bug of SPTI related code.
  Version 1.45 (2003-08-25)
    Supports playback via ASIO 2.0 drivers.
    Supports Int8/16/24/32, Float32/64 output.
    Supports AC3/DTS path through.
    Int8/16/24/32, Float32/64 are selectable for internal data format.
    Normalizer/compressor affects at the tail of all effects.
    Supports controll of CD reading speed.
    Some minor inprovements and bug fixes.
  Version 1.44 (2003-05-11)
    Improved Normalized playback (Compressor)
    Added hidden options to disable ASPI/SPTI.
    Some drives could not get correct drive letter on Windows 2000/XP.
  Version 1.43 (2003-03-07)
    Some IDE drives could not get correct drive letter on Windows 2000/XP.
  Version 1.42 (2003-03-02)
    Improved balance control of the eqaualizer.
    Improved Gap and TOC analysis.
    Bug fixes.
  Version 1.41 (2003-02-11)
    Supports TOSHIBA compatible command for DAE.
    Some drives could not switch stereo mode during analog playback.
    Change .ini and .elf format a little. (NOT compatible with 1.40)
    Some minor improvements and bug fixes.
  Version 1.40 (2003-01-05)
    Enabled user defined volume parameters defaultly.
    Improved lyrics displayer during reversed playback.
    Analog playback possibly caused blue screen, when SPTI was available
    and ASPI was not available.
    CDG was not displayed correctly during analog playback since 1.38.
  Version 1.39 (2002-12-23)
    Better support for large fonts and non-Japanaese version of Windows.
    Improved lyrics displayer.
  Version 1.38 (2002-12-15)
    Improved jitter correction.
    Added hidden options to specify original volume parameters.
    Rewrote internal digital playback engine.
  Version 1.37 (2002-09-29)
    Added discs.txt editor.
    Improved main panel.
  Version 1.36 (2002-09-23)
    Supports volume control.
    Supports Winamp2 CDDB (in_cdda.cdb).
  Version 1.35 (2002-09-20)
    3 buttons on main panel are configurable.
    Bug fixes.
  Version 1.34 (2002-09-15)
    Jitter corrects CDG packets.
    Calculates CDPlayer.ini ID by internal function.
    Fixed RS(24, 20) decoder's problem.
  Version 1.33 (2002-09-08)
    Supports DirectSound.
    Added internal De-Inteleave and Error-Correction engine for CDG.
    Optimaized handling of .ini/.lng files.
  Version 1.32 (2002-08-25)
    Supports reversed playback.
    Supports CDG decode during ASPI-Analog playback.
    Can select stereo mode during ASPI-Analog playback.
    Can control playback speed at intervals of 0.1%.
    Supports track offset at interval of samples. (Compatible with EAC.)
    Added hidden options to specify max/min readable adress in Drive.ini.
    Added a option to prohibit track select during a pause.
    Improved right click menu on drive buttons.
    Better handling of language files.
    Some minor improves and bug fixes.
  Version 1.31 (2002-06-23)
    Added "Drives" and "Tracks" in playback menu.
  Version 1.30 (2002-06-01)
    Supports CD-G Karaoke during ASPI-Digital playback.
    Bug fixes.
  Version 1.29 (2002-04-07)
    Added task tray options.
    Added optional speed controller.
    Added some drive options.
    Added track duplication function.
    Added "Detect TOC Manually" function.
    Changed some key name in ldplayer.ini.
  Version 1.28 (2002-03-10)
    Optimized playback engine and sound effcts.
    Supports MMC(MSF) commands
    Saves draive settings in Drive.ini
    Fixed de-emphasizing filter's bug.
  Version 1.27 (2002-03-07)
    Disabled disk writer.
    Bug fixes.
  Version 1.26 (2002-02-01)
    Added "Gap Analysis Method" option.
    Added "Sync Method" option.
    Added "Offset" option.
    Bug fixes.
  Version 1.25 (2002-01-20)
    Gived priority to PlayAudioMSF command in analog playback.
    Added "Title Color" option.
    Bug fix of pre-gap analysis.
  Version 1.24 (2001-12-16)
    Added "Gap Analysis" option.
  Version 1.23 (2001-12-12)
    Added "Advanced (BCD)" in TOC Analysis methods.
    Added "SONY (MSF)" in DAE commands.
  Version 1.22 (2001-12-10)
    Added options under play method settings.
      - TOC Analysis Mode
      - DAE Commands (MMC/SONY)
    Added some hidden options in LDPlayer.ini.
      - Permit Data track
      - Minimum Length of Tracks
      - Minimum Length of Hidden Track.
  Version 1.21 (2001-11-14)
    Supports USB connected drives.
  Version 1.20 (2001-10-15)
    Add some keyboard shortcuts
    Bug fixes.
  Version 1.19 (2001-10-08)
    Added "Min gain" option to Normalized playback.
    Supports CD-TEXT.
  Version 1.18 (2001-10-07)
    Added Normalized playback.
    Bug fixes.
  Version 1.17 (2001-09-24)
    Thread priority option.
    Improved Disk writer.
    Equalizer bug fix.
  Version 1.16 (2001-09-16)
    Added Equalizer.
    Added Disk writer.
    Supports association with .CDA & AudioCD.
  Version 1.15 (2001-09-09)
    Added Jitter Correction.
    Added non-stop playback.
    Supports disc changers.
    Bug fix.
    More chages...
  Version 1.14 (2001-06-30)
    Supports Language file.
  Version 1.00 (2001-04-15)
    The first release.


Contact takabin:

  E-Mail : takabin@ma.kcom.ne.jp
  URL    : http://webclub.kcom.ne.jp/ma/takabin/ (Japanese only)
           http://webclub.kcom.ne.jp/ma/takabin/eng/ (English)
