home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 8 / FreshFishVol8-CD2.bin / bbs / mus / cdtv-player-2.31.lha / CDTV-Player / Docs / readme < prev    next >
Text File  |  1993-09-30  |  15KB  |  435 lines
  1.    *******************************
  2.    **                           **
  3.    **      CDTV-Player 2.3      **
  4.    **                           **
  5.    **  designed in April 1993   **
  6.    **                           **
  7.    **      by Daniel Amor       **
  8.    **                           **
  9.    *******************************
  10.  
  11.    I. Introduction
  12.  
  13.    Welcome to CDTV-Player 2.3
  14.  
  15.    The idea for this program came up to me, as I was sitting in front of 
  16.    my CDTV and wanted to listen to some music and do some work at the 
  17.    same time. There is the possibility to press the play button while
  18.    working on Workbench, but nothing else than the track number will be
  19.    displayed. The other possibility to play Audio-CD's was to forget 
  20.    multitasking and use the built-in player-screen. I thought that 
  21.    this was quite lousy. In the German magazine 'AMIGA-DOS' I found a 
  22.    little program by Dr. Peter Kittel of Commodore - Germany in AMIGA-BASIC. 
  23.    This program looked more like a C-64 program with a lot of PEEKS and 
  24.    POKES. So I translated it into KICK-PASCAL (Lines in AmigaBasic vs 
  25.    Lines in Kick-Pascal = 200 vs 15) and designed a Workbench-Interface
  26.    (September 1992). This program is FISH-WARE. Commodore may even include 
  27.    this program into the original CDTV-package or bundle it with every CD-ROM.   
  28.    If you use this program for commercial matters, please don't forget to 
  29.    mention my name.
  30.  
  31.    II. Features
  32.  
  33.    CDTV-Player 2.3 features quite a lot of new options. First of all I
  34.    added preferences in order to keep the program user-friendly (this will
  35.    be extended in future versions). Then I've programmed a routine that
  36.    recognizes the CD if it's in the archive (thanks to Frédéric Botton - Paris 
  37.    for his «Gimme_a_CD»-program and the idea). Then I've introduced
  38.    a SHUFFLE function and an option to jump to seconds BACK and FORTH.
  39.    In earlier version only owners of a CD-ROM-drive could use the program.
  40.    Now everybody with an AMIGA has access to the archive in order to search 
  41.    for a song or just have a look at the program. I've included now an 
  42.    option called KARAOKE. If any lyrics are found in the archive they may
  43.    be displayed on-screen. Now an AREXX-Port has been included in order to
  44.    control the function of the CDTV from other programs.
  45.  
  46.  
  47.    III. Gadgets
  48.  
  49.    Here's a short explanation of the gadgets.
  50.  
  51.    REW     : Decreases track number.
  52.    PLAY    : Plays current track.
  53.    FF      : Increases track number.
  54.    PAUSE   : Pauses play.
  55.    STOP    : Stops play.
  56.    FADE    : Fades smoothly in/out.
  57.    LIVE    : Automatic fade in at the beginning of a track and automatic 
  58.              fade out a the end.
  59.    SINGLE  : Toggles between playing one song and the whole CD.
  60.    REPEAT  : Toggles between playing once or multiple times.
  61.    BACK    : Jumps two seconds back.
  62.    SCAN    : Scans into every song on the CD.
  63.    FORTH   : Jumps two seconds forth.
  64.    SECRET  : Future options.
  65.    KARAOKE : Live on-screen Karaoke (See V. KARAOKE).
  66.    SHUFFLE : Toggles between normal and shuffled play.
  67.    PROGRAM : Choose an order of play of your own.
  68.    PREFS   : Access to internal preferences. (See VII. PREFERENCES)
  69.    EDIT    : Opens edit window (See IV. EDIT).
  70.    DISPLAY : Toggles display-mode:
  71.              1. Track time played.
  72.              2. CD time played.
  73.              3. Remaining track time.
  74.              4. Remaining CD time.
  75.              5. No display (saves processing time).
  76.              Modes 3&4 accessible only with SINGLE off.
  77.    INFO    : Displays information.
  78.  
  79.    On the right side of the window there is a proportional gadget for
  80.    the volume.
  81.    
  82.     
  83.    IV. Edit
  84.  
  85.    By pressing the EDIT-Gadget in the main window, another window will be 
  86.    opened and you'll get access to the archive. In earlier version you had
  87.    to choose the CD you wanted to listen to from here. But this is done now
  88.    automatically, so you can only have a look at the archive now. You can have
  89.    a look at the songs by pressing the corresponding title. If CDTV-Player 
  90.    does not find the CD in the archive, you've got the possibility to
  91.    add this CD to the archive, by pressing the ADD CD-Gadget. A new window
  92.    will be opened and you've got the chance to enter the new CD. If you select
  93.    a group beforehand then the group name will appear automatically in the
  94.    group field.
  95.  
  96.  
  97.    V. Karaoke
  98.  
  99.    When pressing the KARAOKE-Gadget in the main window, the program searches
  100.    for the lyrics of the actual song. If found in the archive, they will be
  101.    displayed on a seperate screen, while playing the song. At the moment 
  102.    there aren't any special effects, but I'm going to do this in the near
  103.    future (all ideas are welcome). If you want to create own KARAOKE-songs,
  104.    have a look at 'lyrics:depeche mode.mx' (the only complete one, since I'm
  105.    too lazy to key in all lyrics). When a genlock is available, you may use 
  106.    it for KARAOKE.
  107.  
  108.  
  109.    VI. Archive
  110.  
  111.    The archive is divided actually into two parts. The first part includes
  112.    the group names and the CD titles, CD time, number of tracks (e.g. Brian 
  113.    Adams, Waking up the neighbours,74:54.38|15). In earlier version I 
  114.    omitted the fractions of the second and the number of tracks, but that was
  115.    not very precise for finding the right CD in the archive and so I had to 
  116.    include them, too. Have a look at Lyrics/A-ZMusix in order to learn
  117.    how to build own archives. The second part of the archive consists of 
  118.    the group-files with the track titles and the lyrics.
  119.  
  120.    IMPORTANT NOTICE:
  121.  
  122.    Although there is a standard for AUDIO-CDs, playtime for the same CD may 
  123.    vary from country to country. If you have a CD, which is in the archive, 
  124.    but isn't recognized then change the time which is being displayed 
  125.    in the ADD-CD window (normally it varies about a few seconds). I'll 
  126.    introduce a function, which allows to change the time in the file.
  127.  
  128.  
  129.    VII. Preferences
  130.  
  131.    In this menu you may alter the internal preferences for some functions.
  132.    On the left side there are two slider-gadgets. With the upper one you
  133.    may choose the time for fading in & out at the beginning and the end
  134.    of a track (1sec - 10sec). With the lower one you can choose the time for 
  135.    scanning into each track (5sec - 25sec). On the right there are two
  136.    check boxes which are both related with the KARAOKE-Feature. Break 
  137.    enables you to quit the KARAOKE whenever you want (a close-gadget 
  138.    appears on-screen) and Time puts the playing time on the KARAOKE-Screen.
  139.    This has been introduced to ease the input of new KARAOKE-Titles.
  140.    Preferences are saved to s:CDTV.config.
  141.  
  142.    VIII. The future
  143.  
  144.    I'll include a function called COPY, which will simplify the COPY
  145.    of CD's to a cassette. You'll just key in the exact amount of time you
  146.    want to be copied and the program will select the songs in order to
  147.    match your timing (or as close as possible).
  148.  
  149.    I'll try to use PARNET for my program in order to use e.g. an AMIGA 4000
  150.    for KARAOKE while playing from CDTV (i.e. more & faster effects).
  151.  
  152.    I'll try to extend the program in order to use it with SCSI-Drives (if
  153.    anybody has any information on SCSI-Drives, please write).
  154.  
  155.    If somebody out there has some other suggestions, needs or useful
  156.    information then please write to me. (See XIV. Address).
  157.  
  158.  
  159.    IX. Source-Code & Updates
  160.  
  161.    You can get the source-code for free, if you write to me and send a disk.
  162.    Suggestions and ideas are welcome. New groups for the archives are also 
  163.    welcome. CDTV-Player was written in KICK-PASCAL 2.12.
  164.  
  165.    You can get updates from me, you can download it from the AMINET, the FRAS,
  166.    the better mailboxes and can get them of course from the Fish-Disks.
  167.  
  168.    X. Assigns
  169.  
  170.    Applies to OS 1.3 only!
  171.  
  172.    For the moment, you'll have to do one ASSIGN in order to be able to 
  173.    load the Archive (I'm sorry). For example, if you've got the directory 
  174.    CDTV-Player in DF1:, then ASSIGN Lyrics: DF1:CDTV-Player/Lyrics. I've 
  175.    included a script for this purpose. 
  176.    
  177.  
  178.    XI. Arexx
  179.  
  180.    Arexx has been introduced in order to gain control over CDTV-Player from
  181.    other programs. Please refer to the examples on the disk. At the moment
  182.    you can only