home *** CD-ROM | disk | FTP | other *** search
/ The Developer Connection…ice Driver Kit for OS/2 3 / DEV3-D1.ISO / multimed / cdexpl / read.me < prev   
Encoding:
Text File  |  1993-07-26  |  10.0 KB  |  241 lines
  1. (C) Copyright IBM Corp. 1992, 1993
  2.  
  3. CDEXPLOR PACKAGE - The Compact Disc Digital Audio Explorer for OS/2 2.x
  4.  
  5. by Dave Thomas
  6.  
  7.   support on CDEXPLOR FORUM on IBMPC
  8.  
  9. ---------------------------------------------------------
  10.  
  11. Requirements
  12. ---------------------------------------------------------
  13. This program requires:
  14. - OS/2 2.1 installed with CD ROM support (not tested on 2.0)
  15. - MMPM/2 1.1 installed with CD support (not tested on 1.0)
  16. - An MMPM/2 supported CD player that allows digital audio disc playback
  17.   - See MMPM/2 documentation for supported CD drives
  18. - Output through audio card requires an audio card including:
  19.   - IBM M-Audio ACPA
  20.   - Pro Audio Spectrum 16
  21.   - Soundblaster
  22.   - See MMPM/2 documentation for more information on supported audio cards
  23.  
  24. Installation
  25. ---------------------------------------------------------
  26. From OS2TOOLS:
  27.   If you ONLY want the program executable:
  28.      1. Download the CDEXPL EXEBIN file binary to any directory in your path.
  29.      2. Add it to your favorite desktop folder. Make the working directory
  30.         the same as the one with CDEXPL.EXE
  31.      3. Delete the CDEX_SRC EXEBIN file, you don't need it
  32.  
  33.   If you want the source code (requires IBM C Set/2 and MMPM/2 toolkit):
  34.     1. In a nice empty directory, download the CDEX_SRC EXEBIN file binary.
  35.     2. Run the program CDEX_SRC. It will unpack itself.
  36.     3. Build it using "nmake /f cdexpl.mak"
  37.     4. Erase the CDEX_SRC.EXE file
  38.  
  39. From external tools respositories:
  40.   - Unpack the CDEXPL.ZIP file using "pkunzip cdexpl.zip"
  41.  
  42. Use
  43. ---------------------------------------------------------
  44. Provides a killer user interface to the CD drive attached to your system.
  45.  
  46. Features
  47. ---------------------------------------------------------
  48. - Artist - Disc Title in window caption and minimize icon
  49.   (if user entered track information in template-specified format)
  50.   - See User Track Information below for more on adding user info.
  51.  
  52. - Output to
  53.   - Headphones
  54.   - Any MMPM/2-supported audio card
  55.  
  56. - Customized play order
  57.  
  58.    - "Track repeat" option allows the same song to continuously play.
  59.      "Track repeat" takes precedence over other ordering schemes
  60.  
  61.    - "Disc repeat" option allows uninterrupted play - wrap at end of disc
  62.  
  63.    - "Disc Shuffle" option allows tracks to be played in random order.
  64.      - Shuffles differently every time. Very nifty.
  65.  
  66. - Mute
  67.   - Allows you to mute the sound when your neighbor bashes on your door
  68.     for blasting your Nirvana disc. Really, just ask my neighbors :)
  69.  
  70. - Track Information
  71.   - User track information associated with disc can be input/saved
  72.     The template of user info in the window is an adviseable format.
  73.  
  74.     This template is VERY important if you want support for:
  75.     - Artist - Disc Title in the window caption (titlebar and minimize icon)
  76.     - Current track name in the status area
  77.     Basically the first line of the user track info will end up in the
  78.     window caption and subsequent lines will be associated with each track in
  79.     sequence.
  80.  
  81.     I've allowed for about 64 chars for a disc title line
  82.     plus 64 characters for every track. Hope this is sufficient.
  83.  
  84.     - Here's how you can enter and save your own track info:
  85.  
  86.       1. Type it in the User Track Info window (and drive yourself nuts)
  87.  
  88.        OR (looks longer but is actually much more flexible...)
  89.  
  90.       1. Go to your favorite editor and type in your track info.
  91.          Here is an example of the format that works best:
  92.  
  93.          U2 - Achtung Baby
  94.          1      Zoo station
  95.          2      Even Better than the Real Thing
  96.          3      One
  97.          (etc., etc.)
  98.  
  99.          I keep a text file with all my stuff in it as a backup of CD Explorer's
  100.          profile. You don't NEED a backup, but it is wise if you have lots of
  101.          customized track info.
  102.  
  103.       2. Copy the text to the system clipboard
  104.          (Many editors allow this: try to select the text and hit Ctrl-Insert)
  105.  
  106.       3. Delete the template of stuff I put in the User Info window
  107.          (Select with mouse, then hit the Delete key)
  108.  
  109.       4. Paste the clipboard contents into the User Info window
  110.          (With cursor in window, hit Shift-Insert)
  111.  
  112.       5. Save user info
  113.  
  114.       6. From now on, CD Explorer will automagically recognize the disc
  115.  
  116.   - Disc track information displays each track length and start time
  117.     - Allows random track selection (double-click or select/push seek button)
  118.  
  119. - Disc transport function
  120.  
  121.   - Eject
  122.     - allows you to change discs.
  123.  
  124.   - Reverse to track start / reverse to previous track
  125.     - From inside a track (past 0:00) this will reverse to track start
  126.     - From track start (at 0:00) this will reverse to previous track start
  127.  
  128.   - Stop/Pause
  129.     - Can manually set position in Position field while stopped
  130.       (See "User Cue" below)
  131.  
  132.   - Play
  133.  
  134.   - Forward to next track start
  135.  
  136. - Disc status area:
  137.  
  138.   - Current track (if user entered track information in template-format)
  139.     - See User Track Information above for more on adding user info.
  140.  
  141.   - Track counter is user-modifyable on the fly via spin-button or direct edit
  142.     You can "spin" up or down. You can enter the track you want to go to.
  143.  
  144.   - User Cue: position in track counter with random position setting capability
  145.  
  146.     - This allows you to cue to any location in the track (with second accuracy)
  147.       While the disc is playing, this field is a simple position counter,
  148.       but when you stop the disc, it becomes the awesome "User Cue" field
  149.  
  150.       Use of "User Cue":
  151.  
  152.       1. Stop the disc (if playing)
  153.  
  154.       2. Enter the desired destination time in track (in mm:ss format) in
  155.          the "Position" entry field.
  156.  
  157.       3. Select the cute little "User Cue" button next to the "Position" entry
  158.          (I banged my head for a good and *small* button bitmap. I know,
  159.          the button doen't exactly scream out it's "user cue" function. )
  160.  
  161.       4. When you resume play, it  will resume from the new location
  162.  
  163.       Notice: the cute little "User Cue" button disappears when the disc
  164.               is in playback. User Cue is only available when the disc is
  165.               stopped.
  166.  
  167.   - Remaining in track countdown
  168.  
  169. - Partial function option inhales less system resources
  170.   - disables button animation
  171.   - disables status area and all other function dependant on position notify
  172.  
  173. - Mini window option requires less screen space to interact with CD
  174.  
  175. - Shares device with other programs that use the CD
  176.   (open a bunch of CD Explorers at once -- another boffo CD Explorer feature)
  177.  
  178. Release History (most recent first)
  179. ---------------------------------------------------------
  180. 2.2     7/9/93    - Recompile for MMPM 1.1 (OS/2 2.1)
  181.                   - track info saving working now on OS/2 2.1
  182.                   - fix bug if non digital audio disc (like CD ROM) inserted
  183.  
  184. 2.1     4/22/93   - NOTE: for some bizzare reason, this version ONLY ran on OS/2 2.0
  185.                     - Connect user disc information with the main window:
  186.                     - Disc name and artist in window caption
  187.                     - Current track title added to status area at window bottom
  188.                   **ASSUMES you follow the suggested template
  189.                   - Fix bug in track info (thanks to Sam Detweiler!)
  190.  
  191. 2.0     3/09/93   - Fix format of counter
  192.                   - Track counter in status area is now editable spin button
  193.                   - Position is user-modifyable (only when stopped)
  194.                   - "User Track Info" window replaces Table of contents
  195.                     allows user to add and save track names (or ANY information)
  196.                     - CD Explorer will recognize discs it has saved before
  197.                       and load any user info.
  198.                   - Disc shuffle
  199.                   - Mute
  200.                   - partial function option for better performance
  201.                     (overhaul for better performance)
  202.                   - Overhaul user interface for better use of screen space
  203.                     - full-size at screen yTop will stay on screen
  204.  
  205. 1.3     7/31/92   - Shares CD with other CD apps (supports PASSDEVICE)
  206.                     - all global data now stored in window words
  207.                     - Multiples explorers at different places on same disc!
  208.                   - unlock drive on exit (and other fixes)
  209.                   - change forward trk and Rev Trk buttons to |<< and >>|
  210.                     to indicate going to track boundary.
  211.                   - hi res minimize icon for pretty 8514 display
  212.                   - save 4K on device-independent prod info box bitmap
  213.  
  214. 1.2     7/27/92   - repeat track
  215.                   - time remaining on track added to counter line
  216.                   - merge stop/pause buttons (identical function)
  217.                   - add skip track backward button
  218.                   - seeking foward at disc end wraps to beginning
  219.                   - seeking backward at disc start wraps to end
  220.                   - misc bug fixes
  221.                   - Product Info box for EWS Compuserve
  222.  
  223. 1.1     7/10/92   - General useability enhancements
  224.                   - Works if no audio card installed (headphone-only support)
  225.                   - Much more robust on initialization
  226.                   - Update system menu (remove unused, add new options)
  227.                     - Product information
  228.                     - Wrap Play at end of disc
  229.                   - At disc end, default action is stop and seek back to start
  230.                   - Automatically select 1st item in listbox (no seek err)
  231.                   - Fixed bug in play/stop/eject/new disc prev_stat value
  232.                   - Current track is auto-selected in TOC list
  233.                   - Output flow graphically depicted w/cute bitmaps
  234.                   - New packaging makes use easier for non-programmers
  235.  
  236. 0.5     6/29/92   - Smarter output buttons
  237.                   - Eject function (new disc/no disc operation)
  238.                   - Better error handling
  239.  
  240. 0.1     6/22/92   - Initial release, public demand!
  241.