Stars

The stars element displays a notation as a number of stars.

Configure

Warning

Ensure the graphics library is included and initialised according to the configuration procedure.

Stars myStars(&myGraphics);

The constructor myStars() creates a stars graphic and sets the link to the graphics myGraphics.

myStars.dDefine(0, 0, x, y,
    1, 5, 1, // valueMin valueMax unit
    myColours.black); // value colour

The required parameters are

• The first line sets the x-y coordinates and the width and height of the graphic;

The optional parameters are

• The second line sets the minimum, maximum and unit for the values.

Both minimum and maximum are included. The number of stars is thus maximum - minimum + 1.

• The third line specifies the colour for the value.

Note

For monochrome and colour e-paper screens, ensure the selected colours are supported.

Use

myStars.draw(value);

draw()

sends the new value.

If the value is strictly inferior to the minimum, no stars are displayed.

If the value is superior or equal to the maximum, all the stars are displayed.

Example

This is the core of the code from example Graphics_Stars.ino.

void displayStars()
{
    myScreen.setOrientation(myOrientation);
    myScreen.clear();
    uint16_t x = myScreen.screenSizeX();
    uint16_t y = myScreen.screenSizeY();

    Stars myStars(&myGraphics);

    myStars.dDefine(0, 0, x, y, 1, 5, 1, myColours.grey);

    for (uint8_t i = 0; i <= 5; i += 1)
    {
        myStars.draw(i);
        myScreen.gText(0, 0, formatString("Stars %i/%i", i, 5));
        myScreen.flushFast();
        wait(1);
    }
}