home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / VSCPPv8.zip / VACPP / IBMCPP / samples / IOC / MMREMOTE / README < prev    next >
Text File  |  1995-06-09  |  7KB  |  133 lines
  1. ************************************************************************
  2. * Multimedia MMREMOTE Sample - Readme file                                     *
  3. *                                                                              *
  4. * COPYRIGHT:                                                                   *
  5. *   IBM Open Class Library                                                     *
  6. *   (C) Copyright International Business Machines Corporation 1992, 1995       *
  7. *   Licensed Material - Program-Property of IBM - All Rights Reserved.         *
  8. *   US Government Users Restricted Rights - Use, duplication, or disclosure    *
  9. *   restricted by GSA ADP Schedule Contract with IBM Corp.                     *
  10. *                                                                              *
  11. * DISCLAIMER OF WARRANTIES:                                                    *
  12. *   The following [enclosed] code is sample code created by IBM                *
  13. *   Corporation.  This sample code is not part of any standard IBM product     *
  14. *   and is provided to you solely for the purpose of assisting you in the      *
  15. *   development of your applications.  The code is provided "AS IS",           *
  16. *   without warranty of any kind.  IBM shall not be liable for any damages     *
  17. *   arising out of your use of the sample code, even if they have been         *
  18. *   advised of the possibility of such damages.                                *
  19. *************************************************************************
  20.  
  21. MULTI-MEDIA REMOTE
  22.  
  23.    DESCRIPTION:
  24.  
  25.         The MMREMOTE sample illustrates many of the multimedia functions.
  26.         It takes the form of the universal remote control, which controls
  27.         the CD player, video player, midi player, and wave player
  28.         devices.  The sample also illustrates the use of multicell
  29.         canvasses, flyover help, and animated pushbuttons.
  30.  
  31.    PROJECT LOCATION:
  32.         Inside the IOC Samples folder (inside the VisualAge C++ Samples
  33.         folder).
  34.  
  35.    SOURCE FILE LOCATION:
  36.         X:\ibmcpp\samples\ioc\mmremote
  37.  
  38.         where X: is the drive you installed the samples and document
  39.         component of VisualAge C++.
  40.  
  41.    HOW TO RUN THE SAMPLE:
  42.  
  43.         FROM WITHIN THE WORKFRAME ENVIRONMENT:
  44.              To run the prebuilt project, open the Samples folder on your
  45.              OS/2 desktop then double-click on the project's icon to open
  46.              the project view of the sample.  Click on the RUN button of
  47.              the project's toolbar.
  48.  
  49.         FROM THE COMMAND LINE:
  50.              Simply type the name of the .EXE file, that is:
  51.  
  52.                  MMREMOTE
  53.  
  54.              If the sample fails to execute or abnormally ends, you can
  55.              get more information about the failure by turning on the
  56.              ICLUI trace.  This is done by setting the environment
  57.              variable ICLUI_TRACE as follows:
  58.  
  59.                    set ICLUI_TRACE=ON
  60.                    set ICLUI_TRACETO=STDERR
  61.  
  62.              The second export controls where the trace information is
  63.              reported.  With tracing turned on, ICLUI exception text will
  64.              be written to a standard error file. For example:
  65.  
  66.                    hello1 >hello1.out 2>&1
  67.  
  68.              The exception data is now in the file hello1.out.
  69.  
  70.    HOW TO BUILD THE SAMPLE PROJECT YOURSELF:
  71.  
  72.         FROM WITHIN THE WORKFRAME ENVIRONMENT:
  73.              Open the Samples folder on your OS/2 desktop then
  74.              double-click on the project's icon to open the project view
  75.              of the sample. In the upper half of the project window you
  76.              will see the icons of the files associated with the sample.
  77.              From the Project pulldown, select Build -> Rebuild All.  To run
  78.              the sample project, see HOW TO RUN THE SAMPLE PROJECT above.
  79.  
  80.         FROM THE COMMAND LINE:
  81.            - A command file is provided to allow rebuilding of the
  82.              WorkFrame projects from the command line.  Simply type:
  83.  
  84.                  BUILD
  85.  
  86.              To run the sample project, see HOW TO RUN THE SAMPLE PROJECT 
  87.              above.
  88.  
  89.            - The sample application can also be built by entering:
  90.                  NMAKE
  91.              with no options while in the directory containing the
  92.              sample application files.  The makefile is named
  93.                  Makefile
  94.              To clean up the files generated from running make, enter:
  95.                  NMAKE CLEAN 
  96.              while in the directory containing the sample program files. 
  97.  
  98.    SOFTWARE/HARDWARE PREREQUISITES:
  99.  
  100.         o   IBM VisualAge C++
  101.         o   OS/2 2.1 or Warp
  102.         o   IBM or compatible 386 and up.
  103.  
  104.    ADDITIONAL INFORMATION:
  105.  
  106.         o   For more information on the creation and use of projects in
  107.             the WorkFrame environment, see the VisualAge C++ for OS/2
  108.             User's Guide.
  109.         o   For more information on the User Interface Classes, see the
  110.             VisualAge C++ for OS/2 Open Class Library User's Guide.
  111.  
  112.         Both books can be found online.  To access an online book, simply
  113.         open the main VisualAge C++ desktop folder, then open the
  114.         Information Folder inside.  To view a book, double-click on that
  115.         book's icon.
  116.  
  117.  
  118.   REQUIRED FILES:                                                            
  119.  -----------------                                                            
  120.    README       - Instructions for using this sample program                  
  121.    mmremote.cpp - Source code for MMREMOTE                                    
  122.    mmremote.hpp - Class definition for MMREMOTE                               
  123.    mmremote.h   - Symbolic definition file                                    
  124.    mmremote.rc  - OS/2 resource file                                          
  125.    mmremote.ico - OS/2 icon resource                                          
  126.    cd.bmp       - OS/2 bitmap resource                                        
  127.    midi.bmp     - OS/2 bitmap resource                                        
  128.    power.bmp    - OS/2 bitmap resource                                        
  129.    video.bmp    - OS/2 bitmap resource                                        
  130.    wave.bmp     - OS/2 bitmap resource                                        
  131.    Makefile     - Make file to build the sample program                       
  132.                                                                               
  133.