home *** CD-ROM | disk | FTP | other *** search
/ World of A1200 / World_Of_A1200.iso / programs / disk / cdrom / cdplay / cdplay.doc < prev    next >
Text File  |  1995-02-27  |  8KB  |  192 lines
  1.  
  2. PROGRAM  
  3.                 CDPlay
  4.                                 
  5. FUNCTION        A small CD Player designed for the Xetec CDx Software.  
  6.                      The program uses a small window that opens on the 
  7.                      Workbench screen.  Smaller and handier than the player 
  8.                   that is supplied with the Xetec Software
  9.         
  10. SOURCE          Written SAS/C version 6.3
  11.                      V1.0 and V1.1 were written in assembler using Macro68
  12.  
  13. AUTHOR          Nic Wilson
  14.                 Nic Wilson Software
  15.                 P.O. Box 1164
  16.                 TOOWOOMBA QUEENSLAND 4350
  17.                 Australia
  18.                                 
  19.                 EMAIL cbmehq!cbmaus!cbmozq!wilson!nicw@cbmvax.commodore.com
  20.                 OR    nicw@wilson.adsp.sub.org
  21.                  
  22.                 TELEPHONE +61 76 358539 After Hours Australian Time
  23.                             
  24. COPYRIGHT       This program, source code & document files are Copyright
  25.                 © Nic Wilson Software 1993.
  26.                 
  27. DISTRIBUTION    Shareware, suggested donation is up to you.
  28.  
  29. CHANGES
  30.         
  31. V2.01                 Added the ability to "program" the songs you would
  32.                      like to hear in the order of your choice.  See the
  33.                      Program function under gadgets for more info.
  34.                      
  35.                      Added the ability to change the current CD unit 
  36.                      " on the fly ".  This is useful for those who have 
  37.                      more than one CD drive.   See MENUS below.
  38.                      
  39.                      Changed the name of the "Songs" gadget to PGM, short
  40.                      for PROGRAM.
  41.                      
  42.                      The direct window was opening 8 pixels to the left
  43.                      of the main window.  This meant that if the main
  44.                      window was at the extreme left of the screen, the
  45.                      direct window would not open.  This is now corrected.
  46.                      
  47.                      When the program is closed, the window co-ordinates
  48.                      are saved to RAM:.  If the file still exist when
  49.                      the program is lauched again, it will open its window
  50.                      in the previous position.  The file in ram: could be
  51.                      saved to hard disk and placed in ram: by the startup-
  52.                      sequence so the window always opens in your prefered
  53.                      position the first time it is launched.  The current
  54.                      CD Unit is also saved to this file.
  55.                      
  56.                      The Songs direct access window is now prevented from
  57.                      opening if there is not a disk in the drive.
  58.                      
  59.                      If a CD with more than 30 tracks was played the
  60.                      shuffle array would overflow, this has been corrected.
  61.  
  62. V2.00                 Complete re write in SAS/C, yes folks you did read
  63.                     correctly, I am now writing programs in SAS/C 6.3
  64.  
  65. V1.1            The Volume Control now changes as you adjust it
  66.                   rather than when you let go of the gadget.
  67.                   
  68. V1.0            Initial release 
  69.  
  70.                      ***** NOTE *****************************************
  71.                      The latest CDx.device driver I am using (1.94) has
  72.                      a bug in it that returns the wrong number of tracks
  73.                      of a CD on certain CD drivers.  This is not a bug in 
  74.                      this program, and CDPlay will work correctly when the
  75.                      device driver is fixed by Xetec.  I have reported this
  76.                      bug to them.
  77.                      ****************************************************
  78.  
  79. REQUIREMENTS    Any Amiga using a CDRom and Xetec CDx software.
  80.                 
  81. MENUS                 The CD unit number can be changed from here.  All                 
  82.                      the CD units on the CDx.device will be available and
  83.                      the rest will be ghosted.  This allows you to change
  84.                      CD "on the fly".  the current CD unit will be shown
  85.                      in the top left of the window below the gadgets.
  86.                      The unit number shown is not the SCSI-BUS unit number
  87.                      but the CDx install unit number.  As the CDx_Install
  88.                      program supports up to 8 drives, this program supports
  89.                      the same amount.
  90.                      
  91.                      When the program exits the current CD unit is saved
  92.                      to a file in RAM: along with the window co-ordinates,
  93.                      so when you return the last unit you used will be the
  94.                      current unit.
  95.                 
  96. GADGETS         Launch the program and choose a gadget.  Usage is very 
  97.                     obvious as I have tried to make all the gadgets behave
  98.                    like the buttons on the average CD player.  One gadget
  99.                    worth mentioning is the close gadget on the window.  
  100.                    This closes the program as one would expect, but it
  101.                    does not stop the disk from playing.  This allows you
  102.                    to start a disk but not leave the window lying around.
  103.                    If you launch the program while the disk is playing
  104.                    it interrogates the drive while playing and updates
  105.                    the window to reflect the current mode, track and
  106.                    time etc.
  107.                    
  108.                    
  109.                    Stop  -  Stops the disk that is currently playing.
  110.                    
  111.                    Play  -  Starts a CDDA disk playing from the beginning
  112.                                or from the displayed track if you have used
  113.                                the >>| or |<< track skip gadgets.
  114.                                
  115.                    Pause -  Toggles between pausing and un-pausing.            
  116.                    
  117.                    Time  -  Toggles the time display between elapsed track
  118.                             time, elapsed disk time or time remaining.
  119.                             
  120.                    Eject -  If supported by your drive, will eject the         
  121.                             disk.
  122.                             
  123.                    <<    -  skips audibly backwards through the disk         
  124.                             a few seconds at a time or continuosly if
  125.                             held down.
  126.                             
  127.                    >>    -  skips audibly forwards through the disk         
  128.                             a few seconds at a time or continuosly if
  129.                             held down.
  130.                             
  131.                    |<<   -  If a disk is playing it will skip to the         
  132.                             previous track, or if a disk is stopped it
  133.                             will decrease the chosen track display by
  134.                             one if it is greater than 1.
  135.                             
  136.                    >>|   -  If a disk is playing it will skip to the         
  137.                             next track, or if a disk is stopped it
  138.                             will increase the chosen track display by
  139.                             one.
  140.                             
  141.                    PGM   -  Opens a window and shows up to 30 gadgets,         
  142.                             allowing direct access to any song or to.
  143.                               program songs in a certain order. If you
  144.                                  click on of the numbered gadgets, the window 
  145.                                  will close, and play will commence at that  
  146.                                  track, and continue to the end of the disk.  
  147.                                  
  148.                    Program  Below the 30 gadgets in the window is a gadget 
  149.                                  called "Program", if this is clicked once
  150.                                 prior to choosing any of the other 30 gadgets,
  151.                                 the function will go into program mode.  You
  152.                                 may then click up to 30 songs of your choice,
  153.                                 in the order of you choice.  Once you click one,
  154.                                 it will change colour from colour 2 to colour 3,
  155.                                 as a reminder that you have already chosen it.  
  156.                                  You may choose the same one again if you so desire.
  157.                                 When you have finished choosing, click the CLOSE 
  158.                                  gadget on the window and playing will commence.  
  159.                                  Play will commence automatically if you choose 30
  160.                                  selections as this is maximum allowed.
  161.                    
  162.                    Vol      If supported by your drive will change         
  163.                             the volume of the right and left channels.
  164.                    Bal      If volume is supported by your drive, this will
  165.                                  change the balance of the two channels, When 
  166.                                  the balance is centered a '>|<' will be
  167.                                  shown in the window, or if off centre the
  168.                                  display will change to either '>>>' or '<<<'
  169.                                  depending on which direction off centre
  170.                                  the conrol is.
  171.                                  
  172.                     Intro         This will play the first ten seconds of                                 
  173.                                  every track on the disk.  If you quit the
  174.                                  program this function will abort. 
  175.                                  
  176.                     Shuffle   This will play the entire disk in a totally             
  177.                                  random order, that will be different every
  178.                                  time you play it.  This action will be                                 
  179.                                  cancelled by, stop, intro, eject and the
  180.                                  songs gadgets.  If you quit the program this 
  181.                                  function will abort.
  182.                             
  183. IMPROVEMENTS/BUGS
  184.  
  185.                 All suggestions will be carefully considered.
  186.                 All bugs will be fixed A.S.A.P.
  187.                 
  188.                
  189.                                  
  190.                 
  191.                 
  192.