XCDPLAYER 1 "Feb 3 1992" "X Version 11"
NAME
xcdplayer - X window system interface to run the sun or sgi cdrom drive as a typical audio CD player.
SYNOPSIS
xcdplayer [ -toolkitoption ... ] [-xcdplayeroption ... ]
DESCRIPTION
Xcdplayer is a graphical user interface for controlling the Sun or SGI cdrom drive under the X Window System. It provides visual feedback and gives the user facilities for mode selection, device control, scanning, and programming.

Xcdplayer allows previously stored cd title and program information to be read from a specified directory and loaded into the player on startup or at disc changes. This directory can be specified either on the command line, by using the -cdInfoDir option, by using a customized personal resource file, or by setting the environment variable XCDINFODIR. If no directory is specified by any of these methods, xcdplayer looks in the current directory.

OPTIONS
Xcdplayer accepts all of the standard X Toolkit command line options (see X(1)), plus the following xcdplayer specific options:
"-debug" 12
Displays debugging messages as the tool runs.
-device devname
CDROM device to use (useful for systems with multiple CDROM drives)
-volBase <[0..255]>
Bottom of volume scale for player [range 0-255] (default 187)
-volPcent <float>
Ratio of volume change [range 0..255] to percent of scrollbar shown (default .267). This value is used in conjunction with the volBase parameter.
-cdInfoDir <path>
Specifies which directory should be used for storing and looking up CD information.
SUBWINDOWS
Xcdplayer contains the following subwindows:
"Title Window" 20
Displays the title of the CD (if stored or entered) corresponding to the CD currently in the CD player.
"Program Window"
Brought up on press of the program button, this panel contains a viewport displaying the current selected program, option buttons, and track selection buttons. The program window (and program mode) are dismissed via the Cancel button.

COMMAND BUTTONS

"Main Commands"
"play" 15
Enter play mode.
"pause"
Pause play. Activating this button has an effect on program selection.
"stop"
Stop disc and reset to beginning.
"prev"
Go back either to the beginning of the previous track (or start of current track if more than replayThreshold seconds have elapsed); if in program mode, go to previous selection in program.
"next"
Go to beginning of next track; if in program mode, go to next program selection.
"eject"
Eject the disc. Resets all modes.
"audio"
Toggle the audio output if possible. It will default to the best quality audio available (SGI only).
"quit"
Exit xcdplayer. (Leaves disc in last set state.
"cycle"
Cycle the disc. If in shuffle mode, reshuffle will occur at end of current shuffle; if in program mode, the program will replay.
"shuffle"
Select all of the tracks in random order. This button has no effect unless play mode is not active, and is a toggle to program mode.
"rewind"
Rewind the disc. If held down, will continue rewinding. Scan skip amount and pause interval between skips are controlled by the resources scanSkipInterval and scanPauseInterval. If the disc is paused, it will skip by the ammount specifed by pauseSkipInterval.
"fast-forward"
Analogous to rewind.
"program"
Enter program mode. If paused, add current track (if not 0) to program. Brings up program subwindow.

"Program Commands"

"Selections" 20
Selections displayed in the viewport of the program subwindow can be clicked on, and clicking on the currently selected track deletes it from the program. The highlighted selection indicates the current insert/delete point in the program, and if the CD is paused, clicking on a selection moves the program play point to that selection.

Selections can be added to the program either by clicking on the track buttons on the program form, or by using the forward and previous buttons on the main form while paused, and then clicking the program button again. Pre-insertion before the 1st programmed track is allowed by clicking on the space preceding the 1st entry.

"Clear"
Clears current program.
"Cancel"
Clears current program and cancels program mode and subwindow.
"Save"
Save the current program (if any) and current title to file in cdInfoDir. This file will then be read whenever the current disc is put into the player.
"track buttons"
Add the track number to the program at the current insertion point, or if active, add track number to the programmable track button.
"+10"
Add ten to the programmable track button.
"programmable track"
Add the selected track number (if available on CD) to program at the current insertion point.
"All"
Replace the current program with a sequential list of tracks on the CD.

"Miscellaneous Commands"
"track" 20
Show number of tracks on the CD.
"timer"
Toggle between time elaped and time remaining. If in program mode, and not paused, toggles to time remaining in program.
"volume scroll"
Adjust volume of CD player output.
"title"
Pop up dialog for editing title display. Title can then be associated permanently with that CD by using the save button in the program subwindow. The title is displayed on a button in a viewport, so that long titles won't distort the size of the tool.
FILES
cdInfoDir/cd.* these files contain title and stored program info saved for CDs
SEE ALSO
X(1)
LIMITATIONS
Xcdplayer cannot yet read the current volume level and adjust the volume scroll accordingly, because there is not current support for this in the driver.
BUGS
Xcdplayer occasionally "hangs" on a particular track, never quite reaching the end of it. Advancing to the next or previous track, or pressing the stop button rectifies this condition.
COPYRIGHT
Copyright (C) 1990 Regents of the University of California
AUTHORS

Rusty Wright (rusty@belch.berkely.edu)

Will Sadkin (wsadkin@bbn.com)

Dan Rich (drich@lerc.nasa.gov)