home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / VSCPPv8.zip / VACPP / IBMCPP / samples / IOC / 2D-DRAW / README < prev   
Text File  |  1995-06-09  |  7KB  |  234 lines
  1. ***************************************************************************
  2. * FILE NAME: readme            (2d Draw 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. 2D-DRAW
  17.  
  18.    DESCRIPTION:
  19.  
  20.         The 2D Graphics Sample is a graphics drawing tool.  The tool
  21.         draws lines, free hand, rectangles, ellipses, polylines,
  22.         polygons, arcs, pies, chords, text, and bitmaps.  In addition, it
  23.         demonstrates various background colors, pen colors, fill colors,
  24.         pen patterns, fill patterns, pen types, pen widths, fonts, and
  25.         drawing operations such as fill and frame.  Classes used include
  26.         IGLine, IGRectangle, IGEllipse, IGPolyline, IGPolygon, IGArc,
  27.         IGPie, IGChord, IGString, IGBitmap, IGraphicBundle,
  28.         IGraphicGContext, IColor, IGList, IFontDialog, IFileDialog,
  29.         IResizeHandler, IFlyOverHelpHandler, and IToolBar.
  30.  
  31.    CONCEPT/FEATURE:
  32.          Sample program for demonstrating drawing graphic objects in the
  33.         IBM User Interface Class Library.
  34.  
  35.    PROJECT LOCATION:
  36.         Inside the IOC Samples folder (inside the VisualAge C++ Samples
  37.         folder). 
  38.  
  39.    SOURCE FILE LOCATION:
  40.         X:\ibmcpp\samples\ioc\2d-draw
  41.  
  42.         where X: is the drive you installed the samples and document
  43.         component of VisualAge C++.
  44.  
  45.    HOW TO RUN THE SAMPLE:
  46.  
  47.         FROM WITHIN THE WORKFRAME ENVIRONMENT:
  48.              To run the prebuilt project, open the Samples folder on your
  49.              OS/2 desktop then double-click on the project's icon to open
  50.              the project view of the sample.  Click on the RUN button of
  51.              the project's toolbar.
  52.  
  53.         FROM THE COMMAND LINE:
  54.              Simply type the name of the .EXE file, that is:
  55.  
  56.                  2D-DRAW
  57.  
  58.              If the sample fails to execute or abnormally ends, you can
  59.              get more information about the failure by turning on the
  60.              ICLUI trace.  This is done by setting the environment
  61.              variable ICLUI_TRACE as follows:
  62.  
  63.                    set ICLUI_TRACE=ON
  64.                    set ICLUI_TRACETO=STDERR
  65.  
  66.              The second export controls where the trace information is
  67.              reported.  With tracing turned on, ICLUI exception text will
  68.              be written to a standard error file. For example:
  69.  
  70.                    hello1 >hello1.out 2>&1
  71.  
  72.              The exception data is now in the file hello1.out.
  73.  
  74.    HOW TO BUILD THE SAMPLE PROJECT YOURSELF:
  75.  
  76.         FROM WITHIN THE WORKFRAME ENVIRONMENT:
  77.              Open the Samples folder on your OS/2 desktop then
  78.              double-click on the project's icon to open the project view
  79.              of the sample. In the upper half of the project window you
  80.              will see the icons of the files associated with the sample.
  81.              From the Project pulldown, select Build -> Rebuild All. To run
  82.              the sample project, see HOW TO RUN THE SAMPLE PROJECT above.
  83.  
  84.         FROM THE COMMAND LINE:
  85.            - A command file is provided to allow rebuilding of the
  86.              WorkFrame projects from the command line.  Simply type:
  87.  
  88.                  BUILD
  89.  
  90.              To run the sample project, see HOW TO RUN THE SAMPLE PROJECT 
  91.              above.
  92.  
  93.            - The sample application can also be built by entering:
  94.                  NMAKE
  95.              with no options while in the directory containing the
  96.              sample application files.  The makefile is named
  97.                  Makefile
  98.              To clean up the files generated from running make, enter:
  99.                  NMAKE CLEAN 
  100.              while in the directory containing the sample program files. 
  101.  
  102.    SOFTWARE/HARDWARE PREREQUISITES:
  103.  
  104.         o   IBM VisualAge C++
  105.         o   OS/2 2.1 or Warp
  106.         o   IBM or compatible 386 and up.
  107.  
  108.    ADDITIONAL INFORMATION:
  109.  
  110.         o   For more information on the creation and use of projects in
  111.             the WorkFrame environment, see the VisualAge C++ for OS/2
  112.             User's Guide.
  113.         o   For more information on the User Interface Classes, see the
  114.             VisualAge C++ for OS/2 Open Class Library User's Guide.
  115.  
  116.         Both books can be found online.  To access an online book, simply
  117.         open the main VisualAge C++ desktop folder, then open the
  118.         Information Folder inside.  To view a book, double-click on that
  119.         book's icon.
  120.  
  121.  
  122.  
  123.  
  124.    REQUIRED FILES - 2D-DRAW:
  125.  
  126.    README
  127.         Instructions for using this sample program
  128.  
  129.    2D-DRAW.EXE
  130.         sample's executable
  131.  
  132.    BUILD.CMD
  133.         command file to build in project form from command line
  134.  
  135.    2D-DRAW.CPP
  136.         Source code for main() and drawing logic
  137.  
  138.    2D-MENU.CPP
  139.         Source code for drawing the menu items
  140.  
  141.    2D-DRAW.HPP
  142.         Class header file for main window and drawing area and related
  143.         handlers.
  144.  
  145.    2D-DRAW.H
  146.         Symbolic definition file
  147.  
  148.    2D-DRAW.RC
  149.         OS/2 PM resource file
  150.  
  151.    2D-DRAW.ICO
  152.         icon file
  153.  
  154.    MAKEFILE
  155.         make file to build the sample program on OS/2
  156.  
  157.    Bitmaps for tool bar buttons:
  158.  
  159.    2D_ARC.BMP
  160.         arc
  161.  
  162.    2D_BMP.BMP
  163.         bitmap
  164.  
  165.    2D_CHD.BMP
  166.         chord
  167.  
  168.    2D_DRAW.BMP
  169.         free hand
  170.  
  171.    2D_ELIP.BMP
  172.         ellipse
  173.  
  174.    2D_LINE.BMP
  175.         line
  176.  
  177.    2D_NORM.BMP
  178.         selection
  179.  
  180.    2D_PIE.BMP
  181.         pie
  182.  
  183.    2D_PLYG.BMP
  184.         polygon
  185.  
  186.    2D_PLYL.BMP
  187.         polyline
  188.  
  189.    2D_RECT.BMP
  190.         rectangle
  191.  
  192.    2D_TEXT.BMP
  193.         text
  194.  
  195.    EAGLE.BMP
  196.          sample bitmap
  197.  
  198.    Pointers to show which object is being drawn:
  199.  
  200.    2D_PIE.PTR
  201.         pie
  202.  
  203.    2D_CHD.PTR
  204.         chord
  205.  
  206.    2D_BMP.PTR
  207.         bitmap
  208.  
  209.    2D_ARC.PTR
  210.         arc
  211.  
  212.    2D_DRAW.PTR
  213.         free hand
  214.  
  215.    2D_ELIP.PTR
  216.         ellipse
  217.  
  218.    2D_LINE.PTR
  219.         line
  220.  
  221.    2D_PLYL.PTR
  222.         polyline
  223.  
  224.    2D_PLYG.PTR
  225.         polygon
  226.  
  227.    2D_RECT.PTR
  228.         rectangle
  229.  
  230.    2D_TEXT.PTR
  231.         text
  232.  
  233.  
  234.