Graphics: Multiple Histogram

The new gMultiple is very close to the gHistogram graphic except that it can display up to four series. 

The gMultiple is a class and contains, apart from the constructor, two functions: dDefine and draw.

It displays:
  • Time is in the horizontal axis, and
  • Values for up to four series are on the vertical axis.

The example shown on the right display the yaw, pitch and roll angles provided by an inertial measurement unit.

Define

The dDefine function defines an multiple graphic with the following parameters:

Required parameters
  • Serial_LCD * lcd0, LCD to which the button belongs, with &myLCD,
  • uint16_t x0, uint16_t y0, point x0, y0, 
  • uint16_t dx, uint16_t dy, x-width dx and y-height dy, 
  • String serie1, float valueMin1, float valueMax1, uint16_t valueColour2 name, minimal and maximal values, colour for first series. 
Optional parameters for other series with default values 
  • String serie2="", float valueMin2=0, float valueMax2=0, uint16_t valueColour2=greenColour name, minimal and maximal values, colour for second series, optional,
When minimal valueMin2 and maximal valueMax2 values are both equal to 0, the series isn't drawn.
  • Same for third series, String serie3="", float valueMin3=0, float valueMax3=0, uint16_t valueColour3=redColour, optional,
  • Same for forth series, String serie3="", float valueMin3=0, float valueMax3=0, uint16_t valueColour3=redColour, optional,
Code Editor

    









					
									

		
	





Draw




	

		
			

				
					
						


The draw() function updates the graphic with the values for each series.

When lapse is set to 0 (default), all values are displayed and there's no control of the period. 

When lapse is defined (>0), the period of time between two consecutive measures is monitored:
  • If the period between last and present draw calls is lower than the defined lapse in ms, the present value isn't taken into account and isn't displayed.
  • If that period is greater than the lapse defined, the time indicator on the lower-right corner is shown in reverse.