/* $DOC$
   $NAME$
      ft_SaveAtt()
   $CATEGORY$
      Video
   $ONELINER$
      Save the attribute bytes of a specified screen region.
   $SYNTAX$
      ft_SaveAtt( <nTop>, <nLeft>, <nBottom>, <nRight> ) -> cAttributes
   $ARGUMENTS$
      <nTop>, <nLeft>, <nBottom>, and <nRight> define the screen region.
   $RETURNS$
      A character string containing the screen attribute bytes for the
      specified region.  If the memory to store the return value could
      not be allocated, the function returns NIL.
   $DESCRIPTION$
      This function is similar to Clipper's SaveScreen(), except that it only
      saves the attribute bytes.  This is useful if you want to change the
      screen color without affecting the text.

      *** INTERNALS ALERT ***

      This function calls the Clipper internal __gtMaxCol to obtain the
      maximum column value for the current video mode.  If you're too gutless
      to use internals, then this function isn't for you.
   $EXAMPLES$
      // Save attributes of row 4
      cBuffer := ft_SaveAtt( 4, 0, 4, MaxCol() )

      // Save attributes from middle of screen
      cBuffer := ft_SaveAtt( 10, 20, 14, 59 )
   $SEEALSO$
      ft_RestAtt()
   $END$
 */

/* $DOC$
   $NAME$
      ft_RestAtt()
   $CATEGORY$
      Video
   $ONELINER$
      Restore the attribute bytes of a specified screen region.
   $SYNTAX$
      ft_RestAtt( <nTop>, <nLeft>, <nBottom>, <nRight>, <cAttributes> ) -> NIL
   $ARGUMENTS$
      <nTop>, <nLeft>, <nBottom>, and <nRight> define the screen region.
      <cAttributes> is a character string containing the attribute bytes
                    for the screen region.  This will most often be a string
                    previously returned by ft_SaveAtt(), but any character
                    string may be used (provided it is of the proper size).
   $RETURNS$
      NIL
   $DESCRIPTION$
      This function is similar to Clipper's RestScreen(), except that it only
      restores the attribute bytes.  This is useful if you want to change the
      screen color without affecting the text.

      *** INTERNALS ALERT ***

      This function calls the Clipper internals __gtSave and __gtRest to
      manipulate the the screen image.  If you're too gutless to use
      internals, then this function isn't for you.
   $EXAMPLES$
      // Restore attributes of row 4
      ft_RestAtt( 4, 0, 4, MaxCol(), cBuffer )

      // Restore attributes to middle of screen
      ft_RestAtt( 10, 20, 14, 59, cBuffer )
   $SEEALSO$
      ft_SaveAtt()
   $END$
 */
