ascd(1)

NAME
ascd - the AfterStep and WindowMaker CD player

SYNOPSIS
ascd [ -h ]
ascd [ -a ] [ -b background color ] [ -c time ] [ -g geometry ] [ -f color ] [ -d device ] [ -i time ] [ -t ] [ -w ] [ -v volume ] [ -1 ] [ -2 control 2 ] [ -3 control 3 ]

DESCRIPTION
ascd is CD player written to play audio CD's integrated in afterstep's Wharf module or WindowMaker's dock. ascd handles mounted volumes, and opens and closes the tray. ascd also includes a mixer which can control the value of various sound settings.

CONFIGURATION OPTIONS
-h, -help
     prints the usage message -g
     specifies the geometry of ascd. The Geometry
     works like the standard X-Window geometry option. -w
     withdrawn more. Use this option to dock ascd
     with WindowMaker. -i <seconds>
     specifies the timeout for the help texts. The
     default is 1 second. -f <color>
     specifies the color of the LEDs. To find out what
     colors are available, try showrgb(1)
     (part of X11). -b <color>
     specifies the background color of the LEDs. -a
     turn on autoplay mode. When this is turned
     on, ascd always wait for a CD, and play it
     automatically when inserted. -t
     autorepeat mode: when ascd reaches the end of the
     last track, the CD is not stopped and first track
     is played. -c <time in seconds>
     specifies the time -in seconds- for intro scan
     and cue modes. -d Device
     specifies the CDROM device which should be used by
     ascd. -v <volume>
     specifies the value to assign to the first mixer
     control (main volume as default. This can be changed
     with the -1 option) Valid range is 0 to 100. -1 <control>, -2 <control>, -3 <control>
     binds a mixer device to one of the three controls of
     the ascd mixer. Valid devices are:
     VOLUME, BASS, TREBLE, SYNTH, PCM, SPEAKER, LINE,
     MIC, CD, IMIX, ALPTPCM, RECLEV, IGAIN, OGAIN,
     LINE1, LINE2, LINE3
     default is : -1 VOLUME, -2 CD, -3 PCM.

INVOCATION
ascd can be called from one of many ways. The most common invocation is the command line:
	[user@host] ~% ascd -d /dev/wcd0a -w -l yellow &
With Afterstep, another way to call ascd is from the window manager:
	*Wharf - - Swallow "ascd" ascd&
This line, when placed in the .steprc file in the users home directory will cause ascd to use the shape extensions so that it will be a button on the Wharf (1) button bar under the afterstep (1) window manager.

USAGE
  +----------------------------------------------+
  | <A>                                          |
  | Track/Disk Ellapsed/Remaining Display        |
  | [right clic: switch between CD & mixer]      |
  +----------------------------------------------+
  +-------------+  +-------------+  +------------+
  | <B> Play,   |  | <C> Stop,   |  | <D> Track  |
  | Pause,      |  | Eject, Quit |  | Progress.  |
  | Intro scan  |  |             |  | Bar        |
  +-------------+  +-------------+  |            |
  +-------------+  +-------------+  |            |
  | <E> Back    |  | <F> Track   |  |            |
  +-------------+  | Nb Display  |  |            |
  +-------------+  |             |  |            |
  | <G> Next    |  |             |  |            |
  +-------------+  +-------------+  +------------+
<A> Time Display
    Show the ellapsed time of the track. But by clicking
    on the display with the left button, several
    informations will be displayed :
    - elapsed time of the current track; (nothing)
    - remaining time of the current track; ("-")
    - elapsed time of the whole disk; ("o")
    - remaining time of the whole disk; ("o" on "-")
    Clicking on the display with the right button
    brings the mixer screen. In this screen, another
    right click brings back the CD player screen. <B> Play, Pause, Intro Scan
    When the CD is stopped, clicking with the right button
    on this starts the "Intro Scan" mode. ascd plays the
    first ten seconds of each track. This value can be
    changed with the "-c" command line option <C> Stop, Eject, Quit
    With left button, stop the CD while playing; eject
    when stopped. The right button ends application. <D> Track Progression Bar
    This bar shows the progression of the track. With a
    clic you can:
    - left : direct random access
    - right: go to the loop start locator

    Note: when a global time is displayed on <A>, the
    progress bar give access to all tracks. With a
    single left clic, you can acess any part of the
    CD. <E> and <G> Previous/Next track
    - left : go to previous/next track.
    - mid : go to first/last track of the disk.
    - right: review/cue mode, by 10 seconds steps.
      (as for the intro scan mode, this value can be
      changed with the "-c" option) <F> Track Number Display/Loop control
    Clicking on the display activates the loop function:
    you can repeat a portion of the track. You have to
    define the start position and the end position, then
    activate the loop.
    - left : loop start locator = current position;
    - right: loop end locator = current position;
    - mid : (des)activate the loop.

COPYRIGHTS
Copyright 1998, Rob Malda and Denis Bourez. No guarantees or warranties or anything are provided or implied in any way whatsoever. Use this program at your own risk. Permission to use this program for any purpose is given, as long as the copyright is kept intact.

AUTHORS
Rob Malda <malda@slashdot.org>
     application
Denis Bourez <denis@rsn.fdn.fr>
     application since 0.7
Steven Grimm <koreth@Hyperion.COM>
     author of Workman 1.3
Erik O'Shaughnessy <eriko@austin.ibm.com>
     AIX platform device driver
Michael Kurz <mkurz@rzws.fh-aalen.de>
     changes and man page
Chris Jantzen <cjantzen@geocities.com>
     changes in asmixer
Alen Salamun <snowman@hal9000.medinet.si>
     changes in asmixer

MORE INFORMATION
<URL:http://slashdot.org/malda/> <URL:http://worldserver.oleane.com/rsn/>