home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: Multimed / Multimed.zip / cdexpl.zip / CDEXPLOR.DOC < prev    next >
Text File  |  1995-05-02  |  17KB  |  368 lines
  1. (C) Copyright IBM Corp. 1992, 1995
  2.  
  3. CDEXPLOR PACKAGE - The Compact Disc Digital Audio Explorer for OS/2 3.0
  4.  
  5. by David C. Thomas
  6.  
  7. ---------------------------------------------------------
  8.  
  9. Requirements
  10. ---------------------------------------------------------
  11. This program requires:
  12. - OS/2 2.x installed with CD ROM support
  13. - MMPM/2 1.x installed with CD support
  14. - An MMPM/2 supported CD drive that allows digital audio disc playback
  15.   - See MMPM/2 documentation for supported CD drives
  16. - Output through audio card requires an MMPM-supported audio card
  17.   - Some supported audio and SCSI cards cannot handle CD data rates
  18.  
  19. Installation
  20. ---------------------------------------------------------
  21.   - Unpack the CDEXPL.ZIP file using "pkunzip cdexpl.zip"
  22.  
  23.  
  24. Note users upgrading from pre-2.4 release:
  25. ------------------------------------------
  26.     If you are upgrading from 2.3 or below - convert
  27.     your old CDEXPLOR.INI file with CDEXCONV.EXE.
  28.     Usage: change to cdexpl working dir.
  29.       cdexconv <-t>
  30.       where -t will convert any tab characters found to spaces (suggested).
  31.  
  32.     It creates the new CDEX_NEW.INI and copies the old to CDEXPINI.BAK
  33.     You will have to copy CDEX_NEW.INI over CDEXPLOR.INI when done.
  34.  
  35. Use
  36. ---------------------------------------------------------
  37. Provides a killer user interface to the CD drive attached to your system.
  38. Tests neighbor's patience with your loud music.
  39.  
  40. Features
  41. ---------------------------------------------------------
  42. - Artist - Disc Title in window caption and minimize icon
  43.   (if user entered track information in template-specified format)
  44.   - See User Track Information below for more on adding user info.
  45.  
  46. - "Output to"
  47.   - "Front jack" - Front panel audio jack of CD Drive
  48.   - "Audio card" - MMPM/2-supported audio card which can handle CD data
  49.     (not 8 bit) connected to CD drive which support streaming DA data.  Note
  50.     just because MMPM supports a certain CD drive or audio card, that the
  51.     combination of these two is not necessarily going to work.
  52.  
  53. - "Playback options"
  54.  
  55.    - Repeating segments (looping)
  56.      You can repeat sections of tracks.  Start point must be before end point.
  57.      The entire segment must be on same track.  Repeat segment (loopy button)
  58.      is only enabled once start and stop points are selected.
  59.      - "Mark seg repeat in" marks the position on the disc where you want
  60.         the repeated segment to start
  61.         Control text changes to start point when selected.
  62.      - "Mark seg repeat out" marks the position on the disc where you want
  63.         the repeated segment to end
  64.         Control text changes to stop point when selected.
  65.      - Repeat segment (loopy button) starts or restarts a repeat loop.
  66.      To stop a repeating segment do any of the following:
  67.        - deselect either the "From" or "To" points,
  68.        - push stop, fwd track, fast forward, or select any other track
  69.      Segments are not saved with "Save Settings"
  70.  
  71.  
  72.    - "Repeat Track" option allows the same song to continuously play.
  73.      "Repeat Track" takes precedence over other ordering schemes
  74.      Saved with "Save Settings".
  75.  
  76.    - "Repeat Disc" option allows uninterrupted play - wrap at end of disc
  77.      Saved with "Save Settings".
  78.  
  79.    - "Shuffle Tracks" option allows tracks to be played in random order.
  80.      - If media is stopped, it assumes you think it's okay to seek to the
  81.        start of the first track in the shuffle order.
  82.      - Shuffles differently every time. Very nifty.
  83.      Saved with "Save Settings".
  84.  
  85. - Mute
  86.   - Allows you to mute the sound when your neighbor bashes on your door
  87.     for blasting your "Pearl Jam" disc. Really, just ask my neighbors :)
  88.     Takes precedence over volume settings.
  89.     Saved with "Save Settings".
  90.   - The text on this button represents the action taken when it is pressed.
  91.     - If the button says "Mute", CD Explorer will mute when you press it;
  92.     - If the button says "Sound", CD Explorer will turn sound on when you
  93.       press it;
  94.  
  95. - Volume
  96.   - Allows you to relent to your neighbor's wishes and turn it down
  97.     without having to grope for your speakers. Slider allows 10 increments.
  98.     Saved with "Save Settings".
  99.  
  100. - Disc transport function
  101.   - Select these functions with the mouse or by tabbing and pressing spacebar.
  102.  
  103.   - Eject
  104.     - Allows you to eject the disc.
  105.  
  106.   - Reverse to track start / reverse to previous track
  107.     - From inside a track (past 0:00) this will reverse to track start
  108.     - From track start (at 0:00) this will reverse to previous track start
  109.  
  110.   - Stop
  111.     - Can manually set position in Position field while stopped
  112.       (See "User Cue" below)
  113.  
  114.   - Play
  115.     Neato feature - if you select "Resume at Restart", play will resume at
  116.     the same point you left off on if the next time you run CD Explorer, the
  117.     same disc is installed.
  118.  
  119.   - Fast Forward - well, maybe it's not FAST, but since everybody has asked
  120.     for it, there you go...
  121.     - This works in two ways: jump ahead, and scan ahead
  122.       1. Jump Ahead: A simple button click will push you forward 5 sec.
  123.       2. Scan Ahead: Press and hold FFwd and it will
  124.            skip ahead 5 sec,
  125.            play 1/2 sec, ...
  126.          until you release the button.
  127.     - Note: ffwd will not take you across track boundaries. If you ffwd
  128.       at the end of a track, it will loop to the beginning of the track.
  129.  
  130.   - Forward to next track start
  131.  
  132. - Disc status area:
  133.  
  134.   - Current track name (if user entered track information in template-format)
  135.     This field only show up once you have edited it from the Track Information
  136.     Window (the pencil button).
  137.     - Change names in the entry field, pull down combo box to select new track.
  138.       Text is saved automatically at disc change and program exit.
  139.       Notes on changing text in this combo-box:
  140.       - Text changes in the entry field are registered when you pull-down
  141.         the combo box, not when they are typed in the entry field.
  142.         If you change text in this field, pull down the list box to get it to
  143.         "stick"
  144.       - If you scroll through the list and don't select an item, the text of
  145.         the active list item gets put into the entry field. This means the
  146.         next time you pull down the list box, the current track name will
  147.         get changed to whatever is in the entry field. The moral of the story:
  148.         don't scroll through the list without selecting a track to seek to.
  149.     - See Track Information below for more on adding user track info.
  150.     - Changes are automatically saved on disc change and program exit in
  151.       CDEXPLOR.INI.
  152.  
  153.     - Track Information (The Pencil Button)
  154.       - User track information associated with disc can be edited.
  155.       - Changes are automatically saved on program exit in CDEXPLOR.INI.
  156.         The template of user info in the window is an advisable format.
  157.  
  158.         This template is VERY important if you want support for:
  159.         - Artist - Disc Title in the window caption (titlebar and minimize icon)
  160.         - Current track name in the status area
  161.         Basically the first line of the user track info will end up in the
  162.         window caption and subsequent lines will be associated with each track
  163.         in sequence.
  164.  
  165.         I've allowed for about 64 chars for a disc title line
  166.         plus 64 characters for every track. Hope this is sufficient.
  167.  
  168.         - Here's how you can enter and save your own track info:
  169.  
  170.           1. Type it in the User Track Info window (and drive yourself nuts)
  171.  
  172.            OR (looks longer but is actually much more flexible...)
  173.  
  174.           1. Go to your favorite editor and type in your track info.
  175.              Here is an example of the format that works best:
  176.  
  177.              U2 - Achtung Baby
  178.              Zoo station
  179.              Even Better than the Real Thing
  180.              One
  181.              (etc., etc.)
  182.  
  183.              I keep a text file with all my stuff in it as a backup of
  184.              CD Explorer's profile. You don't NEED a backup,
  185.              but it is wise if you have lots of customized track info.
  186.  
  187.              Copy the text to the system clipboard
  188.              (Many editors allow this: try to select the text and hit
  189.              Ctrl-Insert)
  190.  
  191.              Delete the template of stuff I put in the User Info window
  192.              (Select with mouse, then hit the Delete key)
  193.  
  194.              Paste the clipboard contents into the User Info window
  195.              (With cursor in window, hit Shift-Insert)
  196.  
  197.           2. Select OK, info is saved in CDEXPLOR.INI
  198.  
  199.           7. From now on, CD Explorer will automagically recognize the disc
  200.  
  201.       - Disc track information displays total disc length and
  202.         each track length and start time.
  203.         - Allows random track selection from listbox
  204.           (double-click or select/push seek button)
  205.         Note that the times I get from querying the disc often don't match
  206.         what the artist has published. Usually, this is no more that a second
  207.         or so off, but often it can be a more dramatic difference. For
  208.         example, Tool's "Undertow" disc is listed as only having 10 tracks,
  209.         but actually has 59 tracks of 1 second silence between tracks 9
  210.         and 10. How cute that this final track actually turns out to be
  211.         track number 69.
  212.         Nevertheless, be warned that artists like to play games some times.
  213.  
  214.   - Track counter is user-modifyable on the fly via spin-button or direct edit
  215.     You can "spin" up or down. You can enter the track you want to go to.
  216.  
  217.   - User Cue: position in track counter with random position setting capability
  218.  
  219.     - This allows you to cue to any location in the track (with second accuracy)
  220.       While the disc is playing, this field is a simple position counter,
  221.       but when you stop the disc, it becomes the awesome "User Cue" field
  222.  
  223.       Use of "User Cue":
  224.  
  225.       1. Stop the disc (if playing)
  226.  
  227.       2. Enter the desired destination time in track (in mm:ss format) in
  228.          the "Position" entry field.
  229.  
  230.       3. Select the cute little "User Cue" button next to the "Position" entry
  231.          (I banged my head for a good and *small* button bitmap. I know,
  232.          the button doesn't exactly scream out its "user cue" function. )
  233.  
  234.       4. When you resume play, it  will resume from the new location
  235.  
  236.       Notice: the cute little "User Cue" button disappears when the disc
  237.               is in playback. User Cue is only available when the disc is
  238.               stopped.
  239.  
  240.   - Remaining in track countdown
  241.  
  242. - Partial function option inhales less system resources (but not much)
  243.   - disables button animation
  244.   - disables status area and all other function dependent on position notify
  245.   - Run Pulse.Exe, you'll see CD Explorer (while playing to front jack)
  246.     consumes next to nothing. Any increase while playing to audio card is
  247.     MMPM streaming digital data between CD stream handler and audio stream
  248.     handler.
  249.  
  250. - Mini window option requires less screen space to interact with CD
  251.   - Full size resets to optimum full size
  252.   - available from the Toggle Size button under the minimize button, or
  253.     from the system menu.
  254.   - Window is also sizeable, yet the only 2 sizes that are preset
  255.     are mini and full size.
  256.     (I banged my head here also for a good and *small* button bitmap)
  257.  
  258. - Save Settings: saves your control settings, window size and position
  259.  
  260. - Resume on Restart: saves track, position, and playback status on exit.
  261.   Resumes only if the same disc is inserted the next time it is restarted,
  262.  
  263. - Shares device with other programs that use the CD
  264.   (open a bunch of CD Explorers at once -- another boffo CD Explorer feature)
  265.  
  266. Known Problems: of course, none of them are MY problem! :)
  267. ---------------------------------------------------------
  268. 1. Problem:
  269.      Some GUI settings default to incorrect settings (volume, output)
  270.    Solution:
  271.      Save settings (from system menu) and restart will fix problem
  272. 2. Problem:
  273.      On some 486 systems output to audio card: apparent hang
  274.      when you push play.
  275.    Reason:
  276.      CD Explorer exposes a race condition in MMPM that
  277.      is not exposed by MciSendString-based CD players. CD Explorer uses
  278.      MciSendCommand.
  279.    Solution:
  280.      Manually eject the CD to release the hang. Restart CD Explorer, and
  281.      output to front jack until a fix is released (by OS/2).
  282. 3. Problem:
  283.      Some audio cards which cannot support CD quality audio streams report
  284.      they can, thereby causing CD Explorer to enable "Output to Audio Card".
  285.      Upon selecting "Audio card", audio stops.
  286.      For example, the Media Vision PAS 16 operating in 8 bit mode may expose
  287.      this problem.
  288.    Reason:
  289.      Bug in either MMPM or, more likely, the audio device driver. The
  290.      MCI_OPEN of MCI_DEVTYPE_AUDIO_AMPMIX in CD quality mode/rate/channels
  291.      should fail, but does not in some cases.
  292.    Solution:
  293.      Once you notice your card may not support CD Audio, do not select
  294.      "Audio card". Keep output only to "Front jack".
  295.  
  296.  
  297. Release History (most recent first)
  298. ---------------------------------------------------------
  299. 2.5     5/2/95    - Save INI info on system shutdown
  300.                   - AutoCD tweak (play button inactive until ready)
  301.                   - Fix Trap if disc ejected while in track info dialog, "OK"
  302.                     Thanks, M.K.
  303.                   - Added size borders to main info window
  304.                   - Recompiled for OS/2 3.0
  305.                   - Fixed mini window disappearance on Warp
  306.  
  307. 2.4     6/20/94   - Add "Resume on Restart" - saves track, position, and
  308.                     playback status on exit. Used only if same disc on restart.
  309.                   - Fixed the Front jack/Audio card digital transfer problem
  310.                     Now knows better how to sense proper config. Thanks G.L.
  311.                   - Add Repeat track segment: Mark start, stop, repeat button
  312.                   - Add Toggle Size button under minimize button. Toggles
  313.                     from full-size to mini window.
  314.                   - Replace current track static field with drop-down combo box
  315.                     - select/change track info from here or from dialog
  316.                     - change format of CDEXPLOR.INI - use CDEXCONV to convert
  317.                     - stopped parsing tabs into " - ". More WYTIWYG (what
  318.                       you type is what you get) now.
  319.                   - Volume slider (volume saved when you "Save Settings")
  320.                   - Replace "Track Info" button with cute pencil button
  321.                   - Add fast forward button
  322.                   - Add "Total Disc Length" in Track Info Window
  323.                   - Fixed track repeat and shuffle bug - no longer plays first
  324.                     chunk of next track.
  325.                   - fixed idiotic flickering of play button
  326.                   - improved performance by doing much less during pos notifies
  327.  
  328. 2.3     8/9/93    - Add "Save Settings" - saves user selections, window pos
  329.                   - Fix funkiness with Mute/Sound button visibility
  330.                   - more legible mini icon
  331.  
  332. 2.2     7/9/93    - Recompile for MMPM 1.1 (OS/2 2.1)
  333.                   - track info saving working now on OS/2 2.1
  334.                   - fix bug if non digital audio disc (like CD ROM) inserted
  335.  
  336. 2.1     4/22/93   - NOTE: for some bizarre reason, this version ONLY ran on
  337.                     OS/2 2.0
  338.                     - Connect user disc information with the main window:
  339.                       - Disc name and artist in window caption
  340.                       - Current track title added to status area at
  341.                         window bottom
  342.                   **ASSUMES you follow the suggested template
  343.                   - Fix bug in track info
  344.  
  345. 2.0     3/09/93   - Fix format of counter
  346.                   - Track counter in status area is now editable spin button
  347.                   - Position is user-modifyable (only when stopped)
  348.                   - "User Track Info" window replaces Table of contents
  349.                     allows user to add and save track names (or ANY information)
  350.                     - CD Explorer will recognize discs it has saved before
  351.                       and load any user info.
  352.                   - Add Disc shuffle
  353.                   - Add Mute
  354.                   - partial function option for better performance
  355.                     (overhaul for better performance)
  356.                   - Overhaul user interface for better use of screen space
  357.                     - full-size at screen yTop will stay on screen
  358.  
  359. 1.0     7/31/92   - First EXTERNAL release
  360.                   - Shares CD with other CD apps (supports PASSDEVICE)
  361.                     - all global data now stored in window words
  362.                     - Multiples explorers at different places on same disc!
  363.                   - unlock drive on exit (and other fixes)
  364.                   - change forward trk and Rev Trk buttons to |<< and >>|
  365.                     to indicate going to track boundary.
  366.                   - hi res minimize icon for pretty 8514 display
  367.                   - save 4K on device-independent prod info box bitmap
  368.