Write 1D/2D Run-Length Encoded Scan Line

\i D N w byte::prev_line_offset word::no_of_pixels word::no_of_rle_bytes byte::b0 ...

Parameter	Type	Range	Description
prev_line_offset	signed byte	-8 ... 8	y-offset of scanline referred to (0 = none = 1D encoded)
no_of_pixels	word	1 ... display width	number of pixels to write
no_of_rle_bytes	word	2 ... display width + 2	length of encoded data in bytes
b0 ...	bytes	0x00 ... 0xFF	run-length encoded data

Writes a horizontal scan line consisting of no_of_pixels pixels onto the screen. The no_of_rle_bytes long data is sent with run-length encoding.

• The location where the pixels are written to (where the horizontal line begins) is determined by the current cursor position.
• The column address is incremented after every pixel. If the column address exceeds the right margin during printing, [NACK] is returned and the command processing returns and waits for the next command introducer (\i). Even so, the scan line is drawn correctly until it hits the screen margin.
• When prev_line_offset is 0 or prev_line_offset + the current row is negative, only 1D encoded data will be accepted. When a sequence indicating 2D encoding is received in this case, drawing is aborted and and a [NACK] is returned.
• When prev_line_offset is other than 0 and prev_line_offset + the current row is 0 or higher, the data can include sequences for 2D encoding with reference to the relatively specified row.
• Color values in the reported data are made up as 16-Bit Color Values.
• For detailed information about the encoding algorithm and its usage, please refer to the 2D Run-Length Encoding Application Note.

Response:

[ACK]

Example

\iDNw\0\D50\D3\xB1\X1F00

This example will write 50 blue pixels to the screen, starting from the current cursor position. The encoded data consists of 3 bytes: 0xB1 indicates a horizontal repetition (bit 7 set) of 50 pixels and 0x1F00 is the 16-bit color value for pure blue.

Not supported by: DPC3020, DPC2060, DPC10xx

Read 1D/2D Run-Length Encoded Scan Line
Write Scan Line
Read Scan Line
16-Bit Color Values