XCDPLAYER(1)

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
    Displays debugging messages as the tool runs.

-device
    CDROM device to use (useful for systems with multiple CDROM drives)

-volBase
    Bottom of volume scale for player [range 0-255] (default 187)

-volPcent
    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
    Specifies which directory should be used for storing and looking up CD information.

SUBWINDOWS
Xcdplayer contains the following subwindows:

Title Window
    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
    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
    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
    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)