HTBasic Help
×
Menu
Index

DUMP DEVICE IS Statement

 
The DUMP DEVICE IS statement specifies which device, file, or pipe receives the data when a DUMP ALPHA or a DUMP GRAPHICS statement is executed without a device selector. The GINIT statement causes the default DUMP DEVICE IS to be set to the value of PRT. If the optional EXPANDED keyword is included, the image is rotated by 90 degrees. For example:
DUMP DEVICE IS PRT,EXPANDED
If APPEND is specified and the DUMP is to a file, the file position is moved to the end-of-file before each DUMP. For some DUMP types, multiple images in a file are not supported. If APPEND is specified in these cases, the result is undefined. If APPEND is not specified, the file is overwritten with each DUMP.
The output can be sent to a device (usually a printer) or a file. If the destination is a file, it must be a regular file or a BDAT file.
Many computer displays and most printers do not have square pixels. This results in a distortion when the graphics image is printed. This is normal and can be partially compensated for, if needed, by adjusting the WINDOW to apply an inverse distortion to the image drawn on the display. HTBasic partially compensates for non-square pixels by printing more than one printer pixel for each display pixel in some instances.
In some cases the softkey labels and ALPHA text are dumped along with GRAPHICS by the DUMP GRAPHICS statement. This depends on whether ALPHA and GRAPHICS are MERGEd or SEPARATE. MERGE and SEPARATE ALPHA are explained later in this section.
This problem can be easily solved using the statement SEPARATE ALPHA FROM GRAPHICS before generating the plot. If you have not used SEPARATE ALPHA, to solve the problem you should clear the ALPHA screen, turn the runlight off, and turn the softkey labels off before starting the GRAPHICS plot. For example:
KEY LABELS OFF
RUNLIGHT OFF
CLEAR SCREEN