Difference between revisions of "PRINTMODE"

From QB64 Wiki
Jump to navigation Jump to search
imported>Clippy
m
imported>Clippy
m
Line 4: Line 4:
  
 
{{PageSyntax}}
 
{{PageSyntax}}
:: '''_PRINTMODE''' {{Parameter|mode}}[,{{Parameter|image_handle}}]
+
:: '''_PRINTMODE''' {''_KEEPBACKGROUND''|''_ONLYBACKGROUND''|''_FILLBACKGROUND''}[, {{Parameter|image_handle}}]
  
  
{{PageDescription}}
+
{{Parameters}}
* If the image handle is omitted it will use the current destination image background.
 
 
* One of 3 mode keywords is '''mandatory''' when using this statement to deal with the text background.
 
* 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.
+
:*''_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.
+
:*''_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.
+
:*''_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.
 +
 
 +
 
 +
{{PageDescription}}
 
* Use the [[_PRINTMODE (function)]] to find the current _PRINTMODE setting mode number.
 
* Use the [[_PRINTMODE (function)]] to find the current _PRINTMODE setting mode number.
 
* '''NOTE: The _PRINTMODE statement and function can only be used in graphic screen modes, NOT SCREEN 0'''
 
* '''NOTE: The _PRINTMODE statement and function can only be used in graphic screen modes, NOT SCREEN 0'''

Revision as of 17:26, 22 November 2015

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.


Description

  • Use the _PRINTMODE (function) to find the current _PRINTMODE setting mode number.
  • NOTE: 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



Navigation:
Go to Keyword Reference - Alphabetical
Go to Keyword Reference - By usage
Go to Main WIKI Page