Component: GLCD Graph Creator (Graphical Library)

Author	Matrix TSL
Version	1.2
Category	Graphical Library

GLCD Graph Creator component

A component to simplify the process of drawing graphs and charts using a graphical LCD.

Component Source Code

Please click here for the component source code: FC_Comp_Source_Lib_GLCD_Graph.fcfx

Detailed description

No detailed description exists yet for this component

Examples

The graph creator component must be linked to the graphical LCD using the gLCD Object property.

The X Coord, Y Coord, Width and Height component properties set the size and position of the graph on the gLCD.

In the attached example the ADC component sets the input to the graph. Every 50ms a sample is taken and added to the graph.

Graph Creator Demo

Any size of graph can be created. For efficiency it is best to try and stick to the following rules.

• The width should be equal to or a multiple of the number of points
• The height should be equal to or a division of the input range - Min Value 0 to Max Value 255 = input range of 256
• If Show Border is enabled then Width and Height should be as above plus 2 to account for the border pixels

Macro reference

	AddPoint
Adds a new data point to the graph.
- INT	Data
Data Value to plot
- BYTE	Index
Plot Index: Range 0-7
- VOID	Return

	Initialise
Initialises the graph object on the GLCD to the specified dimensions.
- VOID	Return

Property reference

	Properties
	Display Properties
	LinkTo
Graphical LCD Object to draw the graph on
	ColourDisplay
Automatically detects if the graphical LCD object is colour or monochrome
	X Coord
X coordinate for the top left of the graph container rectangle
	Y Coord
Y coordinate for the top left of the graph container rectangle
	Width
Horizontal size of the graph in pixels
	Height
Vertical size of the graph in pixels
	Graph Properties
	Number Of Plots
Determines the number of plots that can be displayed simultaneously on the graph. Monochrome displays can only support a single plot.
	Number Of Points
Number of data points the graph can store, multiplied by the number of plots.
	Scrolling
Controls how data is drawn onto the display. Scrolling is useful for slower data where you want a constant plot with the right hand side always being the latest data. None scrolling is useful for faster data such as audio snippets.
	Graph Style
Controls the graph draw style. Point - Draws a single point Line - Draws a line from the last point to the new point
	Min Value
Value to represent the bottom Y axis on the graph
	Max Value
Value to represent the top Y axis on the graph
	Show Border
Decides if a border for the graph is generated
	Show Grid
Decides if a X or Y grid is shown for the graph
	Theme
	Background Colour
Determines the graph background colour.
	Plot 0 Colour
Determines the graph plot colour.