Draw Rectangle

\i D R bits::mode word::width word::height

Parameter	Type	Range	Description
mode	bits	Bit 0 ... 7	flags for the rectangle properties
width	word	1 ... display width	width of the rectangle
height	word	1 ... display height	height of the rectangle

Draws a rectangle starting from the current cursor position to the ending point specified via width and height. The parameter mode allows to set several properties for the rectangle:

Bit	Description
0	rounded corners
1	drop shadow
2	surrounded with background color
3	filled with background color
4	use foreground color for filling (bit 3 must be set too)
5	filled with current fill pattern (bits 3 and 4 ignored if set)
6	draw without frame
7	alpha blending for shadow only

• If mode bit 6 is not set, the rectangle frame is drawn with the current border color (see Set Border Color). If the line thickness is greater than 1 (refer to Set Line Thickness), the lines of the rectangle expand to both sides of the specified corner points.
• By default, alpha blending is done for every activated feature (frame, filling, shadow). When mode bit 7 is set, the shadow will still be drawn with alpha blending, but frame and filling will have full opacity (refer to Set Alpha).
• The rectangle frame is drawn with regard to the current line style (see Set Line Style) only if the corner radius and alpha are set to their default values (refer to Set Rectangle Corner Radius and Set Alpha).
• If mode bit 1 is set, the drop shadow is drawn with the border shadow color (see Set Border Shadow Color) with regard to the current shadow offset (see Set Shadow Offset). If the offset leads to a negative left/upper corner of the shadow rectangle, no shadow will be drawn.
• When filling with a pattern (mode bit 5), the fill pattern has to be set in advance via Set Filling Color, Set Filling Gradient or Set Filling Tile. When filling with a tile graphic, any previously set adjustments for graphics are taken into account (see Set Adjustment for Graphics).
• When the rounded corners flag (mode bit 0) is set, the attribute rectangle corner radius is taken into account (see Set Rectangle Corner Radius). If the corner radius exceeds half of the rectangle width and/or height, the flag is ignored and a rectangle without rounded corners is drawn.
• The surrounding line (mode bit 2) is only drawn when corner radius and alpha are set to their default values (refer to Set Rectangle Corner Radius and Set Alpha) and a frame is drawn (mode bit 6 is not set).
• Filling with a fill pattern as well as drawing without a frame (mode bits 5 and 6) are supported by firmware versions 4.20 and higher. In previous versions, those bits are ignored.

Response:

[ACK]

Example

\iDR\x3\D50\D30

Draws a rectangle with a width of 50 pixels and a height of 30 pixels. Moreover, the rectangle has rounded corners and a drop shadow.

Draw Circle
Draw Styled Circle
Get Cursor Position
Set Inverse Mode
Set Line Style
Set Border Color
Set Border Shadow Color
Set Line Thickness
Set Line Caps Style
Set Filling Color
Set Filling Gradient
Set Filling Tile
Set Alpha
Erase Display Area