.Setpixel Method

Top  Previous  Next

Function:

Directly writes pixel data for a single pixel into the controller's memory.

Syntax:

lcd.setpixel(dt as word,x as word,y as word)

Returns:

---

See Also:

Working With Pixels and Colors, Understanding Controller Properties

 


Part

Description

dt

Pixel data to write.

x

X coordinate of the pixel. Value range is 0 to lcd.width-1.

y

Y coordinate of the pixel. Value range is 0 to lcd.height-1.

Details

Interpretation of the dt argument depends on the selected controller/panel. Selection is made through the Customize Platform dialog, accessible through the Project Settings dialog.

The dt argument is of word type, but only lcd.bitsperpixel lower bits of this value will be relevant. All higher bits will be ignored.

For monochrome and grayscale controllers/panels (lcd.paneltype= 0- PL_LCD_PANELTYPE_GRAYSCALE), the value of the dt argument sets the brightness of the pixel. For color panels/controllers (lcd.paneltype= 1- PL_LCD_PANELTYPE_COLOR) the value is composed of three fields -- one for the red, green, and blue "channels". Check lcd.redbits, lcd.greenbits, and lcd.bluebits properties to see how the fields are combined into the dt word.

The display panel must be enabled (lcd.enabled= 1- YES) for this method to work.