PRINTMODE

The _PRINTMODE statement sets the text or _FONT printing mode on a background image when using PRINT or _PRINTSTRING.

Syntax

_PRINTMODE {_KEEPBACKGROUND|_ONLYBACKGROUND|_FILLBACKGROUND}[, image_handle]

Parameters

• One of 3 mode keywords is mandatory when using this statement to deal with the text background.

• _KEEPBACKGROUND (mode 1): Text background transparent. Only the text is displayed over anything behind it.
• _ONLYBACKGROUND (mode 2): Text background is only displayed. Text is transparent to anything behind it.
• _FILLBACKGROUND (mode 3): Text and background block anything behind them like a normal PRINT. Default setting.

• If the optional image handle is omitted it will use the current destination image background.
• If the optional image handle is 0 it will use the current program SCREEN image background.

Description

• Use the _PRINTMODE (function) to find the current _PRINTMODE setting mode number.
• The _PRINTMODE statement and function can only be used in graphic screen modes, NOT SCREEN 0

Example: Using _PRINTMODE with PRINT in a graphic screen mode. The background used is CHR$(219) = █

SCREEN 12 COLOR 8: LOCATE 10, 10: PRINT STRING$(3, 219) 'background _PRINTMODE _KEEPBACKGROUND COLOR 15: LOCATE 10, 10: PRINT _PRINTMODE END

See also

• _PRINTMODE (function)
• _PRINTSTRING
• _LOADFONT
• _NEWIMAGE
• PRINT, _PRINT USING

---

Navigation:

Go to Keyword Reference - Alphabetical

Go to Keyword Reference - By usage

Go to Main WIKI Page