home *** CD-ROM | disk | FTP | other *** search
/ Frostbyte's 1980s DOS Shareware Collection / floppyshareware.zip / floppyshareware / USCX / PTOOLS.ZIP / PTOOLWI3.DOC < prev    next >
Text File  |  1985-05-17  |  7KB  |  138 lines
  1.  PTOOLWI3.INC   Copyright 1984  R D Ostrander                   Version 3.0
  2.                                 Ostrander Data Services             of
  3.                                 5437 Honey Manor Dr             PTOOLWIN.INC
  4.                                 Indianapolis  IN  46241
  5.  
  6.  These Turbo Pascal procedures are text window manipulation tools used to ease
  7.  the manipulation of Windows in an IBM PC environment. They are used to open
  8.  and close windows while saving the data covered by the window. Borders around
  9.  windows are also supported.
  10.  
  11.  This program has been placed in the Public Domain by the author and copies
  12.  may be freely made for non-commercial, demonstration, or evaluation purposes.
  13.  Use of these subroutines in a program for sale or for commercial purposes in
  14.  a place of business requires a $20 fee be paid to the author at the address
  15.  above.  Personal non-commercial users may also elect to pay the $20 fee to
  16.  encourage further development of this and similar programs. With payment you
  17.  will be able to receive update notices, diskettes and printed documentation
  18.  of this and other PTOOLs from Ostrander Data Services.
  19.  
  20.  
  21.  PTOOL, and PTOOLxxx are Copyright Trademarks of Ostrander Data Services
  22.  
  23.  Turbo Pascal is a Copyright of Borland International Inc.
  24.  
  25. Version 2.0 of PTOOLWIN (aka PTOOLWI2) supports stack operations for holding
  26. screen image data. Each screen opened absorbs 4006 bytes of Heap/Stack while
  27. it is open for the storage of the image on the screen before the new screen
  28. was opened. This area is freed up when the window is closed. No checks are
  29. made within PTOOLWIN to ensure that there is sufficient space on the
  30. Heap/Stack for PTOOLWIN to execute properly. The calling program must do this
  31. via a MaxAvail call such as
  32.  
  33.     If MaxAvail < 0 or MaxAvail > 4006 then PTWOpen (1)
  34.                                        else (((((ERROR ROUTINE)))));
  35.  
  36. Version 3.0 of PTOOLWIN (aka PTOOLWI3) automatically determine whether a
  37. Color/Graphics or a Monochrome display card are active and sets the output
  38. accordingly IF PTOOLWIN_Screen_Type IS AN 'X' WHEN PTWSET is first called.
  39. This variable still has all the functionality in Version 1.0 and 2.0 - if
  40. PTOOLWIN_Screen_Type is set to a 'C' or 'M' by the calling program, it will
  41. take precedence and the switching of screens can still be done this way.
  42.  
  43.      Version 3.0 was developed by LEW PAPER of St. Paul MN using the
  44.      card routine "WINDOW.PAS" developed by BELA LUBKIN of Borland.
  45.  
  46.      Thanks to both of these people by the original author. A good
  47.      example of User Supported Software at work.
  48.                                                 RDO.
  49.  
  50.  
  51.  
  52. Procedures available in PTOOLWIN.INC are:
  53.  
  54.  
  55.  PTWSet  (Screen#, X1, Y1, X2, Y2,  - Sets up window coordinates so that later
  56.          BorderSwitch,                references can be made by Mnemonic only.
  57.          BackgroundColor,             PTWSet must be done once for each window
  58.          ForegroundColor)             before it is Opened.
  59.                                       The Screen# is a number between 1 and
  60.                                       the maximum number of windows allowable
  61.                                       set in the Constants Block below.
  62.                                       The X and Y Coordinates are the same as
  63.                                       for the Turbo Pascal Window procedure.
  64.                                       A border may be placed around the window
  65.                                       and the size of the window will be
  66.                                       decreased to fit inside the border. The
  67.                                       BorderSwitch functions are:
  68.                                          0 - No border
  69.                                          1 - Single line block graphics border
  70.                                          2 - Double line block graphics border
  71.                                         -1 - Single line Reversed color border
  72.                                         -2 - Double line Reversed color border
  73.                                       The BackgroundColor and ForegroundColor
  74.                                       parameters are the same as for the Turbo
  75.                                       Pascal TextColor and TextBackground
  76.                                       procedures.
  77.  
  78.  PTWOpen (Screen#)                  - Activates a window (previously set by
  79.                                       PTWSet) and saves the screen covered by
  80.                                       the window.
  81.                                       In the Constants Block following, there
  82.                                       is a parameter that sets the maximum
  83.                                       number of windows that may be open at
  84.                                       any one time.
  85.  
  86.  PTWClose                           - De-activates the open window, activates
  87.                                       the previous window and restores the
  88.                                       screen covered by the closed window.
  89.                                       Note that the PTWOpen & PTWClose have a
  90.                                       "Push/Pop" type of action.
  91.  
  92.  
  93.  
  94. Constants in the PTOOLWIN.INC file that must be set by the programmer before
  95. compilation are:
  96.  
  97.  
  98.    PTOOLWIN_Number_of_Windows = nn;
  99.  
  100.         This determines the number of windows that may be set with the
  101.         PTWSet procedure. This is easily determined when the calling
  102.         program is designed.
  103.  
  104.         It also determines the number of windows that may be open at any one
  105.         time.
  106.  
  107.         Use the largest of the two figures that you expect.
  108.  
  109. There is a constant that must be set before the PTWOpen or PTWClose procedures
  110. are called:
  111.  
  112.  
  113.    PTOOLWIN_Screen_Type : Char = 'C';
  114.  
  115.         If the final program is going to be run on an IBM PC with a Monochrome
  116.         video card then this parameter must be set to 'M'. If the PC has
  117.         a Color/Graphics card then it must be set to 'C'. This setting may be
  118.         done at run time rather than at compile time since the difference that
  119.         this parameter makes is whether to store and recall the screen data at
  120.         $B8000 (Color Graphics) or $B0000 (Monochrome) via the absolute
  121.         variables :
  122.                      PTOOLWIN_C_Screen   : Char absolute $B800:$0000;
  123.                      PTOOLWIN_M_Screen   : Char absolute $B000:$0000;
  124.  
  125.         This may be found in the calling program by using either the
  126.         PTEMonoAttached or PTEColorAttached functions found in the PTOOLENV
  127.         Environment control.
  128.  
  129.  
  130.  
  131.  Now go out and try PTOOLWIN and by all means, look at the code of both
  132.  PTOOLWIN.PAS and PTOOLWIN.INC to completely understand how to incorporate
  133.  the Ostrander Data Services product into your programs.
  134.  
  135.  Write to find out about other ODS software available that might not be
  136.  on this bulletin board.
  137.  
  138.