1 03/19/85  ft_window_
  2 
  3 
  4 This is the basic video interface subroutine to be used by FORTRAN to
  5 create/destroy/change windows.  (This subroutine should not be called
  6 if usage_mode = 0 (see ft_menu_$init2)).  Its facilities are available
  7 through the following entry points.
  8 
  9 
 10 Entry points in ft_window_:
 11    (List is generated by the help command)
 12 
 13 
 14 :Entry:  change:  03/19/85 ft_window_$change
 15 
 16 
 17 Function:  This entry point is used to change the size of an existing
 18 window.  The size of a window can always be "shrunk", however it can be
 19 increased only it does not overlap with another defined window.  (This
 20 entry point should not be called if usage_mode = 0 (see
 21 ft_menu_$init2).)
 22 
 23 
 24 Syntax:
 25    declarations:
 26      integer  window_id
 27      integer  first_line
 28      integer  height
 29      integer  code
 30    call ft_window_$change (window_id, first_line, heigth, code)
 31 
 32 
 33 
 34 Arguments:
 35 window_id
 36    window identifier returned by ft_window_$create (or by ft_menu_$init
 37    in the case of the user i/o window).  (Input)
 38 first_line
 39    new first line number for the window being changed.  (Input)
 40    Positive integer.
 41 height
 42    new height for the window being changed.  (Input) Positive integer.
 43 code
 44    return code.  (Output)
 45 
 46 
 47 :Entry:  clear_window:  03/19/85 ft_window_$clear_window
 48 
 49 
 50 Function:  Used to clear a specified window.
 51 
 52 
 53 Syntax:
 54    declarations:
 55      integer       window_id
 56      integer       code
 57    call ft_window_$clear_window (window_id, code)
 58 
 59 
 60 
 61 Arguments:
 62 window_id
 63    The window identifier (returned by ft_window_$create) of the window
 64    to be cleared.  (Input)
 65 code
 66    return code.  (Output)
 67 
 68 
 69 :Entry:  create:  03/19/85 ft_window_$create
 70 
 71 
 72 Function:  Used to create a new window on the terminal screen.  (This
 73 entry point should not be called if usage_mode = 0.)  (see
 74 ft_menu_$init2)
 75 
 76 
 77 Syntax:
 78    declarations:
 79      character*32  switch_name
 80      integer       window_id
 81      integer       first_line
 82      integer       height
 83      integer       code
 84    call ft_window_$create (first_line, height, switch_name,
 85           window_id, code)
 86 
 87 
 88 Arguments:
 89 first_line
 90    is the line number where the window is to start.  (Input)
 91 height
 92    the number of lines used by the window, i.e., its height.  (Input)
 93 switch_name
 94    the  name  that  the caller  wishes  to associate  with  the switch.
 95    (Input)  (The caller  may use the  switch name, for  example, in the
 96    FORTRAN "open" statement.)
 97 window_id
 98    the returned id of the window just created.  (Output) It must not be
 99    altered in any way by the application program.
100 code
101    return code.  (Output)
102 
103 
104 :Entry:  destroy:  03/19/85 ft_window_$destroy
105 
106 
107 Function:  Used  to destroy a  previously created window.   (This entry
108 point should not be called if usage_mode = 0 (see ft_menu_$init2).)
109 
110 
111 Syntax:
112    declarations:
113      integer  window_id
114      integer  code
115    call ft_window_$destroy (window_id, code)
116 
117 
118 
119 Arguments:
120 window_id
121    window    identifier    (returned    by    the   ft_window_$create).
122    (Input/Output) It is reset to an illegal value by this call.
123 code
124    return code.  (Output)