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