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

 PRTSC() 

          Many times users of your applications have simply wanted a print
          screen of what they see.  In order to accommodate them you usually
          need to write a routine will recreates the information on the
          printer.  With PRTSC this is no longer necessary.

          The PRTSC function actually contains two separate functions.  The
          first function is a command driven print screen.  Embedded in your
          source code, the PRTSC command will cause a print screen to happen
          just as if the SHIFT PRTSC keys were pressed.

          The second function of PRTSC is that of a translator.  With the use
          of the BOX command many screens have become "unprintable" by usual
          standards.  Doing a print screen causes strange characters or
          control codes to be sent to the printer.  The PRTSC function has
          the ability to intercept those "unprintable" characters and
          translate them into simple, unoffensive periods (.).  The basic
          design of your screen is intact but without lots of programming
          effort.


      Format: 

               prtsc(['xlat' | 'off'])


      Parameters: 

               ()........If no parameters are specified, instructs the
                         function to perform an immediate print screen.  If
                         the translate facility has been activated then the
                         function will perform the print screen translation,
                         otherwise the standard BIOS interrupt perform as
                         usual.

               'xlat'....Character string variable or constant, non case
                         sensitive, which instructs the function to begin
                         translation of all print screen activity.  If a
                         print screen is invoked, either from PRTSC() or from
                         the keyboard, all characters will be translated
                         which do not fall into the following range: ASCII 32
                         to 127 (" " to "~").  The characters are translated
                         into a period (.).

               'off'.....Character string variable or constant, non case
                         sensitive, which instructs the function to terminate
                         translation of all print screen activity.  Control
                         is returned to the BIOS for print screen requests.


      Examples: 

               1.   A user wishes a snapshot of the currently displayed
                    record.  Rather than writing a report routine, a print
                    screen is invoked but, as the screen contains graphical
                    box characters, a translation is first required.

                    .
                    .
                    .
                    prtsc('xlat')
                    prtsc()
                    prtsc('off')
                    .
                    .
                    .

               2.   Thinking ahead, the programmer has determined during
                    installation that the user's printer cannot print the
                    graphical box characters used on the display screen. The
                    translate facility has been activated and when the user
                    performs a manual print screen the translation is still
                    effective.

                    .
                    .
                    prtsc('xlat')
                    .
                    .
                    (user presses Shift PrtSc)
                    .
                    .
                    prtsc('off')
                    (end of program)

      Returns: 

               Nothing.


      Cautions: 

               This function should not be placed into an overlay as it is
               interrupt driven.  Any error routines which determine an
               unrecoverable runtime error has occurred should disable this
               function prior to exiting the program.  Failure to follow this
               caution may result in the computer locking up.