Macro Language Reference > PIs > Text > <?ttbgc>
  
<?ttbgc>
Description
This command specifies a background for text.
The command consists of a parameter to activate the background, plus a set of keywords that define the background. It can be written in two ways:
1. Activate the background, then provide the background definition in subsequent commands. Here the background definition keywords are separated from the main PI with an underscore:
<?ttbgc 1>
<?ttbgc_color red>
<?ttbgc_mode 1>
2. Activate the background and define it in a single instance of the PI. Note that this time the background definition keywords are separate from the main PI in a comma separated list:
<?ttbgc 1, color=red, mode=1>
This second method is recommended as it is more efficient for PTC ALD.
Syntax
<?ttbgc num:n? keyword:b? ( keyword:b )*>
num
(optional)
1
Show the background
0
Hide the background
no parameter
Use the default setting for the paragraph
keyword
(optional)
color
The color to use when the background is being drawn. If the background is being drawn when the color is changed, the background color will switch to the new color from that position in the stream.
Default: none
mode
The position at which the background is drawn:
1: under the text (default)
0: over the text
drawmode
The behavior of the background when changes in leading occur:
0: draw using the last known values (default)
1: draw based on the maximum extent of the area within the rule
2: draw based on the leading for the entire line
3: draw when font size or leading changes
ignoredir
Determines how the rules are drawn when a mixture of left-to-right and right-to-left text is encountered.
0 (default): the rule is restarted for each portion of text, start/end patterns are drawn in the appropriate order to the text direction.
1: the rule will be drawn as a single rule across all changes in text direction, start/end patterns are drawn in the appropriate paragraph direction.
height
Controls additional space added to the background rule after its initial size has been calculated.
height specifies the additional amount to add to the top of the background
Positive values move the background out, negative values move the background in.
Default = 0
depth
Controls additional space added to the background rule after its initial size has been calculated.
depth specifies the additional amount to add to the bottom of the background
Positive values move the background out, negative values move the background in.
Default = 0