Daily Archives: October 6, 2013

FT_REVATTR

Posted on by vivaclipper 
FT_REVATTR()
 Reverse colors of specified screen coordinates

 Syntax

      FT_REVATTR( <nTRow>, <nLCol>, <nBRow>, <nRCol> ) -> NIL

 Arguments

     <nTRow>, <nLCol>, <nBRow>, and <nRCol> are the coordinates of the
     screen region.

 Returns

     NIL

 Description

     This is a high speed function to reverse the color of a specified
     screen region without disturbing any text on the screen.  This
     function will correctly reverse the color attributes in a region
     containing multiple color combinations.

 Examples

     FT_REVATTR( 0, 0, MaxRow(), MaxCol() )

     This example will change the entire screen's colors to their reverse
     attributes without changing  or overwriting any text.

 Source: VIDEO1.C

 Author: Robert A. DiFalco

 

FT_RESTATT

Posted on by vivaclipper 
FT_RESTATT()
 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)

 Source: RESTATT.ASM

 Author: Ted Means

See Also: FT_SAVEATT()

 

FT_PUSHVID

Posted on by vivaclipper 
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()

FT_POPVID

Posted on by vivaclipper 
FT_POPVID()
 Restore previously saved video states.

 Syntax

      FT_PopVid() -> <nStackSize>

 Arguments

     None

 Returns

     The number of items remaining in the internal stack.

 Description

     This is the complementary function to FT_PushVid().  At some time
     after saving the video states it will probably be necessary to restore
     them.  This is done by restoring the settings from the last call to
     FT_PushVid().  The number of items on the internal stack is then
     reduced by one.  Note that the use of stack logic means that items on
     the stack are retrieved in Last In First Out order.

 Examples

     FT_PopVid()          // Restore video states

 Source: PVID.PRG

 Author: Ted Means

See Also: FT_PushVid()

 

FT_GETVPG

Posted on by vivaclipper 
FT_GETVPG()
 Get the currently selected video page

 Syntax

      FT_GETVPG() -> <nPage>

 Arguments

     None.

 Returns

     The video page, as a numeric.

 Description

     Get the currently selected video page

     For more information on graphics programming and video pages,
     consult a reference such as _Programmer's Guide to PC and PS/2
     Video Systems_ (Microsoft Press).

 Examples

     nPage := FT_GETVPG()

 Source: PAGE.PRG

 Author: Glenn Scott

See Also: FT_SETVPG()