Component: GLCD (ILI9488) (Graphical Color)
| Author | Matrix Ltd |
| Version | 2.0 |
| Category | Graphical Color |
GLCD (ILI9488) component
Graphical display component designed to work with the ILI9488 controller IC Based on the ILI9488 16-bit colour graphical controller IC. Supports Serial, 8-bit and 16-bit interface modes.
Detailed description
Information on the Fonts available for this component are available here. GLCD Font Subcomponent
Examples
No additional examples
Macro reference
BPlot
|
BPlot |
| Sets a pixel with the current background colour at pixel location X, Y. | |
 - UINT
|
X1 |
| - UINT
|
Y1 |
 - VOID
|
Return |
BacklightOff
|
|
BacklightOff |
| Clears the backlight enable pin allowing the display backlight to switch off. Switching the backlight on and off at high speed allow the light to be dimmed. | |
| - VOID
|
Return |
BacklightOn
|
|
BacklightOn |
| Sets the backlight enable pin allowing the display backlight to switch on. Switching the backlight on and off at high speed allow the light to be dimmed. | |
| - VOID
|
Return |
ClearDisplay
|
|
ClearDisplay |
| This macro clears the display of any previous output by overwriting the entire display with the background colour. | |
| - VOID
|
Return |
DrawArc
|
|
DrawArc |
| Draws an arc either as an outline or as a filled object. | |
| - UINT
|
X |
| Center X coordinate | |
| - UINT
|
Y |
| Center Y coordinate | |
| - UINT
|
Radius |
| Radius, distance of edge from the centre coordinates | |
 - FLOAT
|
StartAngle |
| Angle to start drawing, in degrees | |
| - FLOAT
|
EndAngle |
| Angle to end drawing, in degrees | |
| - UINT
|
Resolution |
| Number of lines to draw from the center to the outer edge, 0=Fill | |
 - BYTE
|
Transparent |
| Chooses the transparency - 0 = Arc contains background colour, 1 = Arc contains previous pixel data. | |
| - BYTE
|
Solid |
| Chooses to fill with colour - 0 = Arc transparency data, 1 = Arc contains foreground colour. | |
| - VOID
|
Return |
DrawCircle
|
|
DrawCircle |
| Draws a circle object on the display with the center of the circle at the location X,Y | |
| - UINT
|
X |
| X Coordinate for the center of the circle | |
| - UINT
|
Y |
| Y coordinate for the center of the circle | |
| - UINT
|
Radius |
| Radius of the circle specified in pixels | |
| - BYTE
|
Transparent |
| 0=Fill inside circle using background colour / 1=Draw outer circle only | |
| - BYTE
|
Solid |
| 0=Use Transparent Setting / 1=Fill with foreground colour | |
| - VOID
|
Return |
DrawEllipse
|
|
DrawEllipse |
| Draws an ellipse object on the display with the center of the ellipse at the location X,Y | |
| - UINT
|
X |
| X Coordinate for the center of the circle | |
| - UINT
|
Y |
| Y coordinate for the center of the circle | |
| - UINT
|
XRadius |
| Radius of the circle on the X axis specified in pixels | |
| - UINT
|
YRadius |
| Radius of the circle on the Y axis specified in pixels | |
| - BYTE
|
Transparent |
| 0=Fill inside circle using background colour / 1=Draw outer circle only | |
| - BYTE
|
Solid |
| 0=Use Transparent Setting / 1=Fill with foreground colour | |
| - VOID
|
Return |
DrawLine
|
|
DrawLine |
| Draws a line with the current foreground colour from pixel location X1, Y1 to pixel location X2, Y2. | |
| - UINT
|
X1 |
| - UINT
|
Y1 |
| - UINT
|
X2 |
| - UINT
|
Y2 |
| - VOID
|
Return |
DrawRectangle
|
|
DrawRectangle |
| Draws a rectangle with the current foreground colour from pixel loaction X1, Y1 to pixel location X2, Y2 | |
| - UINT
|
X1 |
| - UINT
|
Y1 |
| - UINT
|
X2 |
| - UINT
|
Y2 |
| - BYTE
|
Transparent |
| Chooses the transparency of the box - 0 = Box contains background colour, 1 = Box contains previous pixel data. | |
| - BYTE
|
Solid |
| Chooses to fill the box with colour - 0 = Box contains transparency data, 1 = Box contains foreground colour. | |
| - VOID
|
Return |
DrawRoundedRectangle
|
|
DrawRoundedRectangle |
| Draws a rectangle with rounded corners | |
| - UINT
|
X1 |
| - UINT
|
Y1 |
| - UINT
|
X2 |
| - UINT
|
Y2 |
| - UINT
|
Radius |
| - BYTE
|
Transparent |
| Chooses the transparency of the box - 0 = Box contains background colour, 1 = Box contains previous pixel data. | |
| - BYTE
|
Solid |
| Chooses to fill the box with colour - 0 = Box contains transparency data, 1 = Box contains foreground colour. | |
| - VOID
|
Return |
FastPlot
|
|
FastPlot |
| Sets a pixel with the current foreground colour at current pixel location. Not compatible with orientations other than 0. | |
| - VOID
|
Return |
Initialise
|
|
Initialise |
| The Init macro must be called once to initialise the Graphical LCD display before any other Graphical LCD component macros are called. | |
| - VOID
|
Return |
LCD_Write_Data8
|
|
LCD_Write_Data8 |
| - BYTE
|
data |
| - VOID
|
Return |
LCD_Write_Reg
|
|
LCD_Write_Reg |
| - BYTE
|
data |
| - VOID
|
Return |
Plot
|
|
Plot |
| Sets a pixel with the current foreground colour at pixel location X, Y. | |
| - UINT
|
X1 |
| - UINT
|
Y1 |
| - VOID
|
Return |
|
|
|
| This macro prints a string of characters to the Graphical LCD. | |
 - STRING
