Method ilcd.Draw.read1D2DRunLengthEncodedScanLine

Package ilcd
Class Draw

Public Method read1D2DRunLengthEncodedScanLine

static void read1D2DRunLengthEncodedScanLine(int prevLineOffset, int noOfPixels, byte[] data)

Throws:

ILCDException

_INSERT_METHOD_SIGNATURE_HERE_

Description:

Parameter	Range	Description
prevLineOffset	-8 ... 8	y-offset of scanline referred to (0 = none = 1D encoded)
noOfPixels	1 ... display width	number of pixel to be scanned
data	0x00 ... 0xFF	array storing run length encoded data

Reads the color information of noOfPixels pixels in a horizontal line from left to right, starting from the current cursor position and writes the run-length encoding data to the data array.

Note

When prevLineOffset is 0 or prevLineOffset + the current row is negative, the data will be 1D encoded.
When prevLineOffset is other than 0 and prevLineOffset + the current row is 0 or higher, 2D ecoding with reference to the relatively specified row is carried out.
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.pdf.

There is also a local 2D Run-Length Encoding Application Note version available which is named as 2D RLE Application Note.pdf, and can be found under the iLCD Manager XEJoC Manager installation path within the Documentation directory. Other useful pdf documents can be downloaded on the www.demmel.com/en/service/downloads.htm website.

Returns	Range	Description
data[0] ... data[1]	2 ... 2 * display width + display width / 32 + 2	length of encoded data in bytes
data[2] ...	0x00 ... 0xFF	run-length encoded data

Example

byte[] data = new byte[2 + 2 * 1024 + 1024 / 32 + 2];

Draw.read1D2DRunLengthEncodedScanLine(0, 50, data);

In this example a buffer for a 1024 pixel wide display has been allocated. Then a line of 50 red pixels has been scanned.