Files
harbour-core/harbour/doc/en/setmode.txt
Pritpal Bedi 0b562ede5b 2011-02-12 16:53 UTC-0800 Pritpal Bedi (bedipritpal@hotmail.com)
* doc/en/gnulice.txt
  * doc/en/setmode.txt
    ! Corrected: NF confirmant mis-alignments.
  * contrib/hbide/ideharbourhelp.prg
    ! Fixed: a bug in retreival of values agains blank data.
      Pointed out by Alain Aupeix.
2011-02-13 00:58:59 +00:00

84 lines
2.4 KiB
Plaintext

/*
* $Id$
*/
/*
* Copyright 2000 Alejandro de Garate <alex_degarate@hotmail.com>
* Documentation for: SETMODE()
*
* See COPYING for licensing terms.
*/
/* $DOC$
* $TEMPLATE$
* Function
* $NAME$
* SETMODE()
* $CATEGORY$
* API
* $SUBCATEGORY$
* Environment
* $ONELINER$
* Change the video mode to a specified number of rows and columns
* $SYNTAX$
* SETMODE( <nRows>, <nCols> ) --> lSuccess
* $ARGUMENTS$
* <nRows> is the number of rows for the video mode to set.
*
* <nCols> is the number of columns for the video mode to set.
* $RETURNS$
* SETMODE() returns true if the video mode change was successful;
* otherwise, it returns false.
* $DESCRIPTION$
* SETMODE() is a function that change the video mode depend on the
* video card and monitor combination, to match the number of rows and
* columns specified.
* Note that there are only a real few combination or rows/cols pairs
* that produce the video mode change.
* The followings are availables for DOS:
*
* <table>
* 12 rows x 40 columns 12 rows x 80 columns
* 25 rows x 40 columns 25 rows x 80 columns
* 28 rows x 40 columns 28 rows x 80 columns
* 50 rows x 40 columns 43 rows x 80 columns
* 50 rows x 80 columns
* </table>
*
* The follow modes are avaliable to Windows
*
* <table>
* 25 rows x 40 columns 25 rows x 80 columns
* 50 rows x 40 columns 43 rows x 80 columns
* 50 rows x 80 columns
* </table>
*
* Some modes only are availables for color and/or VGA monitors.
* Any change produced on the screen size is updated in the values
* returned by MAXROW() and MAXCOL().
* $EXAMPLES$
* // The first example change to a 12 lines of display mode:
* IF SETMODE( 12, 40)
* ? "Hey man are you blind ?"
* ELSE
* ? "Mom bring me my glasses!"
* ENDIF
*
* // Next example change to a 50 lines mode:
* IF SETMODE( 50, 80)
* ? "This wonderful mode was successfully set"
* ELSE
* ? "Wait. this monitor are not made in rubber !"
* ENDIF
* $STATUS$
* R
* $COMPLIANCE$
* Some of these modes are not availables in CA-Cl*pper
* $PLATFORMS$
* DOS,Win
* $FILES$
* Source is gtdos.c,gtwin.c
* $SEEALSO$
* MAXCOL(),MAXROW()
* $END$
*/