DECFRA—Fill Rectangular Area
This control function fills a rectangular area in page memory with a specified character. DECFRA replaces the rectangular area's character positions and attributes with the specified fill character. The fill character assumes the visual character attributes set by the last select graphic rendition (SGR) command. DECFRA does not change the current line attributes.
Available in: VT Level 4 mode only
Format
| CSI 9/11 |
Pch 3/n |
; 3/11 |
Pt; Pl; Pb; Pr 3/n |
$ 2/4 |
x 7/8 |
Parameters
Pch
is the decimal value of the fill character. Pch can be any value from 32 to 126
or from 160 to 255. If Pch is not in this range, then the terminal ignores the
DECFRA command. The decimal value refers to the character in the current GL
or GR in-use table.
Pt; Pl; Pb; Pr
define the rectangular area to be filled:
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 = the last line of the active page.
Pr is the right-column border.
Default: Pr = the last column of the active page.
Notes on DECFRA
- The coordinates of the rectangular area are affected by the setting of origin mode (DECOM).
- DECFRA 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, the value is treated as the width or height of that page.
- DECFRA does not change the active cursor position.