CDP - Documentation
*******************

Copyright
*********

    CDP (C) 1994-95 andreash, Andreas Harrenberg

    This program is freely distributable, but copyrighted by me.  This
means you may freely copy it as long as you do not charge more than  a
nominal  fee  for  copying.  This  program  may  be  put  on PD disks,
especially on Fred Fish's AmigaLibDisks and Fred's CDROMs. If you want
to  distribute  this  program you MUST keep this document with it. The
program and the  documents  must  be  distributed  in  their  original
unmodified form.

    This program  cannot  be  used  for  commercial  purposes  without
written  permission  by  the  author.  The  author  can  not  be  made
responsible for any damage which is caused by using this program.

    Send comments, suggestions or bug reports, and the gifts to:

    Andreas Harrenberg, Hubertusstr. 55
    D-52064 Aachen, Germany
    Phone: +49 (0)241 - 23784

    INTERNET:   andreash@pool.informatik.rwth-aachen.de
    INTERNET:   andreash@mowgli.fido.de
    FIDO:       2:2452/107.7@fidonet (Light)
    FIDO:       2:242/7.7@fidonet (Classic)

What is CDP ?
*************

    CDP is a simple CD Player for SCSI-II CD-Rom drives. It needs  MUI
(at least V2.3) for its GUI-Interface.

    CDP is in a very first stage of development, so don't  expect  too
much from this release. The main purpose of this  release  is  to  get
feedback from users.

Version
*******

    Please see file version.txt.

CLI arguments
*************

    TEMPLATE:

    -D=DEVICE/K,-U=UNIT/K,-S=SONGDIR/K,-DF=DISPLAYFONT/K,-BF=BIGDISPLAYFONT/K:

-D=DEVICE/K
    Devicename of the scsi-interface. Note that this name is case sensitiv!
    The suffix <.device> is optional, CDP will add <.device> for you.
    Default is <scsi.device>

-U=UNIT/K
    The unit-number of your CD-Rom drive. Default is 5.

-S=SONGDIR/K
    Directory for the songfiles. (SONGFILES NOT YET IMPLEMENTED)

-DF=DISPLAYFONT/K
    Small (normal) font for the display, defaults to topaz.font/8.

-BF=BIGDISPLAYGFONT/K
    Big font for the display, defaults to topaz.font/16.

WB Tooltypes
************

    The (long) CLI-Arguments are recognized as tooltypes.

    DEVICE=
    UNIT=
    SONGDIR=
    DISPLAYFONT=
    BIGDISPLAYFONT=

What you need !
***************

    - Kickstart >= 2.0

    - Workbench >= 2.0

    - MUI >= 2.3

    - SCSI-II CD-ROM

    - SCSI-Interface capable of sending scsi-direct-commands.

How to install
**************

Binaries
========

    Just copy the files cdp and the cdp.info to a place of your choice.


The GUI
*******

    After the first start CDP opens two  windows,  the  first  is  the
control-window with the display and the second displays all songs in a
listview.

    The listview contains information about  start-  and  playtime  of
each track, the type of the track  (data/audio)  and  the  title.  The
title  is  set  to Nr. x, but as soon as the songfiles are implemented
you can edit and set this to the real songnames.
    A doubleclick or a mui-select (cursor & return) will start playing
the  selected  song.   You   can   open/close   this   window   (MENU:
GUI/SONGS...), and the state of the window will be saved, so after the
next start of CDP the window may not be open.

    The control-window diplays the cd-title (if known by the programm)
in    the    first    textobject,    the    display    itself    shows
track/index/playtime.   In   future   version   there   will  be  more
(configurable) infos such as totalplaytime etc.

    The next group are numbergadgets from 1 to 9. This buttons can  be
used to start the songs from 1 to 9. Sorry, two digit numbers are  not
yet   implemented.   You  can  show/hide  this  group  from  the  menu
(GUI/NUMBERS...), the state will be saved after quiting CDP.

    The skip-section consist of search/index and skip, search jumps 10
seconds forward/back, index jumps to  next/previous  index,  and  skip
plays  the  next/previous  song.  This  group  can also made invisible
(MENU: GUI/SKIPS...), the state is saved.

    The index-skip only worked, if the CD-Rom drive is capable of this
feature, if not either nothing will happen, or the song is played from
the  start  again. As far as i know, the APPLE CD300 is NOT capable of
this command. In future releases there will be a special  routine  for
these drives.

    Ok, last but not least, play/pause/stop. These gadgets are alwalys
visible, as long as you don't iconfy the whole application.


What is to do in future ?
*************************

    - Songfiles...

    - new display

    - Index for ALL drives ?

    - programms


Thanks are going to ...
***********************

   - kmel, Klaus Melchior for his help with MUI

   - Stefan Stuntz for his MUI

   - and all I forgot to mention ...