1To compile and install this on Sun or SGI, you only need to type:
2	xmkmf
3	make depend
4	make
5And, if all went well, copy the appropriate XCdplayer.ad.* file to
6XCdplayer.ad (some day, this will get added to the Imakefile) and type:
7	make install
8
9If you don't have Imake, then you will need to hack the Makefile.  The
10one provided should work fine on an SGI.
11
12Please send any problems/questions/bug-reports to drich@lerc.nasa.gov.
13
14Brought to you by:
15	drich@lerc.nasa.gov
16	wsadkin@bbn.com
17	rusty@belch.berkeley.edu
18
19NOTE FOR PEOPLE WHO WONDER WHY NONE OF THE BUTTONS SHOW UP WHEN THEY
20START XCDPLAYER: You forgot to do a "make install" so that the
21XCdplayer.ad file gets installed in the application defaults directory
22(e.g., /usr/local/x11r4/lib/app-defaults).  If you can't install files
23in the application defaults directory you can copy XCdplayer.ad to
24~/XCdplayer and have a go at it.
25
26**** Coming in version 3.0 (I hope... :-))
27
28o Track titles
29o New programming interface (as yet to be defined)
30o Single file/database for track and program information
31
32**** Wish List
33
34o Motif support (I would like to see 3-D buttons (drich))
35o Merging of all of the button callbacks to eliminate redundant code
36
37**** Work in progress
38
39o Record button (will be in the next release)
40
41**** Version history
42
43Fri Oct  2 08:29:08 EDT 1992 - version 2.2
44+ Fixes from Dan Rich (drich@lerc.nasa.gov) to:
45  Added support for SGI systems (IRIX 4.0.2 and greater only!), including
46  the ability to play through the audio port.
47
48+ You can now hit return from the disc title dialog to enter the title.
49
50+ Added a set of color defaults to make the application look more decorative.
51
52+ It will now detect a new disc being inserted into the CDROM drive.
53
54+ Added new timer button feature.  Clicking when disc is stopped displays
55  time on entire disc.
56
57+ Ff and rewind will skip 15 seconds when the disc is paused instead of
58  the usual 3.
59
60+ Misc. bug fixes and code adjustments.
61
62
63Mon Sep 28 18:58:25 EDT 1992
64Fixes from Will Sadkin (wsadkin@bbn.com) to:
65+ set up volume scrollbar color properly on color Suns.
66
67Mon Feb  2 13:58:00 EDT 1991
68Fixes from Will Sadkin (wsadkin@bbn.com) to:
69
70+ fixed prev track button to go back to beginning of current track if more
71  than replayThreshold seconds have played, else go to previous track.
72  (1 resource added for this)
73
74+ fixed timing model to reflect "true" elapsed time
75
76+ fixed volume scrollbar display to be more intuitive, and to set volume to 3/4
77  on start-up (can't currently set to current level, as no query for volume
78  level is provided in the driver), and modified scroll procs to use volbase
79  and volpcent.
80
81+ added true fast-forward & rewind ("repeating" buttons)
82  (2 resources added to control scan skip and pause rate;
83   additional resources for placement and attributes)
84
85+ added title button and edit panel
86  (additional resources for placement and attributes)
87
88+ added program mode, complete with "popup" subpanel program editing,
89  program display, and save functions
90  (command line option (and personalizable resource) added to specify
91   program/title store directory)
92  (additional resources for placement and attributes)
93
94+ changed timer label to toggle button to show time remaining and/or program
95  time remaining (depending on context)
96
97+ made the icon = the cd logo; (NOTE: code does NOT follow conventions for
98  accomodating all window managers; probably just works for twm)
99
100+ added man page
101
102
103Tue Jul 16 19:47:01 PDT 1991
104
105No changes or additions, just added a TODO file.
106
107Mon Jul  1 14:31:17 PDT 1991
108
109Fixes from Dan Trottier (dan@maccs.dcss.McMaster.CA) so that the
110volume control works reasonably.  This adds 2 new resources, volBase
111and volPcent.  Both are floats.  There are also command line options
112-volBase and -volPcent.  Reasonable values (also from Dan) are 187 for
113volBase and 0.267 for volPcent.
114
115Mon Mar 11 18:24:36 PST 1991
116
117The track label is now a toggle button.  If you have trackLabel in
118your .xrdb, .Xdefaults, or whatever file you'll need to change it to
119trackButton.  When you click mouse button 1 on the track it displays
120the highest track and when you release the mouse button it reverts
121back to the current track.  Also moved the specification of the toggle
122buttons' translations from the C code to the application defaults
123file.
124
125Tue Mar  5 17:56:30 PST 1991
126
127The rewind button now works with shuffle; it goes back to the previous
128track that it played.
129
130Mon Mar  4 18:14:22 PST 1991
131
132Fixed a bug in the shuffle code.
133
134Wed Feb 20 20:22:26 PST 1991
135
136Added a volume control scrollbar.  I don't find it very useful since
137visually small movements of it cause large changes in volume; about
138only the upper 10% is useful.  You can directly set the volume with
139the middle mouse button; it "grabs" the scrollbar and moves it to
140wherever the mouse is.  The left and right mouse buttons make the
141scrollbar move in increments each time you click them.  The left mouse
142button bumps it to the left and the right mouse button bumps it to the
143right.  The amount they bump by is determined by where the mouse is in
144the scrollbar; the more to the right the mouse is the more they bump
145it.  (If anybody knows how to make the Athena form widget do a better
146layout please tell me.)
147
148Tue Jan 29 15:44:02 PST 1991
149
150The shuffle button now works.  If shuffle is off it can only be turned
151on if the cd is stopped, not while it is playing or paused.  If
152shuffle is on it can be turned off while the cd is playing but due to
153the way things work it will skip over the next track.  In other words,
154if shuffle is on and it's playing track 3, you then click on the
155shuffle button, when it finishes track 3 it will start playing track
1565.  If anybody has a better pixmap for the shuffle button please send
157it to me.
158
159Thu Jan 24 19:41:43 PST 1991
160
161For those that don't recognize the buttons; first row, from left to
162right: play (right arrow), pause (two vertical bars), stop (square),
163rewind (two left arrows with a bar on the tip), fast forward (two
164right arrows with a bar on the tip), eject (up arrow with a bar
165underneath).  (Fast forward and rewind are misnomers, they only skip
166to the next or previous track.)  The second row, from left to right:
167quit (bolt of lightning), repeat (two arrows chasing each other),
168shuffle (three question marks).  Shuffle currently doesn't do
169anything.
170
171The standard button bitmaps (play, stop, etc.) came from an X program
172for playing SPARC audio files; I think its name may have been xplayer.
173I think I may have modified some of them; made them thicker or adjusted
174them in minor ways.
175
176Mon Jan  7 20:11:09 PST 1991
177
178After you eject a disc and then insert another one, click on the stop
179button to make it read the disc's table of contents.
180
181Fri Jan  4 13:49:28 PST 1991
182
183This is a minimal program to control the CD-ROM drive on a Sun
184workstation for playing audio discs and using the headphone jacks.
185It's not likely to compile on any other OS or anything prior to SunOS
1864.1 due to the ioctl's for the Sun CD-ROM drive.
187