vtilin (2) --- insert lines on the user's terminal screen  08/16/83


          | _C_a_l_l_i_n_g _I_n_f_o_r_m_a_t_i_o_n

          |      integer function vtilin (row, cnt)
          |      integer row, cnt

          |      Library: vswtlb (standard Subsystem library)


          | _F_u_n_c_t_i_o_n

          |      'Vtilin'  inserts  'cnt'  blank  lines  at line 'row' on the
          |      screen.  If 'cnt' is not given, it defaults  to  1.   Unlike
          |      other  'vth'  functions,  'vtilin'  makes the changes on the
          |      user's terminal immediately (ie - with no call to  'vtupd').
          |      'Vtilin' will take advantage of a terminal's hardware insert
          |      line  function,  if  one  is  available,  otherwise  it will
          |      simulate it with whatever other functions the terminal  pos-
          |      sesses.   The  function  return  is  ERR if 'row' is off the
          |      screen or 'cnt' is negative and OK otherwise.


          | _I_m_p_l_e_m_e_n_t_a_t_i_o_n

          |      'Vtilin' first ensures that 'row' is on the screen and  that
          |      'cnt'  is  positive.   If a hardware insert line function is
          |      available, the subroutine simply positions  to  the  correct
          |      place  on  the  screen and outputs the appropriate number of
          |      line inserts.  If  hardware  insert  is  not  available  the
          |      subroutine  attempts  to use a hardware clear to end-of-line
          |      function to clear sections of the screen and then redraw the
          |      rest of the screen.  If no hardware clear to end-of-line  is
          |      available  the  subroutine  just  writes blanks to clear the
          |      correct section and then redraws the rest of the screen.


          | _C_a_l_l_s

          |      move$, vt$del, vt$out, vtmove


          | _A_r_g_u_m_e_n_t_s _M_o_d_i_f_i_e_d

          |      none


          | _S_e_e _A_l_s_o

          |      Other vt?* routines (2)










            vtilin (2)                    - 1 -                    vtilin (2)