display_graphics.hpp

Go to the documentation of this file.

 
#pragma once
 
 
#include <cmath> // for "abs"
#include "display_fonts.hpp"
#include "display_print.hpp"
 
// Define to enable advanced graphics functions such as drawArc, drawPolygon, drawEllipse etc. 
// Default is ON. Can be turned off to save flash space if not needed.
#define _ADVANCED_GRAPHICS_ENABLE
 
#ifdef _ADVANCED_GRAPHICS_ENABLE
#include <vector>
#endif
 
class displaylib_graphics : public displaylib_fonts , public Print 
{
 
 public:
 
    displaylib_graphics(int16_t w, int16_t h); // Constructor
 
    enum PixelColor : uint8_t {
        BG_COLOR  = 0,  
        FG_COLOR  = 1,  
        INVERSE   = 2   
    };
 
    enum display_rotate_e : uint8_t
    {
        rDegrees_0 =   0,    
        rDegrees_90 =  1,    
        rDegrees_180 = 2,    
        rDegrees_270 = 3     
    };
 
    virtual void drawPixel(int16_t x, int16_t y, uint8_t color) = 0;
    // Graphics functions
    void drawLine(int16_t x0, int16_t y0, int16_t x1, int16_t y1, uint8_t color);
    void drawFastVLine(int16_t x, int16_t y, int16_t h, uint8_t color);
    void drawFastHLine(int16_t x, int16_t y, int16_t w, uint8_t color);
    void drawRect(int16_t x, int16_t y, int16_t w, int16_t h, uint8_t color);
    void fillRect(int16_t x, int16_t y, int16_t w, int16_t h, uint8_t color);
    void fillScreen(uint8_t color);
 
    void drawCircle(int16_t x0, int16_t y0, int16_t r, uint8_t color);
    void fillCircle(int16_t x0, int16_t y0, int16_t r, uint8_t color);
    void drawTriangle(int16_t x0, int16_t y0, int16_t x1, int16_t y1,
      int16_t x2, int16_t y2, uint8_t color);
    void fillTriangle(int16_t x0, int16_t y0, int16_t x1, int16_t y1,
      int16_t x2, int16_t y2, uint8_t color);
    void drawRoundRect(int16_t x0, int16_t y0, int16_t w, int16_t h,
      int16_t radius, uint8_t color);
    void fillRoundRect(int16_t x0, int16_t y0, int16_t w, int16_t h,
      int16_t radius, uint8_t color);
    void setCursor(int16_t x, int16_t y);   
 
    // Text related functions 
    virtual size_t write(uint8_t);
    DisplayRet::Ret_Codes_e writeChar( int16_t x, int16_t y, char value );
    DisplayRet::Ret_Codes_e writeCharString( int16_t x, int16_t y, char *text);
    void setTextWrap(bool w);
 
    void setDrawBitmapAddr(bool mode);
    DisplayRet::Ret_Codes_e  drawBitmap(int16_t x, int16_t y, std::span<const uint8_t> bitmap,
        int16_t w, int16_t h, uint8_t color, uint8_t bg);
 
    int16_t height(void) const;
    int16_t width(void) const;
    display_rotate_e getRotation(void);
    void setRotation(display_rotate_e r);
 
 
#ifdef _ADVANCED_GRAPHICS_ENABLE
    void drawLineAngle(int16_t x, int16_t y, int angle, uint8_t start, 
        uint8_t length, int offset, uint8_t color);
    void drawQuadrilateral(int16_t x0, int16_t y0,int16_t x1, int16_t y1, 
        int16_t x2, int16_t y2, int16_t x3, int16_t y3, uint8_t color);
    void fillQuadrilateral(int16_t x0, int16_t y0,int16_t x1, int16_t y1, 
        int16_t x2, int16_t y2, int16_t x3, int16_t y3, uint8_t color);
    DisplayRet::Ret_Codes_e drawPolygon(int16_t x, int16_t y, uint8_t sides, 
        int16_t diameter, float rotation, bool fill , uint8_t color);
    void drawArc(uint16_t cx, uint16_t cy, uint16_t radius, uint16_t thickness, 
        float startAngle, float endAngle, uint8_t color);
    void drawSimpleArc(int16_t cx, int16_t cy, int16_t radius, float startAngle, 
        float endAngle, uint8_t color);
    void drawEllipse(int16_t cx, int16_t cy, int16_t semiMajorAxis, 
            int16_t semiMinorAxis, bool fill, uint8_t color);
    DisplayRet::Ret_Codes_e drawDotGrid(int16_t x, int16_t y, int16_t w, 
            int16_t h, uint8_t DotGridGap, uint8_t color);
    float getArcAngleMax() const;
    void setArcAngleMax(float arcAngleMax);
    int getArcAngleOffset() const;
    void setArcAngleOffset(int arcAngleOffset);
 
#endif
 
 protected:
    
    const int16_t WIDTH;  
    const int16_t HEIGHT;  
    display_rotate_e  _display_rotate = rDegrees_0; 
    int16_t _width;  
    int16_t _height;  
    int16_t _cursor_x = 0; 
    int16_t _cursor_y = 0;  
    bool _drawBitmapAddr; 
    bool _textwrap = true;  
#ifdef _ADVANCED_GRAPHICS_ENABLE
    float _arcAngleMax = 360.0f; 
    int _arcAngleOffset= 0; 
    float sineFromDegrees(float angle);
    float cosineFromDegrees(float angle);
    void ellipseHelper(uint16_t cx, uint16_t cy, uint16_t x, uint16_t y, uint8_t color);
    void drawArcHelper(uint16_t cx, uint16_t cy, uint16_t radius, uint16_t thickness, float start, float end, uint8_t color);
#endif  
 
        void drawCircleHelper(int16_t x0, int16_t y0, int16_t r, uint8_t cornername,
                            uint8_t color);
        void fillCircleHelper(int16_t x0, int16_t y0, int16_t r, uint8_t cornername,
                                int16_t delta, uint8_t color);
    private:
    inline void swapInt16display(int16_t& a, int16_t& b) {
        int16_t t = a;
        a = b;
        b = t;
    }
};