test
Adafruit_GFX.h@17:430d21b59723, 2018-11-20 (annotated)
- Committer:
- dkay
- Date:
- Tue Nov 20 06:23:02 2018 +0000
- Revision:
- 17:430d21b59723
- Parent:
- 14:edb3c36aa1a7
test size able
Who changed what in which revision?
User | Revision | Line number | New contents of line |
---|---|---|---|
nkhorman | 9:ddb97c9850a2 | 1 | /*********************************** |
nkhorman | 9:ddb97c9850a2 | 2 | This is a our graphics core library, for all our displays. |
nkhorman | 9:ddb97c9850a2 | 3 | We'll be adapting all the |
nkhorman | 9:ddb97c9850a2 | 4 | existing libaries to use this core to make updating, support |
nkhorman | 9:ddb97c9850a2 | 5 | and upgrading easier! |
nkhorman | 9:ddb97c9850a2 | 6 | |
nkhorman | 9:ddb97c9850a2 | 7 | Adafruit invests time and resources providing this open source code, |
nkhorman | 9:ddb97c9850a2 | 8 | please support Adafruit and open-source hardware by purchasing |
nkhorman | 9:ddb97c9850a2 | 9 | products from Adafruit! |
nkhorman | 9:ddb97c9850a2 | 10 | |
nkhorman | 9:ddb97c9850a2 | 11 | Written by Limor Fried/Ladyada for Adafruit Industries. |
nkhorman | 9:ddb97c9850a2 | 12 | BSD license, check license.txt for more information |
nkhorman | 9:ddb97c9850a2 | 13 | All text above must be included in any redistribution |
nkhorman | 9:ddb97c9850a2 | 14 | ****************************************/ |
nkhorman | 9:ddb97c9850a2 | 15 | |
nkhorman | 9:ddb97c9850a2 | 16 | /* |
nkhorman | 9:ddb97c9850a2 | 17 | * Modified by Neal Horman 7/14/2012 for use in mbed |
nkhorman | 9:ddb97c9850a2 | 18 | */ |
nkhorman | 9:ddb97c9850a2 | 19 | |
nkhorman | 9:ddb97c9850a2 | 20 | #ifndef _ADAFRUIT_GFX_H_ |
nkhorman | 9:ddb97c9850a2 | 21 | #define _ADAFRUIT_GFX_H_ |
nkhorman | 9:ddb97c9850a2 | 22 | |
dkay | 17:430d21b59723 | 23 | #define GFX_SIZEABLE_TEXT |
dkay | 17:430d21b59723 | 24 | |
nkhorman | 13:8f03f908f22a | 25 | #include "Adafruit_GFX_Config.h" |
nkhorman | 9:ddb97c9850a2 | 26 | |
nkhorman | 9:ddb97c9850a2 | 27 | static inline void swap(int16_t &a, int16_t &b) |
nkhorman | 9:ddb97c9850a2 | 28 | { |
nkhorman | 9:ddb97c9850a2 | 29 | int16_t t = a; |
nkhorman | 9:ddb97c9850a2 | 30 | |
nkhorman | 9:ddb97c9850a2 | 31 | a = b; |
nkhorman | 9:ddb97c9850a2 | 32 | b = t; |
nkhorman | 9:ddb97c9850a2 | 33 | } |
nkhorman | 9:ddb97c9850a2 | 34 | |
nkhorman | 9:ddb97c9850a2 | 35 | #ifndef _BV |
nkhorman | 9:ddb97c9850a2 | 36 | #define _BV(bit) (1<<(bit)) |
nkhorman | 9:ddb97c9850a2 | 37 | #endif |
nkhorman | 9:ddb97c9850a2 | 38 | |
nkhorman | 9:ddb97c9850a2 | 39 | #define BLACK 0 |
nkhorman | 9:ddb97c9850a2 | 40 | #define WHITE 1 |
nkhorman | 9:ddb97c9850a2 | 41 | |
nkhorman | 11:86909e6db3c8 | 42 | /** |
nkhorman | 11:86909e6db3c8 | 43 | * This is a Text and Graphics element drawing class. |
nkhorman | 11:86909e6db3c8 | 44 | * These functions draw to the display buffer. |
nkhorman | 11:86909e6db3c8 | 45 | * |
nkhorman | 11:86909e6db3c8 | 46 | * Display drivers should be derived from here. |
nkhorman | 11:86909e6db3c8 | 47 | * The Display drivers push the display buffer to the |
nkhorman | 11:86909e6db3c8 | 48 | * hardware based on application control. |
nkhorman | 11:86909e6db3c8 | 49 | * |
nkhorman | 11:86909e6db3c8 | 50 | */ |
nkhorman | 9:ddb97c9850a2 | 51 | class Adafruit_GFX : public Stream |
nkhorman | 9:ddb97c9850a2 | 52 | { |
nkhorman | 9:ddb97c9850a2 | 53 | public: |
nkhorman | 9:ddb97c9850a2 | 54 | Adafruit_GFX(int16_t w, int16_t h) |
nkhorman | 9:ddb97c9850a2 | 55 | : _rawWidth(w) |
nkhorman | 9:ddb97c9850a2 | 56 | , _rawHeight(h) |
nkhorman | 9:ddb97c9850a2 | 57 | , _width(w) |
nkhorman | 9:ddb97c9850a2 | 58 | , _height(h) |
nkhorman | 9:ddb97c9850a2 | 59 | , cursor_x(0) |
nkhorman | 9:ddb97c9850a2 | 60 | , cursor_y(0) |
nkhorman | 9:ddb97c9850a2 | 61 | , textcolor(WHITE) |
nkhorman | 9:ddb97c9850a2 | 62 | , textbgcolor(BLACK) |
nkhorman | 9:ddb97c9850a2 | 63 | , textsize(1) |
nkhorman | 9:ddb97c9850a2 | 64 | , rotation(0) |
nkhorman | 9:ddb97c9850a2 | 65 | , wrap(true) |
nkhorman | 9:ddb97c9850a2 | 66 | {}; |
nkhorman | 9:ddb97c9850a2 | 67 | |
nkhorman | 11:86909e6db3c8 | 68 | /// Paint one BLACK or WHITE pixel in the display buffer |
nkhorman | 9:ddb97c9850a2 | 69 | // this must be defined by the subclass |
nkhorman | 9:ddb97c9850a2 | 70 | virtual void drawPixel(int16_t x, int16_t y, uint16_t color) = 0; |
nkhorman | 9:ddb97c9850a2 | 71 | // this is optional |
nkhorman | 9:ddb97c9850a2 | 72 | virtual void invertDisplay(bool i) {}; |
nkhorman | 9:ddb97c9850a2 | 73 | |
nkhorman | 9:ddb97c9850a2 | 74 | // Stream implementation - provides printf() interface |
nkhorman | 9:ddb97c9850a2 | 75 | // You would otherwise be forced to use writeChar() |
nkhorman | 9:ddb97c9850a2 | 76 | virtual int _putc(int value) { return writeChar(value); }; |
nkhorman | 9:ddb97c9850a2 | 77 | virtual int _getc() { return -1; }; |
nkhorman | 9:ddb97c9850a2 | 78 | |
nkhorman | 9:ddb97c9850a2 | 79 | #ifdef GFX_WANT_ABSTRACTS |
nkhorman | 9:ddb97c9850a2 | 80 | // these are 'generic' drawing functions, so we can share them! |
nkhorman | 11:86909e6db3c8 | 81 | |
nkhorman | 11:86909e6db3c8 | 82 | /** Draw a Horizontal Line |
nkhorman | 11:86909e6db3c8 | 83 | * @note GFX_WANT_ABSTRACTS must be defined in Adafruit_GFX_config.h |
nkhorman | 11:86909e6db3c8 | 84 | */ |
nkhorman | 9:ddb97c9850a2 | 85 | virtual void drawFastHLine(int16_t x, int16_t y, int16_t w, uint16_t color); |
nkhorman | 11:86909e6db3c8 | 86 | /** Draw a rectangle |
nkhorman | 11:86909e6db3c8 | 87 | * @note GFX_WANT_ABSTRACTS must be defined in Adafruit_GFX_config.h |
nkhorman | 11:86909e6db3c8 | 88 | */ |
nkhorman | 9:ddb97c9850a2 | 89 | virtual void drawRect(int16_t x, int16_t y, int16_t w, int16_t h, uint16_t color); |
nkhorman | 11:86909e6db3c8 | 90 | /** Fill the entire display |
nkhorman | 11:86909e6db3c8 | 91 | * @note GFX_WANT_ABSTRACTS must be defined in Adafruit_GFX_config.h |
nkhorman | 11:86909e6db3c8 | 92 | */ |
nkhorman | 9:ddb97c9850a2 | 93 | virtual void fillScreen(uint16_t color); |
nkhorman | 9:ddb97c9850a2 | 94 | |
nkhorman | 11:86909e6db3c8 | 95 | /** Draw a circle |
nkhorman | 11:86909e6db3c8 | 96 | * @note GFX_WANT_ABSTRACTS must be defined in Adafruit_GFX_config.h |
nkhorman | 11:86909e6db3c8 | 97 | */ |
nkhorman | 9:ddb97c9850a2 | 98 | void drawCircle(int16_t x0, int16_t y0, int16_t r, uint16_t color); |
nkhorman | 9:ddb97c9850a2 | 99 | void drawCircleHelper(int16_t x0, int16_t y0, int16_t r, uint8_t cornername, uint16_t color); |
nkhorman | 11:86909e6db3c8 | 100 | |
nkhorman | 11:86909e6db3c8 | 101 | /** Draw and fill a circle |
nkhorman | 11:86909e6db3c8 | 102 | * @note GFX_WANT_ABSTRACTS must be defined in Adafruit_GFX_config.h |
nkhorman | 11:86909e6db3c8 | 103 | */ |
nkhorman | 9:ddb97c9850a2 | 104 | void fillCircle(int16_t x0, int16_t y0, int16_t r, uint16_t color); |
nkhorman | 9:ddb97c9850a2 | 105 | void fillCircleHelper(int16_t x0, int16_t y0, int16_t r, uint8_t cornername, int16_t delta, uint16_t color); |
nkhorman | 9:ddb97c9850a2 | 106 | |
nkhorman | 11:86909e6db3c8 | 107 | /** Draw a triangle |
nkhorman | 11:86909e6db3c8 | 108 | * @note GFX_WANT_ABSTRACTS must be defined in Adafruit_GFX_config.h |
nkhorman | 11:86909e6db3c8 | 109 | */ |
nkhorman | 9:ddb97c9850a2 | 110 | void drawTriangle(int16_t x0, int16_t y0, int16_t x1, int16_t y1, int16_t x2, int16_t y2, uint16_t color); |
nkhorman | 11:86909e6db3c8 | 111 | /** Draw and fill a triangle |
nkhorman | 11:86909e6db3c8 | 112 | * @note GFX_WANT_ABSTRACTS must be defined in Adafruit_GFX_config.h |
nkhorman | 11:86909e6db3c8 | 113 | */ |
nkhorman | 9:ddb97c9850a2 | 114 | void fillTriangle(int16_t x0, int16_t y0, int16_t x1, int16_t y1, int16_t x2, int16_t y2, uint16_t color); |
nkhorman | 11:86909e6db3c8 | 115 | |
nkhorman | 11:86909e6db3c8 | 116 | /** Draw a rounded rectangle |
nkhorman | 11:86909e6db3c8 | 117 | * @note GFX_WANT_ABSTRACTS must be defined in Adafruit_GFX_config.h |
nkhorman | 11:86909e6db3c8 | 118 | */ |
nkhorman | 9:ddb97c9850a2 | 119 | void drawRoundRect(int16_t x0, int16_t y0, int16_t w, int16_t h, int16_t radius, uint16_t color); |
nkhorman | 11:86909e6db3c8 | 120 | /** Draw and fill a rounded rectangle |
nkhorman | 11:86909e6db3c8 | 121 | * @note GFX_WANT_ABSTRACTS must be defined in Adafruit_GFX_config.h |
nkhorman | 11:86909e6db3c8 | 122 | */ |
nkhorman | 9:ddb97c9850a2 | 123 | void fillRoundRect(int16_t x0, int16_t y0, int16_t w, int16_t h, int16_t radius, uint16_t color); |
nkhorman | 14:edb3c36aa1a7 | 124 | /** Draw a bitmap |
nkhorman | 14:edb3c36aa1a7 | 125 | * @note GFX_WANT_ABSTRACTS must be defined in Adafruit_GFX_config.h |
nkhorman | 14:edb3c36aa1a7 | 126 | */ |
nkhorman | 14:edb3c36aa1a7 | 127 | void drawBitmap(int16_t x, int16_t y, const uint8_t *bitmap, int16_t w, int16_t h, uint16_t color); |
nkhorman | 9:ddb97c9850a2 | 128 | #endif |
nkhorman | 9:ddb97c9850a2 | 129 | |
nkhorman | 9:ddb97c9850a2 | 130 | #if defined(GFX_WANT_ABSTRACTS) || defined(GFX_SIZEABLE_TEXT) |
nkhorman | 11:86909e6db3c8 | 131 | /** Draw a line |
nkhorman | 11:86909e6db3c8 | 132 | * @note GFX_WANT_ABSTRACTS or GFX_SIZEABLE_TEXT must be defined in Adafruit_GFX_config.h |
nkhorman | 11:86909e6db3c8 | 133 | */ |
nkhorman | 9:ddb97c9850a2 | 134 | virtual void drawLine(int16_t x0, int16_t y0, int16_t x1, int16_t y1, uint16_t color); |
nkhorman | 11:86909e6db3c8 | 135 | /** Draw a vertical line |
nkhorman | 11:86909e6db3c8 | 136 | * @note GFX_WANT_ABSTRACTS or GFX_SIZEABLE_TEXT must be defined in Adafruit_GFX_config.h |
nkhorman | 11:86909e6db3c8 | 137 | */ |
nkhorman | 9:ddb97c9850a2 | 138 | virtual void drawFastVLine(int16_t x, int16_t y, int16_t h, uint16_t color); |
nkhorman | 11:86909e6db3c8 | 139 | /** Draw and fill a rectangle |
nkhorman | 11:86909e6db3c8 | 140 | * @note GFX_WANT_ABSTRACTS or GFX_SIZEABLE_TEXT must be defined in Adafruit_GFX_config.h |
nkhorman | 11:86909e6db3c8 | 141 | */ |
nkhorman | 9:ddb97c9850a2 | 142 | virtual void fillRect(int16_t x, int16_t y, int16_t w, int16_t h, uint16_t color); |
nkhorman | 9:ddb97c9850a2 | 143 | #endif |
nkhorman | 9:ddb97c9850a2 | 144 | |
nkhorman | 11:86909e6db3c8 | 145 | /// Draw a text character at a specified pixel location |
nkhorman | 9:ddb97c9850a2 | 146 | void drawChar(int16_t x, int16_t y, unsigned char c, uint16_t color, uint16_t bg, uint8_t size); |
nkhorman | 11:86909e6db3c8 | 147 | /// Draw a text character at the text cursor location |
nkhorman | 9:ddb97c9850a2 | 148 | size_t writeChar(uint8_t); |
nkhorman | 9:ddb97c9850a2 | 149 | |
nkhorman | 11:86909e6db3c8 | 150 | /// Get the width of the display in pixels |
nkhorman | 14:edb3c36aa1a7 | 151 | inline int16_t width(void) { return _width; }; |
nkhorman | 11:86909e6db3c8 | 152 | /// Get the height of the display in pixels |
nkhorman | 14:edb3c36aa1a7 | 153 | inline int16_t height(void) { return _height; }; |
nkhorman | 9:ddb97c9850a2 | 154 | |
nkhorman | 11:86909e6db3c8 | 155 | /// Set the text cursor location, based on the size of the text |
nkhorman | 14:edb3c36aa1a7 | 156 | inline void setTextCursor(int16_t x, int16_t y) { cursor_x = x; cursor_y = y; }; |
nkhorman | 14:edb3c36aa1a7 | 157 | #if defined(GFX_WANT_ABSTRACTS) || defined(GFX_SIZEABLE_TEXT) |
nkhorman | 11:86909e6db3c8 | 158 | /** Set the size of the text to be drawn |
nkhorman | 11:86909e6db3c8 | 159 | * @note Make sure to enable either GFX_SIZEABLE_TEXT or GFX_WANT_ABSTRACTS |
nkhorman | 11:86909e6db3c8 | 160 | */ |
nkhorman | 14:edb3c36aa1a7 | 161 | inline void setTextSize(uint8_t s) { textsize = (s > 0) ? s : 1; }; |
nkhorman | 9:ddb97c9850a2 | 162 | #endif |
nkhorman | 11:86909e6db3c8 | 163 | /// Set the text foreground and background colors to be the same |
nkhorman | 14:edb3c36aa1a7 | 164 | inline void setTextColor(uint16_t c) { textcolor = c; textbgcolor = c; } |
nkhorman | 11:86909e6db3c8 | 165 | /// Set the text foreground and background colors independantly |
nkhorman | 14:edb3c36aa1a7 | 166 | inline void setTextColor(uint16_t c, uint16_t b) { textcolor = c; textbgcolor = b; }; |
nkhorman | 11:86909e6db3c8 | 167 | /// Set text wraping mode true or false |
nkhorman | 14:edb3c36aa1a7 | 168 | inline void setTextWrap(bool w) { wrap = w; }; |
nkhorman | 9:ddb97c9850a2 | 169 | |
nkhorman | 11:86909e6db3c8 | 170 | /// Set the display rotation, 1, 2, 3, or 4 |
nkhorman | 9:ddb97c9850a2 | 171 | void setRotation(uint8_t r); |
nkhorman | 11:86909e6db3c8 | 172 | /// Get the current rotation |
nkhorman | 14:edb3c36aa1a7 | 173 | inline uint8_t getRotation(void) { rotation %= 4; return rotation; }; |
nkhorman | 9:ddb97c9850a2 | 174 | |
nkhorman | 9:ddb97c9850a2 | 175 | protected: |
nkhorman | 9:ddb97c9850a2 | 176 | int16_t _rawWidth, _rawHeight; // this is the 'raw' display w/h - never changes |
nkhorman | 9:ddb97c9850a2 | 177 | int16_t _width, _height; // dependent on rotation |
nkhorman | 9:ddb97c9850a2 | 178 | int16_t cursor_x, cursor_y; |
nkhorman | 9:ddb97c9850a2 | 179 | uint16_t textcolor, textbgcolor; |
nkhorman | 9:ddb97c9850a2 | 180 | uint8_t textsize; |
nkhorman | 9:ddb97c9850a2 | 181 | uint8_t rotation; |
nkhorman | 9:ddb97c9850a2 | 182 | bool wrap; // If set, 'wrap' text at right edge of display |
nkhorman | 9:ddb97c9850a2 | 183 | }; |
nkhorman | 9:ddb97c9850a2 | 184 | |
nkhorman | 9:ddb97c9850a2 | 185 | #endif |