FT_PUSHVID()
 Save current video states on internal stack.

 Syntax

      FT_PushVid() -> <nStackSize>

 Arguments

     None

 Returns

     The current size of the internal stack (i.e. the number of times
     FT_PushVid() has been called).

 Description

     Menus, picklists, browses, and other video-intensive items often
     require you to save certain video states -- screen image, cursor
     position, and so forth.  Constantly saving and restoring these items
     can get very tedious.  This function attempts to alleviate this
     problem.  When called, it saves the cursor position, color setting,
     screen image, cursor style, blink setting, scoreboard setting, snow
     setting, and maximum row and column to a series of static arrays.  All
     that is needed to restore the saved settings is a call to FT_PopVid().

 Examples

     FT_PushVid()          // Save the current video states

 Source: PVID.PRG

 Author: Ted Means

See Also: FT_PopVid()