PRINTMODE: Difference between revisions

Latest revision as of 10:53, 26 January 2023

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

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

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.

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

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

@@ Line 23: / Line 23: @@
 ''Example:'' Using _PRINTMODE with [[PRINT]] in a graphic screen mode. The background used is CHR$(219) = █
 {{CodeStart}}
-{{Cl|SCREEN (statement)|SCREEN}} 12
+{{Cl|SCREEN}} 12
 {{Cl|COLOR}} 8: {{Cl|LOCATE}} 10, 10: {{Cl|PRINT}} {{Cl|STRING$}}(3, 219) 'background
 {{Cl|_PRINTMODE}} _KEEPBACKGROUND