AN3128 datasheet(33/105 Pages) STMICROELECTRONICS

33 / 105 page

AN3128

Multi-input embedded GUI library firmware

Doc ID 16918 Rev 5

33/105

4.1.11

NewHistogram API global function

This kind of object is composed of two axes (X & Y) with the relative values printed to the

side, and a certain number of blue columns representing the real distribution of respective

values. The values are saved in a vector of decimal numbers.

A typical example of the application of this object may be reading the distribution of

measured values concerning changing data.

It is possible to change the values of the vectors through the function “SetHistogramPoints”

defined in the following pages, therefore easily integrating such an object into the

application.

Figure 12.

Histogram graphical object

Table 16 describes the NewHistogram function:

Table 16.

NewHistogram API function

Name

Description

Function name

NewHistogram

Function prototype

GL_PageControls_TypeDef* NewHistogram (char* oName, char* LabelX,

char* LabelY, int16_t data_points[], GL_uint8_t n_points);

Behavior description

Create and initialize a new histogram object (a C structure)

Input parameter {x}

oName: object Name

LabelX: Label for the X axis

LabelY: Label for the Y axis

data_points[]: the array of points to be plotted on the LCD pointer to

function associated to its touch event

n_points: number of points to be plotted

Output parameter {x}

None

Return value

The created object pointer or null if the object cannot be created

AN3128 Datasheet(PDF) 33 Page - STMicroelectronics