home *** CD-ROM | disk | FTP | other *** search
/ Power-Programmierung / CD2.mdf / c / library / dos / grafik / mgl11 / read.me < prev    next >
Encoding:
Text File  |  1994-03-10  |  6.8 KB  |  146 lines
  1.  
  2.                       The MegaGraph Graphics Library
  3.                       ------------------------------
  4.  
  5. The MegaGraph Graphics Library (MGL) is a full featured graphics library for
  6. displaying high performance graphics on personal computers. It provides fast,
  7. low level 2D drawing primitives that can be used to implement video games,
  8. user interface software and even real-time 3D animation. It will work in any
  9. video mode that has 16 or more colors, including the new HiColor and TrueColor
  10. modes available on modern PC's.
  11.  
  12. The MGL also fully supports the Microsoft Mouse Interface in all supported
  13. graphics modes, including the SuperVGA video modes.
  14.  
  15. The MGL supports Borland C++ 3.1, Microsoft C 6.0 and Symantec C++ 6.1 and
  16. later compilers. It may work with earlier compilers but these have not been
  17. tested.
  18.  
  19. The MGL requires at least an 80386 based CPU in order to operate correctly,
  20. so will not work on 286 and lower machines.
  21.  
  22. Library Naming Conventions
  23. --------------------------
  24.  
  25. The library naming conventions are similar to that used by Borland and most
  26. compiler vendors. The MGL only supports the large memory model, so there is
  27. only one library supplied for each of the compilers named 'mgraph.lib'.
  28.  
  29. Installation
  30. ------------
  31.  
  32. To install the graphics library, you need to do two things. Copy all of the
  33. include files from the INCLUDE directory into your standard include file
  34. directory, or make sure that the directory containing the include files
  35. is on your standard include file path (under Borland C++ you can specify
  36. this in your global turboc.cfg file - see the one in the EXAMPLES directory).
  37.  
  38. Second you must copy all of the library files from the LIB directory into
  39. your standard library directory, or make sure that the directory containing
  40. the library files is on your standard library file path.
  41.  
  42. Personally I have separate include file and library file directories,
  43. but that is personal preference.
  44.  
  45. Once you have done this, you can try to compile the example programs.
  46.  
  47. Making the example programs
  48. ---------------------------
  49.  
  50. In the EXAMPLES directory you will find the source code to the sample
  51. programs provide with the MGL. These programs are supplied pre-compiled
  52. in the MGLD??.ZIP archive which contains all of the MGL demo programs compiled
  53. with full SuperVGA support. However a makefile is provided for compiling these
  54. example programs from the command line for your specific compiler (requiring
  55. Borland MAKE however). Only one generic makefile is provided, and requires
  56. that you first install the compiler specific makefile definitions into a
  57. standard directory. All of the SciTech Software products use the same
  58. makefile definitions for compiling with the different compilers.
  59.  
  60. The makefile definitions are provided in the file MKDEFS??.ZIP, which
  61. should be unzipped into the directory \MAKEDEFS on the same drive that
  62. you will be compiling your source files (ie: C:\MAKEDEFS if your source
  63. files reside on drive C:). Once you install the makefile defintions into
  64. this directory, you will be able to run all the makefiles for different
  65. compilers simply by running make with a different command line option. The
  66. following commands should be used:
  67.  
  68.     make -Dmsc          - for Microsoft C
  69.     make -Dsymantec     - For Symantec C++
  70.  
  71. If you do not have access to the Borland make program, you can use the
  72. special supplied makefiles for MSC and Symantec C++ (these makefiles are
  73. more limited than the generic one).
  74.  
  75. Once the mgldemo.exe program is compiled, you can run it. If you type the
  76. command:
  77.  
  78.     mgldemo -h
  79.  
  80. you will be given help information detailing the available video modes
  81. that you can tell it to use for your system. It will also provide information
  82. on the various command line switchs that you can use to modify the way the
  83. program works on your system.
  84.  
  85. Making the MGL demo program
  86. ---------------------------
  87.  
  88. This archive also contains the source code to the MGL demo program, available
  89. in the separate MGLD??.ZIP archive. This program is written in C++ using the
  90. MegaVision Application Frameworks, which is a C++ GUI toolkit for the MGL.
  91. In order to compile this program you will need to obtain the MegaVision AF
  92. and the Techniques Class Library. Both of these should be available from
  93. the same location that you obtained this file in the archives MVIS??.ZIP
  94. and TECH??.ZIP.
  95.  
  96. Whats are the files debug.h, and mouse.h?
  97. -----------------------------------------
  98.  
  99. The header file "debug.h" is a general header file used to define a number of
  100. useful debugging macros and useful type definitions (uchar, uint etc). It
  101. is required by all of the library include files. As long as it is available
  102. somewhere on your normal include file path, or in the current directory you
  103. should not have to worry about it.
  104.  
  105. The header file "mouse.h" defines how to use the mouse library interface
  106. routines. This is from the 'MegaToolbox library', which should be available
  107. from the same place that you got this library from, or directly from SciTech
  108. Software. For simplicity, all of the mouse library routines are included in
  109. the graphics library, but no documentation is provided. You will need to
  110. refer to the docs that come with the 'MegaToolbox' for further information
  111. about the mouse library.
  112.  
  113. The MGL actually hooks into the mouse interrupt 0x33 to enable full mouse
  114. support in the SuperVGA video modes, so you can continue to use your
  115. favorite mouse library with the MGL. However, if you wish to install your
  116. own mouse event handling routines, you will need to use the mouse library
  117. that comes with the MegaToolbox to co-operate correctly with the MGL (the
  118. MGL install's it's own event handler for moving the mouse cursor around
  119. on the display).
  120.  
  121. Files in distribution
  122. ---------------------
  123.  
  124. The distribution archive contains files stored in a number of directories,
  125. so it needs to be unpacked with 'pkunzip -d' or similar.
  126.  
  127.     EXAMPLES\*.*    - All example code, and compiled test programs.
  128.     INCLUDE\*.*     - All include files
  129.     LIB\*.*         - All library files for Borland C++
  130.     LIB\MSC\*.*     - All library files for Microsoft C
  131.     LIB\SYMC\*.*    - All library files for Symantec C++
  132.     FONTS\*.*       - Selection of supplied font files
  133.     DOC\mgraph.txt  - Online text version of documentation
  134.     *.drv           - Graphics device driver files
  135.     *.obj           - Object file versions of device driver files
  136.     mkdefs??.zip    - Makefile definitions
  137.     univbe??.zip    - Universal VESA VBE
  138.     read.me         - This file!
  139.     copyrigh        - Copyright notice
  140.     version         - Version of library
  141.     changes         - Log of changes to the library
  142.     license.doc     - SciTech Software Shareware License Agreement
  143.     order.doc       - SciTech Software software order form
  144.     products.doc    - Details of available SciTech Software products
  145.  
  146.