|
Str |
| String of characters to send to the display. | |
| - UINT
|
X1 |
| X pixel coordinate to set the output string position. | |
| - UINT
|
Y1 |
| Y pixel coordinate to set the output string position. | |
| - BYTE
|
Font |
| Selects which Font to use Range: 0 to Font Count | |
| - BYTE
|
Transparent |
| Specifies if the background of the text is drawn - 0 = Background colour is drawn, 1 = Background colour not drawn. | |
| - VOID
|
Return |
PrintNumber
|
|
PrintNumber |
| This macro prints a decimal number to the Graphical LCD. | |
 - INT
|
Number |
| Byte or Integer number to send to the display. | |
| - UINT
|
X |
| X pixel coordinate to set the output string position. | |
| - UINT
|
Y |
| Y pixel coordinate to set the output string position. | |
| - BYTE
|
Font |
| Range: 0 to 31 - 0=5x8, 1=10x8, 2=10x16, 3=5x16, 4-31=Extended Sizes | |
| - BYTE
|
Transparent |
| Specifies if the background of the text is drawn - 0 = Background colour is drawn, 1 = Background colour not drawn. | |
| - VOID
|
Return |
ReadFontStat
|
|
ReadFontStat |
| Gets a stat from the selected embedded ASCII font data. | |
| - BYTE
|
Font |
| Font selection range: 0 to (NumFonts - 1) | |
| - BYTE
|
Index |
| 0=SpaceWidth, 1=PixelHeight | |
| - BYTE
|
Return |
ReadFontWidth
|
|
ReadFontWidth |
| Reads the number of pixel columns used in the selected font | |
| - BYTE
|
Font |
| Font selection range: 0 to (NumFonts - 1) | |
| - BYTE
|
Character |
| ASCII character to get the pixel width e.g. 'A' or 65 | |
| - BYTE
|
Return |
SetBackgroundColour
|
|
SetBackgroundColour |
| Specifies the colour of the background by creating a mixture of red, green and blue. | |
| - BYTE
|
Red |
| 0 - 255 where 0 = no red and 255 = maximum red | |
| - BYTE
|
Green |
| 0 - 255 where 0 = no green and 255 = maximum green | |
| - BYTE
|
Blue |
| 0 - 255 where 0 = no blue and 255 = maximum blue | |
| - VOID
|
Return |
SetDisplayOrientation
|
|
SetDisplayOrientation |
| Controls the way data is printed out on the display allowing multiple different viewing orientations. Default is 0. | |
| - BYTE
|
Orientation |
| 0=Default, 1=90°CW, 2=180°CW, 3=270°CW | |
| - VOID
|
Return |
SetFontScaler
|
|
SetFontScaler |
| Allows the fonts to be scaled up by multiplying the number of pixels on the X and Y. | |
| - BYTE
|
ScaleX |
| Sets the horizontal scale of the font, default 1 | |
| - BYTE
|
ScaleY |
| Sets the vertical scale of the font, default 1 | |
| - VOID
|
Return |
SetForegroundColour
|
|
SetForegroundColour |
| Specifies the colour of the foreground by creating a mixture of red, green and blue. | |
| - BYTE
|
Red |
| 0 - 255 where 0 = no red and 255 = maximum red | |
| - BYTE
|
Green |
| 0 - 255 where 0 = no green and 255 = maximum green | |
| - BYTE
|
Blue |
| 0 - 255 where 0 = no blue and 255 = maximum blue | |
| - VOID
|
Return |
Window
|
|
Window |
| - UINT
|
X1 |
| - UINT
|
Y1 |
| - UINT
|
X2 |
| - UINT
|
Y2 |
| - VOID
|
Return |
Property reference
|
Properties |
|
Dimensions |
|
Pixel Width |
| Width of gLCD canvas measured in pixels. | |
|
|
Pixel Height |
| Heigt of gLCD canvas measured in pixels. | |
|
Flip X |
| Flips the horizontal display axis in hardware. | |
|
|
Flip Y |
| Flips the vertical display axis in hardware. | |
|
|
Colour |
|
|
Monochrome |
| Specifies if the display is capable of colour or monochrome only. | |
|
Foreground Color |
| Specifies the initial foreground color. | |
|
|
Background Color |
| Specifies the initial background color. | |
|
|
Invert Colour |
| No: A set output will light the corresponding LED Yes: A clear output will light the corresponding LED | |
|
|
Bit Depth |
|
|
Colour Bit Depth |
| Total color bit depth for the display. | |
|
|
Red Bit Depth |
| Specifies the red bit depth for the display. | |
|
|
Green Bit Depth |
| Specifies the green bit depth for the display. | |
|
|
Blue Bit Depth |
| Specifies the blue bit depth for the display. | |
|
|
Connections |
|
Connection Type |
|
Write (WR) |
|
|
Read (RD) |
|
|
Use CS |
| Determines if ther CS pin is used or is connected to ground and always enabled | |
|
|
Toggle CS |
| Allows the CS pin to be toggled by the component when communicating with the display. No - Allows for better performace, the display is always enabled Yes - Allows for the display pins to be multiplexed with other functionality without the risk of display corruption | |
|
|
Chip Select (CS) |
| Chip select pin connection | |
|
|
Reg Select (D/C) |
| Instruction / Command pin connection | |
|
|
Use Ports |
| Allows the 8-bit or 16-bit data to be controlled using 8-bit ports. Yes - Ports will be used allowing for better data rates No - individual I/O pins will be used allowing for better flexibility | |
|
|
Data0 |
|
|
Data1 |
|
|
Data2 |
|
|
Data3 |
|
|
Data4 |
|
|
Data5 |
|
|
Data6 |
|
|
Data7 |
|
|
Use Reset |
| Determines if the reset pin is used or if it is simply connected to VCC | |
|
|
Reset |
| Reset pin connection | |
|
|
Use Backlight Pin |
|
|
LED |
| LED backlight strobe pin connection | |
|
|
Fonts |
|
|
Font Count |
| Specifies the number of fonts available to use on the display. | |
|
|
Font 0 |
|
|
Font |
| Font picker to decide which font to use on your display. | |
|
|
Character Spacing |
| Sets the number of blank pixels between each character when printing text. Default 1. | |
|
|
Space Width |
| Sets the number of horizontal pixels used to represent a space character. | |
|
|
Simulation |
|
|
Component Label |
|
Component Label Scale |
| The label scale can be change if the amout of text is too wide for the display | |
|
|
Physical Orientation |
| Rotates the simulated canvas to match the orientation of real world hardware. | |
Component Source Code
Please click here to download the component source project: FC_Comp_Source_GLCD_ILI9488.fcfx
Please click here to view the component source code (Beta): FC_Comp_Source_GLCD_ILI9488.fcfx