DECCARA—Change Attributes in Rectangular Area
This control function lets you change 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. DECCARA 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 changed |
Ps1; . . . Psn attributes to change |
$ 2/4 |
r 7/2 |
Parameters
Pt; Pl; Pb; Pr;
define the rectangular area to be changed. A semicolon (3/11) separates
parameters.
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: Pl = 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 change. These values correspond to the
values used in the select graphic rendition.
| Psn | Meaning |
|---|---|
| 0 (default) |
Attributes off (no bold, no underline, no blink, positive image) |
| 1 | Bold |
| 4 | Underline |
| 5 | Blink |
| 7 | Negative image |
| 22 | No bold |
| 24 | No underline |
| 25 | No blink |
| 27 | Positive image |
DECCARA ignores all other parameter values. When you use more than one parameter in a command, DECCARA executes them cumulatively in sequence.
Examples
The following sequence changes the video attributes of the complete screen to blink and underscore:
CSI ; ; ; ; 0; 4; 5 $ r
The following sequence turns off the blinking character attribute from position line 10, column 2 to position line 14, column 45 on the current page:
CSI 10; 2; 14; 45; 25 $ r
Notes on DECCARA
- The coordinates of the rectangular area are affected by the setting of origin mode (DECOM).
- DECCARA 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.
- DECCARA does not change the active cursor position.
- DECCARA does not change the current rendition set by the select graphic rendition (SGR) function.
- The exact character positions affected by DECCARA depend on the current setting of the select attribute change extent (DECSACE) function.