esp32-nmea2000-obp60/lib/obp60task/OBPcharts.h

// Function lib for display of boat data in various graphical chart formats
#pragma once
#include "Pagedata.h"
#include "OBP60Extensions.h"

struct Pos {
    int x;
    int y;
};

struct ChartProps {
    double range;
    double step;
};

template <typename T>
class RingBuffer;
class GwLog;

class Chart {
protected:
    CommonData* commonData;
    GwLog* logger;

    RingBuffer<uint16_t>& dataBuf; // Buffer to display
    //char chrtDir; // Chart timeline direction: 'H' = horizontal, 'V' = vertical
    //int8_t chrtSz; // Chart size: [0] = full size, [1] = half size left/top, [2] half size right/bottom
    double dfltRng; // Default range of chart, e.g. 30 = [0..30]
    uint16_t fgColor; // color code for any screen writing
    uint16_t bgColor; // color code for screen background
    bool useSimuData; // flag to indicate if simulation data is active
    String tempFormat; // user defined format for temperature
    double zeroValue; // "0" SI value for temperature

    int dWidth; // Display width
    int dHeight; // Display height
    int top = 44; // chart gap at top of display (25 lines for standard gap + 19 lines for axis labels)
    int bottom = 25; // chart gap at bottom of display to keep space for status line
    int hGap = 11; // gap between 2 horizontal charts; actual gap is 2x <gap>
    int vGap = 17; // gap between 2 vertical charts; actual gap is 2x <gap>
    int timAxis, valAxis; // size of time and value chart axis
    Pos cRoot; // start point of chart area
    double chrtRng; // Range of buffer values from min to max value
    double chrtMin; // Range low end value
    double chrtMax; // Range high end value
    double chrtMid; // Range mid value
    double rngStep; // Defines the step of adjustment (e.g. 10 m/s) for value axis range
    bool recalcRngCntr = false; // Flag for re-calculation of mid value of chart for wind data types

    String dbName, dbFormat; // Name and format of data buffer
    char chrtDataFmt; // Data format of chart: 'S' = size values; 'D' = depth value, 'W' = degree of course or wind; 'R' rotational degrees
    double dbMIN_VAL; // Lowest possible value of buffer of type <T>
    double dbMAX_VAL; // Highest possible value of buffer of type <T>; indicates invalid value in buffer
    size_t bufSize; // History buffer size: 1.920 values for 32 min. history chart
    int count; // current size of buffer
    int numBufVals; // number of wind values available for current interval selection
    int bufStart; // 1st data value in buffer to show
    int numAddedBufVals; // Number of values added to buffer since last display
    size_t currIdx; // Current index in TWD history buffer
    size_t lastIdx; // Last index of TWD history buffer
    size_t lastAddedIdx = 0; // Last index of TWD history buffer when new data was added
    int numNoData; // Counter for multiple invalid data values in a row
    bool bufDataValid = false; // Flag to indicate if buffer data is valid
    int oldChrtIntv = 0; // remember recent user selection of data interval

    double chrtPrevVal; // Last data value in chart area
    int x, y; // x and y coordinates for drawing
    int prevX, prevY; // Last x and y coordinates for drawing

    static constexpr int8_t MIN_FREE_VALUES = 60;
    static constexpr int8_t THRESHOLD_NO_DATA = 3;
    static constexpr int8_t VALAXIS_STEP = 60;

    bool setChartDimensions(const char direction, const int8_t size); //define dimensions and start points for chart
    void drawChrt(const char chrtDir, int8_t& chrtIntv, GwApi::BoatValue& currValue); // Draw chart line
    void getBufStartNSize(int8_t& chrtIntv); // Identify buffer size and buffer start position for chart
    void calcChrtBorders(double& rngMin, double& rngMid, double& rngMax, double& rng); // Calculate chart points for value axis and return range between <min> and <max>
    void drawChrtTimeAxis(const char chrtDir, const int8_t chrtSz, int8_t& chrtIntv); // Draw time axis of chart, value and lines
    void drawChrtValAxis(const char chrtDir, const int8_t chrtSz); // Draw value axis of chart, value and lines
    void prntCurrValue(const char chrtDir, GwApi::BoatValue& currValue); // Add current boat data value to chart
    void prntNoValidData(const char chrtDir); // print message for no valid data available
    double getAngleRng(double center, size_t amount); // Calculate range between chart center and edges
    void prntHorizThreeValueAxisLabel(const GFXfont* font); // print horizontal axis label with only three values: top, mid, and bottom
    void prntHorizMultiValueAxisLabel(const GFXfont* font); // print horizontal axis label with multiple axis lines
    void drawBoldLine(int16_t x1, int16_t y1, int16_t x2, int16_t y2); // Draw chart line with thickness of 2px
    String convNformatLabel(double label); // Convert and format current axis label to user defined format; helper function for easier handling of OBP60Formatter
    String formatLabel(const double& label); // Format current axis label for printing w/o data format conversion (has been done earlier)

public:
    // Define default chart range and range step for each boat data type
    static std::map<String, ChartProps> dfltChrtDta;

    // Chart(RingBuffer<uint16_t>& dataBuf, char chrtDir, int8_t chrtSz, double dfltRng, CommonData& common, bool useSimuData); // Chart object of data chart
    Chart(RingBuffer<uint16_t>& dataBuf, double dfltRng, CommonData& common, bool useSimuData); // Chart object of data chart
    ~Chart();
    // void showChrt(GwApi::BoatValue currValue, int8_t& chrtIntv, bool showCurrValue); // Perform all actions to draw chart
    void showChrt(char chrtDir, int8_t chrtSz, int8_t& chrtIntv, bool showCurrValue, GwApi::BoatValue currValue); // Perform all actions to draw chart
};