DECRARA—Reverse Attributes in Rectangular Area
This control function lets you reverse the visual character attributes (bold, blink, reverse video, and underline) of a specified rectangular area in page memory. The select attribute change extent (DECSACE) control function determines whether all or some of the character positions in the rectangle are affected.
Reversing a visual attribute means changing the attribute to its opposite setting, on or off. For example, DECRARA can change characters from bold and not underlined to characters that are underlined and not bold. DECRARA does not change the values of characters, just the visual attributes of those characters.
Available in: VT Level 4 mode only
Format
| CSI 9/11 |
Pt; Pl; Pb; Pr; area to be reversed |
Ps1; . . . Psn attributes to reverse |
$ 2/4 |
t 7/4 |
Parameters
Pt, Pl, Pb, and Pr
define the rectangular area to be reversed.
Pt is the top-line border. Pt must be less than or equal to Pb.
Default: Pt = 1.
Pl is the left-column border. Pl must be less than or equal to Pr.
Default: Pr = 1.
Pb is the bottom-line border.
Default: Pb = last line of the active page.
Pr is the right-column border.
Default: Pr = last column of the active page.
Ps1; . . . Psn
select the visual character attributes to reverse. These values correspond to the
values used in the select graphic rendition (SGR) function.
| Ps | Meaning |
|---|---|
| 0 | Reverse all attributes (default). |
| 1 | Reverse the bold attribute. |
| 4 | Reverse the underline attribute. |
| 5 | Reverse the blink attribute. |
| 7 | Reverse the negative-image attribute. |
DECRARA ignores all other parameter values.
When you use more than one parameter in a command, DECRARA executes them cumulatively in sequence.
Examples
The following sequence reverses the blink and underscore attributes of the complete screen:
CSI ; ; ; ; 0; 4; 5; $t
The following sequence reverses all attributes except the blink attribute, from position line 10, column 2 to position line 14, column 45 on the current page:
CSI 10; 2; 14; 45; 1; 4; 7 $ t
Notes on DECRARA
- The coordinates of the rectangular area are affected by the setting of origin mode (DECOM).
- DECRARA is not affected by the page margins.
- If the value of Pt, Pl, Pb, or Pr exceeds the width or height of the active page, then the value is treated as the width or height of that page.
- DECRARA does not change the active cursor position.
- DECRARA does not change the current rendition set by the select graphic rendition (SGR) function.
- The exact character positions affected by DECRARA depend on the current setting of the select attribute change extent (DECSACE) function.