home *** CD-ROM | disk | FTP | other *** search
/ Power-Programmierung / CD1.mdf / pascal / library / dos / tvision / gravis / gv / ginfo.doc < prev    next >
Encoding:
Text File  |  1994-05-23  |  8.4 KB  |  212 lines
  1. Graphics Vision, version 2.0
  2.  
  3. Copyright 1993 by Stefan Milius, Magdeburg
  4.  
  5. Documentation
  6.  
  7. --------------------------------------------------------------------------------
  8.  
  9. I General Information
  10. =====================
  11.  
  12. This software package was especially developed for you as a professional
  13. programmer. It provides a class library for creating of graphical
  14. environments in Microsoft(R)-Windows(TM)-look under Turbo Pascal for DOS,
  15. version 6.0/7.0. The software is fully compatible with Borland's text
  16. environment Turbo Vision and offers moreover some enlargements.
  17.  
  18. II Information to Graphics Vision, version 2.0
  19. ==============================================
  20.  
  21. Graphics Vision (GV) consists of several Turbo Pascal units.
  22. These are:
  23.  
  24.      GVDriver.TPU
  25.      ExtGraph.TPU
  26.      GVViews.TPU
  27.      GVDialog.TPU
  28.      GVMenus.TPU
  29.      GVApp.TPU
  30.      GVStdDlg.TPU
  31.      GVGadget.TPU
  32.      GVMsgBox.TPU
  33.      GVEdit.TPU
  34.      GVValid.TPU
  35.      GVWList.TPU
  36.  
  37. The DPMI units have the extension TPP.
  38.  
  39. (See the respective text files for detailed information.)
  40.  
  41. Graphics Vision proceeding from the basic Turbo Vision class Tview builds
  42. up a class library for creating of graphical environments, which has the
  43. following features:
  44.  
  45.  1. creation of any, structured, user defined pull down menus. Every menu
  46.     option can be chosen by mouse, by keyboard (shortcut or cursor keys) or
  47.     by hotkeys.
  48.  
  49.  2. intelligent window management. Management of as much (different) windows
  50.     as you like on the so-called desktop with the known functions, e.g.
  51.     zoom, move, resize and so on.
  52.  
  53.  3. user defined dialog windows with the elements known from Turbo Vision
  54.     (for example, buttons, checkboxes, radiobuttons, inputlines, statictexts,
  55.     labels, listboxes u.s.w.)
  56.  
  57.  4. Usage of Hotkeys. The keyboard key combinations known from Turbo Vision
  58.     for certain functions can be used in Graphics Vision, too.
  59.  
  60.  5. context-sensitive hints in the statusline. Graphics Vision allows to give
  61.     hints to menu options or elements of (dialog-) windows in the statusline.
  62.  
  63.  6. improved mouse control because of the usage of MyMouse, version 1.5.
  64.     See MyMouse documentation for detailed information.
  65.  
  66.  7. adjustment of the mouse pointer onto different objects. By the usage of
  67.     MyMouse the mouse pointers for window frames or inputlines or the hour
  68.     glass known from Windows(TM) can be used in Graphics Vision, too.
  69.  
  70.  8. support of resource files. Menus, statusline, dialog windows do not longer
  71.     have to be created "life" in the program but can be loaded from a file
  72.     what leads to a code optimization in your programs.
  73.  
  74.  9. usage of the highly-optimized graphic routines of the MetaGraph package,
  75.     version 1.0, for fast drawing of the objects. The routines directly
  76.     access the VGA adapter which means fastest drawing of windows, menus
  77.     and so on. (see MetaGraph documentation for more information)
  78.  
  79.  10. usage of optionally existing Windows(TM) bitmap fonts. Graphical texts
  80.      do not longer have to be output with the Turbo Pascal BGI routines.
  81.      If there are no Windows(TM) fonts BIOS fonts automatically are used.
  82.  
  83.  11. Graphics Vision is able to work together with the BGI. Although Graphics
  84.      Vision is using the routines of the MetaGraph package which directly
  85.      access the VGA adapter in order to reach higher output speed it is
  86.      possible to use BGI routines.
  87.  
  88.  12. Graphics Vision basically is in two languages. By setting a variable
  89.      you can switch between English or German texts (e.g. with file dialog or
  90.      message boxes and so on). All texts are linked in the executable file.
  91.      So it is possible to change the used language at run-time. If you have
  92.      purchased the source codes you also can also use a single language,
  93.      which reduces the code size.
  94.  
  95.  13. Graphics Vision is fully DPMI-able! With this you at last have enough
  96.      memory for your efficient Graphics Vision applications.
  97.  
  98.  14. Graphics Vision 2.0 is fully compatible to Borland's Turbo Vision 2.0.
  99.      Multicheckboxes und Menupopups can also be used by Turbo Pascal 6.0
  100.      programmers.
  101.  
  102. Graphics Vision, version 2.0 has the following limitations:
  103.  
  104.   The definition of user defined mouser pointers will only be possible if you
  105.   purchase MyMouse, version 1.5.
  106.  
  107. III Technical Information
  108. =========================
  109.  
  110. III.1 Classes, methods, fields
  111. ------------------------------
  112.  
  113. See the documentations of the respective Graphics Vision units for
  114. information about classes, fields and methods of the several classes.
  115.  
  116. III.2 Special features in contrast to Turbo Vision
  117. --------------------------------------------------
  118.  
  119. Although we have tried to program Graphics Vision Turbo-Vision-like so that
  120. users will not have difficulties in using Graphics Vision there are some
  121. differences.
  122.  
  123.   (1) color palettes
  124.  
  125.     The palette of the application does not store attributes but the
  126.     drawing color (constants from 0 to 15; known from unit Graph).
  127.     Single objects can directly refer to the application palette
  128.     (without referring to a palette of their parent window first;
  129.     see TGview.GetColor)
  130.  
  131.   (2) state flags
  132.  
  133.     The state flags sfShadow, sfDefault and sfBuffer defined in Views
  134.     should not be used in Graphics Vision programs.
  135.  
  136.   (3) option masks
  137.  
  138.     The flag ofBuffer defined in Views is used differently in Graphics Vision.
  139.     Windows do not have a background buffer. The flag is enabled for all
  140.     objects. If enabled the object has to be able to write into the VGA rest
  141.     buffer. If your Draw methods use non-MetaGr routines you should disable
  142.     the flag.
  143.     Besides there is the flag ofMetaFile. If enabled an object has to be able
  144.     to use the metafile concept provided by MetaGraph. It is again enabled in
  145.     every object. If you use non-MetaGr routines in your Draw methods you will
  146.     have to disable the flag.
  147.     Graphics Vision additional defines the flag ofClip. If enabled every
  148.     screen output an object does will be cut at its borders. If disabled
  149.     outputs will be cut at the border of the GOwner. (see there)
  150.  
  151.   (4) message commands
  152.  
  153.     Message commands defined additionally by GVViews should not be used
  154.     by Graphics Vision users.
  155.  
  156.   (5) standard mouse cursors
  157.  
  158.     By these contants the mouse pointer can be adjusted onto objects.
  159.     Just set MyMouse.NewNum according to the mouse position
  160.     (=MyMouse.MouseWhere; e.g. mouse pointer inside the object) on one
  161.     of these constants or use the constants with GVDriver.MCurStandard or
  162.     GVDriver.SetCurrentCursor. (also see TGview.ChMCursor)
  163.  
  164.   (6) dragging
  165.  
  166.     The Dragview methods have got an additional parameter (ResMode).
  167.     (see Twindow.DragView for more information)
  168.  
  169.   (7) restoring the background
  170.  
  171.     Windows do not have a buffer in GV. If moving or closing a window
  172.     the background will be restored with the help of a temporary buffer in
  173.     the VGA rest buffer or the MetaFile concept (see MetaGr.TXT).
  174.  
  175.   (8) Writing into windows which are only partly visible
  176.  
  177.     GV for this provides the routines TGview.GetVisibleRect,
  178.     TGview.GetInvisibleRect and TGview.DrawRectList. (see there)
  179.  
  180.   (9) Usage of BGI routines
  181.  
  182.     Because these routines are not compatible to GV (e.g. with the clipping)
  183.     there is the compatibility unit BGI. (see BGI.TXT)
  184.  
  185. III.3 Example programs
  186. ----------------------
  187.  
  188. The Graphics Vision example programs were developed out of the programs to the
  189. OOP manual of Turbo Pascal, version 6.0, which means they are modified for
  190. GV.
  191. The program Demo shows the most important functions of GV and all dialog
  192. elements on one view.
  193.  
  194. III.4 System requirements
  195. -------------------------
  196.  
  197. Graphics Vision runs on all IBM PCs and 100% compatible (at least
  198. 80286 processor) with VGA adapter.
  199. The usage of a mouse is recommendable. (But this is not neccessary.
  200. The Graphics Vision applications also operate properly without mouse.)
  201. The used system should be MS-DOS or a comparable (e.g. DR-DOS).
  202. Because Graphics Vision consists of several units Borland's Turbo Pascal,
  203. from version 6.0 on is needed.
  204.  
  205. IV Trademarks
  206. =============
  207.  
  208. Microsoft is a registered trademark of the Microsoft Corp., Inc.
  209. Windows is a trademark of the Microsoft Corp., Inc.
  210. Mouse Systems is a registered trademark of the Mouse Systems Corp.
  211. Borland is a registered trademarks of the Borland Internation, Inc.
  212. All other trademarks will also be admitted.