Click above to get retro games delivered to your door ever month!

##############################################################################
###+----------+###############################################################
#+-| SCRN_DOS |--------------------------------------------------------+######
#| +----------+ Eliminates screen flicker and guarantees compatibility |######
#+---------------------------------------------------------------------+######
##############################################################################
##############################################################################
#+--| Summary |------------+##################################################
#|     #INCLUDE io.hdr     |##################################################
#+-------------------------+##################################################
##############################################################################
##############################################################################
#+--| Syntax |--------------------------+#####################################
#|     PROCEDURE scrn_dos PROTOTYPE     |#####################################
#+--------------------------------------+#####################################
##############################################################################
##############################################################################
#########+---| Description |--------------------------------------+###########
#########| The scrn_dos procedure eliminates screen flicker and   |###########
#########| guarantees hardware compatibility by causing FORCE     |###########
#########| console output to use DOS calls.  Using the DOS output |###########
#########| system also allows redirection of the DOS command line |###########
#########| and use of piping techniques.                          |###########
#########+--------------------------------------------------------+###########
##############################################################################
##############################################################################
#########+---| Design |--------------------------------------------+##########
#########| The FORCE library contains replaceable drivers for      |##########
#########| screen and keyboard I/O.  FORCE library contains three  |##########
#########| standard libraries for screen output: scrn_dos,         |##########
#########| scrn_bios and scrn_direct.                              |##########
#########| ------------------------------------------------------- |##########
#########| The FORCE screen drivers affect ANY COMMAND THAT CAN BE |##########
#########| SENT TO AN ALTERNATE FILE.  It does not redirect the    |##########
#########| output of the SAY or GET commands, which have a         |##########
#########| different output system.                                |##########
#########+---------------------------------------------------------+##########
##############################################################################
##############################################################################
#########+--| Example 1 |-------------------------------------------+#########
#########| *    Eliminate screen flicker in the XT machine.         |#########
#########|                                                          |#########
#########| DO scrn_dos                                              |#########
#########+----------------------------------------------------------+#########
##############################################################################
##############################################################################
#########+--| Example 2 |-------------------------------------------+#########
#########| *    file: \force\sample\redir.prg                       |#########
#########| *    (** source code included with compiler **)          |#########
#########| *    Output a subsection of a database to the console    |#########
#########| *    using DOS I/O.  This means the output of this       |#########
#########| *    FORCE program can be redirected with DOS's > or     |#########
#########| *    | symbol.                                           |#########
#########|                                                          |#########
#########| #include io.hdr                                          |#########
#########|                                                          |#########
#########| DBFDEF d                                                 |#########
#########|     CHAR(20)     name                                    |#########
#########| ENDDEF                                                   |#########
#########|                                                          |#########
#########| PROCEDURE force_main                                     |#########
#########|  PARAMETER CONST CHAR name                               |#########
#########|                                                          |#########
#########|     DO scrn_dos                                          |#########
#########|     USE "d.dbf" ALIAS d                                  |#########
#########|     SET FILTER TO name $ d->name                         |#########
#########|     LIST d->name, d->type                                |#########
#########|                                                          |#########
#########| ENDPRO                                                   |#########
#########|                                                          |#########
#########| *--- compile the above program and then type at the      |#########
#########| *    command line:                                       |#########
#########| *                   redir david > names.txt              |#########
#########| *    After redir.exe runs, the names.txt file            |#########
#########| *    contains all "david" records.                       |#########
#########+----------------------------------------------------------+#########
##############################################################################