Topic       : The GFA-Basic Compendium
Author      : GFA Systemtechnik GmbH
Version     : GFABasic.HYP v2.98 (12/31/2023)
Subject     : Documentation/Programming
Nodes       : 899
Index Size  : 28056
HCP-Version : 3
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Document not found
@help       : Help
@options    : +g -i -s +z
@width      : 75
@hostname   : STRNGSRV
@hostname   : CAB     
@hostname   : HIGHWIRE
@hostname   : THING   
View Ref-FileLPRINT expression
LPOS(x)
HARDCOPY

expression: aexp or sexp, arbitrarily mixed
x: avar (dummy argument)

LPRINT is identical to the PRINT command and its variants (LPRINT USING, etc.),
except that output goes to the printer instead of the screen, and it is not
possible to use the PRINT AT equivalent, as this would involve re-positioning
the print head. Similarly to POS(), LPOS() returns the number of characters
printed since the last Carriage Return.

HARDCOPY causes a copy of the screen to be output to a suitable printer, in the
same way as by pressing the ALTernate-Help keys. There is a driver for
non-Epson compatible 9 pin printers which, unlike HARDCOPY does not use
XBIOS(20). It is activated by SDPOKE &H4EE,0.

Some hard copy drivers don't react on routine XBIOS(20). Frank Ostrowski made
last-minute changes to the HARDCOPY command. Now there is a SPOKE &H4EE,0 and a
VSYNC that should help even the worst cases.

Examples:

    LPRINT
    LPRINT "test"
    PRINT LPOS(x)

--> The word "test" comes out on the printer (if it is attached, switched on,
    and On-line) and the current print head position appears on the screen.

    FOR i%=20 TO 180 STEP 10
      CIRCLE 320,200,i%
    NEXT i%
    HARDCOPY

--> Concentric circles are drawn on the screen, then a copy of the screen is
    made on the printer.

Memo: LPRINT does not work on an Atari Falcon030.

Scrdmp()+, v_hardcopy()+