**********************************************************************
* DISCLAIMER OF WARRANTIES:                                          *
*                                                                    *
* The following enclosed code is sample code created by IBM          *
* Corporation.  This sample code is not part of any standard IBM     *
* product and is provided to you solely for the purpose of assisting *
* you in the development of your applications.  The code is provided *
* "AS IS", without warranty of any kind.  IBM shall not be liable    *
* for any damages arising out of your use of the sample code, even   *
* if they have been advised of the possibility of such damages.      *
*                                                                    *
**********************************************************************

VBSTEREO

  DESCRIPTION:
       This application displays a CD player, wave
       player, digital video player and an amplifier.

       CD PLAYER:
                 The user can play, rewind, fast
                 forward, stop, pause track forward and
                 track backward. In addition, there is an
                 eject button which will eject the CD
                 from the player. Users can also select
                 which track they desire be pressing the
                 corresponding track number button and
                 the enter button. There is also a
                 display that shows the track number
                 being played as well as the minutes
                 and seconds that have elapsed in a
                 given track.
       WAVE PLAYER:
                 The user can play, rewind, fast
                 forward, stop, and pause. In addition,
                 there is a load button which show a
                 file dialog for file selection.
                 VBSTEREO.WAV is provided for playing.

       DIGITAL VIDEO PLAYER:
                 The user can play, rewind, fast
                 forward, stop, and pause.
                 In addition, there is a load button
                 which show a file dialog for file
                 selection.
                 VBSTEREO.AVI is provided for playing.

       AMPLIFIER:
                 Allows the user to set the volume, balance,
                 bass, treble, pitch and gain by moving
                 slider controls.



  CONCEPT/FEATURE:
       Illustrates the use of CD player, wave player,
       digital video player, amplifier/mixer, multi cell
       canvas, animated push button, slider and
       custom logic.

  SPECIAL NOTES:
       A CD must be in the player prior to starting this
       application.


  HOW TO RUN THE SAMPLE:

       From within the WorkFrame environment:
                 1. Open the VisualAge for C++ product object.
                 2. Open the Guide to Samples notebook.
                 3. Select "Visual Builder Samples" from the
                    Component drop down list.
                 4. Select "VBStereo" from the List of Samples.
                 5. Click the "Open Project" button to open the
                    project view.
                 6. Click on the RUN button of the project's toolbar.


       From the command line:
                 1. Set the current drive as the drive where you
                    installed the VisualAge C++ samples.
                 2. Set the directory path for the this sample
                    as follows:
                       cd ibmcppw\samples\visbuild\vbstereo
                 3. Type the name of the .EXE file, VBSTEREO.


  HOW TO BUILD THE SAMPLE PROJECT YOURSELF:

       From within the WorkFrame environment:
                 Open the sample project view as described
                 above. In the project window you will see
                 the icons of the files associated with the sample.

                 1. From the project view of this sample, select
                    "Visual" from the Project pulldown.
                 2. Select all the parts "Visual Parts"
                    list and then select "Part->Generate->Part source"
                    from the Menubar.


                 3. Select only the "VBStereo" part in
                    the "Visual Parts" list and then
                    select "Part->Generate->main() for
                    part" from the Menubar.
                 4. Now invoke a Project Build Action.

                 To run the sample project, see How to
                 run the sample project above.

       From the command line:
                 1. Set the current drive as the drive where you
                    installed the VisualAge C++ samples.
                 2. Set the directory path for this sample
                    as follows:
                       cd ibmcppw\samples\visbuild\vbstereo
                    This will allow Visual Builder to automatically
                    load all the Visual Builder "class files"
                    this samples uses.  These files are listed
                    in the file VBLOAD.DAT in this directory.
                 3. Start the Visual Builder Tool by typing the
                    following from the command line:
                       ivb
                 4. Select all the parts in the "Visual
                    Parts" list and then select
                    "Part->Generate->Part source"
                    from the Menubar.


                 5. Select only the "VBStereo" part in
                    the "Visual Parts" list and then
                    select "Part->Generate->main() for
                    part" from the Menubar.
                 6. Build the EXE by executing the MAKE as follows:
                       nmake vbstereo.mak


  HOW TO INSPECT THE VISUAL PARTS USING THE VISUAL BUILDER

       There are five "class files" that make up the
       application, VBCDPLYR.VBB, VBMIXER.VBB,
       VBSTEREO.VBB, VBVIDEO.VBB, and VBWAVE.VBB.
       The application also requires VBMM.VBB and
       VBSAMPLE.VBB which are shipped as part of the
       base product.

              1. Start the Visual Builder Tool --
                 from the command line:
                 - Set the current drive as the drive where you
                   installed the VisualAge C++ samples.
                 - Set the directory path for this sample
                   as follows:
                      cd ibmcppw\samples\visbuild\vbstereo
                 - Type:
                      ivb

                 or from the project view of the
                 sample, select Visual from the Project
                 pulldown.

         2. When the Visual Builder Window appears,
            you may now select any or all of these
            parts from the "Visual Parts" list and then
            select "Part->Open" from the Menubar to
            open these parts for viewing and/or
            editting.


  ADDITIONAL INFORMATION:
       For additional information on this and other samples shipped
       with the VisualAge for C++ product, please see the Guide to Samples
       notebook.

       To access the notebook from Program Manager, open the
       VisualAge for C++ product object, then open the Guide to Samples
       notebook.
