_PRINTMODE

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

Syntax

_PRINTMODE {_KEEPBACKGROUND|_ONLYBACKGROUND|_FILLBACKGROUND}[, imageHandle&]

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 only is 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 imageHandle& is omitted or is 0 then the setting will be applied to the current destination image.

Description

• Use the _PRINTMODE (function) to find the current _PRINTMODE setting mode number for an image.
• The _PRINTMODE statement and function can only be used on graphic images, not text-based ones such as SCREEN 0

Examples

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: Main Page with Articles and Tutorials Keyword Reference - Alphabetical Keyword Reference - By usage