ascd(1)

NAME
ascd - An AfterStep and WindowMaker CD player with an optional mixer module

SYNOPSIS
ascd [ -help ]
ascd [ -version ]
ascd [ -geometry geometry ] [ +/-withdrawn ] [ -bg color ] [ -fg color ] [ -mbg color ] [ -mfg color ] [ -device device ] [ +/-a ] [ +/-t ] [ -cue time ] [ -ti time ] [ -volume volume ] [ -mvolume volume ]

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 may also include a mixer which can control the value of various sound settings.

CONFIGURATION OPTIONS
-help, -h
     print a list of commandline options and exit. -version
     print the version number and exit. -geometry <geom>
     specifies the geometry of ascd. The Geometry
     works like the standard X-Window geometry option. +/-withdrawn, +/-w
    Turn on and off withdrawn mode. Use this option if
    you use ascd with WindowMaker. -fg <color>
     specifies the color of the LEDs. To find out what
     colors are available, try showrgb(1)
     (part of X11). -bg <color>
     specifies the background color of the LEDs. -mfg <color>
     specifies the color of the LEDs in mixer mode. -mbg <color>
     specifies the background color in mixer mode. -device <device>
     specifies the CDROM device which should be used by
     ascd. If "-DNO_DEFAULT_DEVICE" was set at
     compilation time this option will have no effect. -cue <seconds>
     specifies the time -in seconds- for intro scan
     and cue modes. -ti <seconds>
     specifies the timeout for the help texts. The
     default is 1 second. +/-autoplay, +/-a
     Turn on or off autoplay mode. When this is
     turned on, ascd always wait for a CD, and play it
     automatically when inserted. +/-autorepeat, +/-t
     autorepeat mode: when ascd reaches the end of the
     last track, the CD is not stopped and first track
     is played. -volume <value>
     Set the CD driver volume, between 0 and 100. Note
     that the -volume option in independant from the
     mixer. It controls the drive, not the sound
     card. -mvolume <value>
     Set the CD driver volume (0-100) for the mute
     mode. -mixer <control>
     Set the default mixer control. <control> should be
     one of the following:
     VOLUME, BASS, TREBLE, SYNTH, PCM, SPEAKER, LINE,
     MIC, CD, IMIX, ALPTPCM, RECLEV, IGAIN, OGAIN,
     LINE1, LINE2, LINE3 -load
     Load the mixer settings saved in ~/.ascdrc file.

INVOCATION
ascd can be called from one of many ways. The most common invocation is the command line:
	% ascd -device /dev/wcd0a +w +a -load &
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
The default mode when starting ascd is the CD player:
  +----------------------------------------------+
  | <A>                                          |
  | Track/Disk Ellapsed/Remaining Display        |
  | Mute mode/Mixer mode                         |
  +----------------------------------------------+
  +-------------+  +-------------+  +------------+
  | <B> Play,   |  | <C> Stop,   |  | <D> Track  |
  | Pause,      |  | Eject, Quit |  | Progress.  |
  | Intro scan  |  |             |  | Bar        |
  +-------------+  +-------------+  |            |
  +-------------+  +-------------+  |            |
  | <E> Back    |  | <F> Track   |  |            |
  +-------------+  | Nb Display  |  |            |
  +-------------+  |             |  |            |
  | <G> Next    |  |             |  |            |
  +-------------+  +-------------+  +------------+
<A> Time Display
    Clicking on the display with left button cycle
    between:
    - 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 "-")
    A middle click on the display toggles the "mute
    mode" ;
    A right click switch to the mixer screen, if mixer
    mode was included at compilation time. <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.

THE MIXER SCREEN
When switching to mixer mode, the progress bar <D> act like a slider. The <E> and <G> (previous/next) buttons are used to switch between controllers, with these options:
    - left click: previous/next controller
    - middle click: go to CD volume
    - right click: first/last controller The track display <F> has also a new behaviour:
    - left: save all ascd settings in ~/.ascdrc
    - right: load ~/.ascdrc settings

STARTUP
When launching, ascd first use the compilation-time settings. Then, it searchs for ~/.ascdrc file and load all the settings except the mixer ones. Then the commandline options are parsed. Finally, if the "-load" commandline option was found, ascd parses again ~/.ascdrc but load only the mixer settings. This means that:
    - you can overide the "factory" options with the
      ~/.ascdrc file ;
    - you can overide all the precedent ones with command
      line options.

BUGS AND LAST CORRECTIONS
On FreeBSD, ascd <= 0.8 can't eject the disk and lock this one: you have to quit ascd (right click on stop button) to eject the CD. This has been fixed in 0.9.

COPYRIGHTS
Copyright 1999, 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
Denis Bourez <denis@rsn.fdn.fr>
     application since 0.7
Rob Malda <malda@slashdot.org>
     application until 0.6
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 until 0.6

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