PROGRAM CDPlay FUNCTION A small CD Player designed for the Xetec CDx Software. The program uses a small window that opens on the Workbench screen. Smaller and handier than the player that is supplied with the Xetec Software SOURCE Written SAS/C version 6.3 V1.0 and V1.1 were written in assembler using Macro68 AUTHOR Nic Wilson Nic Wilson Software P.O. Box 1164 TOOWOOMBA QUEENSLAND 4350 Australia EMAIL cbmehq!cbmaus!cbmozq!wilson!nicw@cbmvax.commodore.com OR nicw@wilson.adsp.sub.org TELEPHONE +61 76 358539 After Hours Australian Time COPYRIGHT This program, source code & document files are Copyright © Nic Wilson Software 1993. DISTRIBUTION Shareware, suggested donation is up to you. CHANGES V2.01 Added the ability to "program" the songs you would like to hear in the order of your choice. See the Program function under gadgets for more info. Added the ability to change the current CD unit " on the fly ". This is useful for those who have more than one CD drive. See MENUS below. Changed the name of the "Songs" gadget to PGM, short for PROGRAM. The direct window was opening 8 pixels to the left of the main window. This meant that if the main window was at the extreme left of the screen, the direct window would not open. This is now corrected. When the program is closed, the window co-ordinates are saved to RAM:. If the file still exist when the program is lauched again, it will open its window in the previous position. The file in ram: could be saved to hard disk and placed in ram: by the startup- sequence so the window always opens in your prefered position the first time it is launched. The current CD Unit is also saved to this file. The Songs direct access window is now prevented from opening if there is not a disk in the drive. If a CD with more than 30 tracks was played the shuffle array would overflow, this has been corrected. V2.00 Complete re write in SAS/C, yes folks you did read correctly, I am now writing programs in SAS/C 6.3 V1.1 The Volume Control now changes as you adjust it rather than when you let go of the gadget. V1.0 Initial release ***** NOTE ***************************************** The latest CDx.device driver I am using (1.94) has a bug in it that returns the wrong number of tracks of a CD on certain CD drivers. This is not a bug in this program, and CDPlay will work correctly when the device driver is fixed by Xetec. I have reported this bug to them. **************************************************** REQUIREMENTS Any Amiga using a CDRom and Xetec CDx software. MENUS The CD unit number can be changed from here. All the CD units on the CDx.device will be available and the rest will be ghosted. This allows you to change CD "on the fly". the current CD unit will be shown in the top left of the window below the gadgets. The unit number shown is not the SCSI-BUS unit number but the CDx install unit number. As the CDx_Install program supports up to 8 drives, this program supports the same amount. When the program exits the current CD unit is saved to a file in RAM: along with the window co-ordinates, so when you return the last unit you used will be the current unit. GADGETS Launch the program and choose a gadget. Usage is very obvious as I have tried to make all the gadgets behave like the buttons on the average CD player. One gadget worth mentioning is the close gadget on the window. This closes the program as one would expect, but it does not stop the disk from playing. This allows you to start a disk but not leave the window lying around. If you launch the program while the disk is playing it interrogates the drive while playing and updates the window to reflect the current mode, track and time etc. Stop - Stops the disk that is currently playing. Play - Starts a CDDA disk playing from the beginning or from the displayed track if you have used the >>| or |<< track skip gadgets. Pause - Toggles between pausing and un-pausing. Time - Toggles the time display between elapsed track time, elapsed disk time or time remaining. Eject - If supported by your drive, will eject the disk. << - skips audibly backwards through the disk a few seconds at a time or continuosly if held down. >> - skips audibly forwards through the disk a few seconds at a time or continuosly if held down. |<< - If a disk is playing it will skip to the previous track, or if a disk is stopped it will decrease the chosen track display by one if it is greater than 1. >>| - If a disk is playing it will skip to the next track, or if a disk is stopped it will increase the chosen track display by one. PGM - Opens a window and shows up to 30 gadgets, allowing direct access to any song or to. program songs in a certain order. If you click on of the numbered gadgets, the window will close, and play will commence at that track, and continue to the end of the disk. Program Below the 30 gadgets in the window is a gadget called "Program", if this is clicked once prior to choosing any of the other 30 gadgets, the function will go into program mode. You may then click up to 30 songs of your choice, in the order of you choice. Once you click one, it will change colour from colour 2 to colour 3, as a reminder that you have already chosen it. You may choose the same one again if you so desire. When you have finished choosing, click the CLOSE gadget on the window and playing will commence. Play will commence automatically if you choose 30 selections as this is maximum allowed. Vol If supported by your drive will change the volume of the right and left channels. Bal If volume is supported by your drive, this will change the balance of the two channels, When the balance is centered a '>|<' will be shown in the window, or if off centre the display will change to either '>>>' or '<<<' depending on which direction off centre the conrol is. Intro This will play the first ten seconds of every track on the disk. If you quit the program this function will abort. Shuffle This will play the entire disk in a totally random order, that will be different every time you play it. This action will be cancelled by, stop, intro, eject and the songs gadgets. If you quit the program this function will abort. IMPROVEMENTS/BUGS All suggestions will be carefully considered. All bugs will be fixed A.S.A.P.