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

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

struct Pos {
    int x;
    int y;
};

template <typename T> class RingBuffer;
class GwLog;

template <typename T> class Chart {
protected:
    CommonData* commonData;
    GwLog* logger;

    RingBuffer<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 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 dWidth; // Display width
    int dHeight; // Display height
    int timAxis, valAxis; // size of time and value chart axis
    Pos cStart; // 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

    void drawChrt(int8_t chrtIntv, GwApi::BoatValue& currValue); // Draw chart line
    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(int8_t chrtIntv); // Draw time axis of chart, value and lines
    void drawChrtValAxis(); // Draw value axis of chart, value and lines
    void prntCurrValue(GwApi::BoatValue& currValue); // Add current boat data value to chart
    double getAngleRng(double center, size_t amount); // Calculate range between chart center and edges

public:
    // Define default chart range for each boat data type
    static std::map<String, double> dfltChrtRng;

    Chart(RingBuffer<T>& dataBuf, char chrtDir, int8_t chrtSz, 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
};

template <typename T>
std::map<String, double> Chart<T>::dfltChrtRng = {
    { "formatWind", 60.0 * DEG_TO_RAD }, // default course range 60 degrees
    { "formatCourse", 60.0 * DEG_TO_RAD }, // default course range 60 degrees
    { "formatKnots", 5.1 }, // default speed range in m/s
    { "formatDepth", 15.0 }, // default depth range in m
    { "kelvinToC", 30.0 } // default temp range in °C/K
};