1 #ifndef _ADAFRUIT_GFX_H 2 #define _ADAFRUIT_GFX_H 12 #include <Adafruit_I2CDevice.h> 13 #include <Adafruit_SPIDevice.h> 32 virtual void drawPixel(int16_t x, int16_t y, uint16_t color) = 0;
38 virtual void writePixel(int16_t x, int16_t y, uint16_t color);
39 virtual void writeFillRect(int16_t x, int16_t y, int16_t w, int16_t h,
41 virtual void writeFastVLine(int16_t x, int16_t y, int16_t h, uint16_t color);
42 virtual void writeFastHLine(int16_t x, int16_t y, int16_t w, uint16_t color);
43 virtual void writeLine(int16_t x0, int16_t y0, int16_t x1, int16_t y1,
58 virtual void drawFastVLine(int16_t x, int16_t y, int16_t h, uint16_t color);
59 virtual void drawFastHLine(int16_t x, int16_t y, int16_t w, uint16_t color);
60 virtual void fillRect(int16_t x, int16_t y, int16_t w, int16_t h,
64 virtual void drawLine(int16_t x0, int16_t y0, int16_t x1, int16_t y1,
66 virtual void drawRect(int16_t x, int16_t y, int16_t w, int16_t h,
70 void drawCircle(int16_t x0, int16_t y0, int16_t r, uint16_t color);
73 void fillCircle(int16_t x0, int16_t y0, int16_t r, uint16_t color);
75 int16_t delta, uint16_t color);
76 void drawEllipse(int16_t x0, int16_t y0, int16_t rw, int16_t rh,
78 void fillEllipse(int16_t x0, int16_t y0, int16_t rw, int16_t rh,
80 void drawTriangle(int16_t x0, int16_t y0, int16_t x1, int16_t y1, int16_t x2,
81 int16_t y2, uint16_t color);
82 void fillTriangle(int16_t x0, int16_t y0, int16_t x1, int16_t y1, int16_t x2,
83 int16_t y2, uint16_t color);
84 void drawRoundRect(int16_t x0, int16_t y0, int16_t w, int16_t h,
85 int16_t radius, uint16_t color);
86 void fillRoundRect(int16_t x0, int16_t y0, int16_t w, int16_t h,
87 int16_t radius, uint16_t color);
88 void drawBitmap(int16_t x, int16_t y,
const uint8_t bitmap[], int16_t w,
89 int16_t h, uint16_t color);
90 void drawBitmap(int16_t x, int16_t y,
const uint8_t bitmap[], int16_t w,
91 int16_t h, uint16_t color, uint16_t bg);
92 void drawBitmap(int16_t x, int16_t y, uint8_t *bitmap, int16_t w, int16_t h,
94 void drawBitmap(int16_t x, int16_t y, uint8_t *bitmap, int16_t w, int16_t h,
95 uint16_t color, uint16_t bg);
96 void drawXBitmap(int16_t x, int16_t y,
const uint8_t bitmap[], int16_t w,
97 int16_t h, uint16_t color);
99 int16_t w, int16_t h);
103 const uint8_t mask[], int16_t w, int16_t h);
105 int16_t w, int16_t h);
106 void drawRGBBitmap(int16_t x, int16_t y,
const uint16_t bitmap[], int16_t w,
108 void drawRGBBitmap(int16_t x, int16_t y, uint16_t *bitmap, int16_t w,
110 void drawRGBBitmap(int16_t x, int16_t y,
const uint16_t bitmap[],
111 const uint8_t mask[], int16_t w, int16_t h);
112 void drawRGBBitmap(int16_t x, int16_t y, uint16_t *bitmap, uint8_t *mask,
113 int16_t w, int16_t h);
114 void drawChar(int16_t x, int16_t y,
unsigned char c, uint16_t color,
115 uint16_t bg, uint8_t size);
116 void drawChar(int16_t x, int16_t y,
unsigned char c, uint16_t color,
117 uint16_t bg, uint8_t size_x, uint8_t size_y);
118 void getTextBounds(
const char *
string, int16_t x, int16_t y, int16_t *x1,
119 int16_t *y1, uint16_t *w, uint16_t *h);
120 void getTextBounds(
const __FlashStringHelper *s, int16_t x, int16_t y,
121 int16_t *x1, int16_t *y1, uint16_t *w, uint16_t *h);
122 void getTextBounds(
const String &str, int16_t x, int16_t y, int16_t *x1,
123 int16_t *y1, uint16_t *w, uint16_t *h);
189 virtual size_t write(uint8_t);
191 virtual void write(uint8_t);
237 void charBounds(
unsigned char c, int16_t *x, int16_t *y, int16_t *minx,
238 int16_t *miny, int16_t *maxx, int16_t *maxy);
261 void initButton(
Adafruit_GFX *gfx, int16_t x, int16_t y, uint16_t w,
262 uint16_t h, uint16_t outline, uint16_t fill,
263 uint16_t
textcolor,
char *label, uint8_t textsize);
264 void initButton(
Adafruit_GFX *gfx, int16_t x, int16_t y, uint16_t w,
265 uint16_t h, uint16_t outline, uint16_t fill,
266 uint16_t textcolor,
char *label, uint8_t
textsize_x,
269 void initButtonUL(
Adafruit_GFX *gfx, int16_t x1, int16_t y1, uint16_t w,
270 uint16_t h, uint16_t outline, uint16_t fill,
271 uint16_t textcolor,
char *label, uint8_t textsize);
272 void initButtonUL(
Adafruit_GFX *gfx, int16_t x1, int16_t y1, uint16_t w,
273 uint16_t h, uint16_t outline, uint16_t fill,
274 uint16_t textcolor,
char *label, uint8_t textsize_x,
276 void drawButton(
bool inverted =
false);
277 bool contains(int16_t x, int16_t y);
286 laststate = currstate;
307 uint16_t _outlinecolor, _fillcolor, _textcolor;
310 bool currstate, laststate;
316 GFXcanvas1(uint16_t w, uint16_t h,
bool allocate_buffer =
true);
318 void drawPixel(int16_t x, int16_t y, uint16_t color);
320 void drawFastVLine(int16_t x, int16_t y, int16_t h, uint16_t color);
321 void drawFastHLine(int16_t x, int16_t y, int16_t w, uint16_t color);
322 bool getPixel(int16_t x, int16_t y)
const;
332 bool getRawPixel(int16_t x, int16_t y)
const;
333 void drawFastRawVLine(int16_t x, int16_t y, int16_t h, uint16_t color);
334 void drawFastRawHLine(int16_t x, int16_t y, int16_t w, uint16_t color);
342 static const uint8_t PROGMEM GFXsetBit[], GFXclrBit[];
349 GFXcanvas8(uint16_t w, uint16_t h,
bool allocate_buffer =
true);
351 void drawPixel(int16_t x, int16_t y, uint16_t color);
353 void drawFastVLine(int16_t x, int16_t y, int16_t h, uint16_t color);
354 void drawFastHLine(int16_t x, int16_t y, int16_t w, uint16_t color);
355 uint8_t getPixel(int16_t x, int16_t y)
const;
365 uint8_t getRawPixel(int16_t x, int16_t y)
const;
366 void drawFastRawVLine(int16_t x, int16_t y, int16_t h, uint16_t color);
367 void drawFastRawHLine(int16_t x, int16_t y, int16_t w, uint16_t color);
376 GFXcanvas16(uint16_t w, uint16_t h,
bool allocate_buffer =
true);
378 void drawPixel(int16_t x, int16_t y, uint16_t color);
381 void drawFastVLine(int16_t x, int16_t y, int16_t h, uint16_t color);
382 void drawFastHLine(int16_t x, int16_t y, int16_t w, uint16_t color);
383 uint16_t getPixel(int16_t x, int16_t y)
const;
393 uint16_t getRawPixel(int16_t x, int16_t y)
const;
394 void drawFastRawVLine(int16_t x, int16_t y, int16_t h, uint16_t color);
395 void drawFastRawHLine(int16_t x, int16_t y, int16_t w, uint16_t color);
401 #endif // _ADAFRUIT_GFX_H uint8_t * getBuffer(void) const
Get a pointer to the internal buffer memory.
Definition: Adafruit_GFX.h:362
void fillCircleHelper(int16_t x0, int16_t y0, int16_t r, uint8_t cornername, int16_t delta, uint16_t color)
Quarter-circle drawer with fill, used for circles and roundrects.
Definition: Adafruit_GFX.cpp:587
virtual void writePixel(int16_t x, int16_t y, uint16_t color)
Write a pixel, overwrite in subclasses if startWrite is defined!
Definition: Adafruit_GFX.cpp:190
void setTextColor(uint16_t c, uint16_t bg)
Set text font color with custom background color.
Definition: Adafruit_GFX.h:157
void drawXBitmap(int16_t x, int16_t y, const uint8_t bitmap[], int16_t w, int16_t h, uint16_t color)
Draw PROGMEM-resident XBitMap Files (*.xbm), exported from GIMP. Usage: Export from GIMP to *...
Definition: Adafruit_GFX.cpp:967
Data stored for FONT AS A WHOLE.
Definition: gfxfont.h:21
void setTextWrap(bool w)
Set whether text that is too long for the screen width should automatically wrap around to the next l...
Definition: Adafruit_GFX.h:169
Definition: Adafruit_GFX.h:18
bool buffer_owned
Definition: Adafruit_GFX.h:336
void fillCircle(int16_t x0, int16_t y0, int16_t r, uint16_t color)
Draw a circle with filled color.
Definition: Adafruit_GFX.cpp:568
uint8_t * getBuffer(void) const
Get a pointer to the internal buffer memory.
Definition: Adafruit_GFX.h:329
virtual void drawPixel(int16_t x, int16_t y, uint16_t color)=0
Draw to the screen/framebuffer/etc. Must be overridden in subclass.
virtual void endWrite(void)
End a display-writing routine, overwrite in subclasses if startWrite is defined!
Definition: Adafruit_GFX.cpp:253
uint8_t * buffer
Raster data: no longer private, allow subclass access.
Definition: Adafruit_GFX.h:335
void fillEllipse(int16_t x0, int16_t y0, int16_t rw, int16_t rh, uint16_t color)
Draw an ellipse with filled colour.
Definition: Adafruit_GFX.cpp:417
void drawChar(int16_t x, int16_t y, unsigned char c, uint16_t color, uint16_t bg, uint8_t size)
Draw a single character.
Definition: Adafruit_GFX.cpp:1231
int16_t getCursorX(void) const
Get text cursor X location.
Definition: Adafruit_GFX.h:226
virtual void writeFillRect(int16_t x, int16_t y, int16_t w, int16_t h, uint16_t color)
Write a rectangle completely with one color, overwrite in subclasses if startWrite is defined! ...
Definition: Adafruit_GFX.cpp:241
int16_t cursor_y
y location to start print()ing text
Definition: Adafruit_GFX.h:244
void drawTriangle(int16_t x0, int16_t y0, int16_t x1, int16_t y1, int16_t x2, int16_t y2, uint16_t color)
Draw a triangle with no fill color.
Definition: Adafruit_GFX.cpp:716
GFXfont * gfxFont
Pointer to special font.
Definition: Adafruit_GFX.h:252
void drawRoundRect(int16_t x0, int16_t y0, int16_t w, int16_t h, int16_t radius, uint16_t color)
Draw a rounded rectangle with no fill color.
Definition: Adafruit_GFX.cpp:660
A GFX 1-bit canvas context for graphics.
Definition: Adafruit_GFX.h:314
void setFont(const GFXfont *f=NULL)
Set the font to display when print()ing, either custom or default.
Definition: Adafruit_GFX.cpp:1454
uint8_t textsize_x
Desired magnification in X-axis of text to print()
Definition: Adafruit_GFX.h:247
uint8_t * buffer
Raster data: no longer private, allow subclass access.
Definition: Adafruit_GFX.h:368
A GFX 16-bit canvas context for graphics.
Definition: Adafruit_GFX.h:374
virtual void invertDisplay(bool i)
Invert the display (ideally using built-in hardware command)
Definition: Adafruit_GFX.cpp:1656
void drawCircleHelper(int16_t x0, int16_t y0, int16_t r, uint8_t cornername, uint16_t color)
Quarter-circle drawer, used to do circles and roundrects.
Definition: Adafruit_GFX.cpp:523
void drawRGBBitmap(int16_t x, int16_t y, const uint16_t bitmap[], int16_t w, int16_t h)
Draw a PROGMEM-resident 16-bit image (RGB 5/6/5) at the specified (x,y) position. For 16-bit display ...
Definition: Adafruit_GFX.cpp:1117
bool _cp437
If set, use correct CP437 charset (default is off)
Definition: Adafruit_GFX.h:251
A GFX 8-bit canvas context for graphics.
Definition: Adafruit_GFX.h:347
void setTextColor(uint16_t c)
Set text font color with transparant background.
Definition: Adafruit_GFX.h:148
virtual void writeLine(int16_t x0, int16_t y0, int16_t x1, int16_t y1, uint16_t color)
Write a line. Bresenham's algorithm - thx wikpedia.
Definition: Adafruit_GFX.cpp:132
virtual void fillRect(int16_t x, int16_t y, int16_t w, int16_t h, uint16_t color)
Fill a rectangle completely with one color. Update in subclasses if desired!
Definition: Adafruit_GFX.cpp:300
int16_t height(void) const
Get height of the display, accounting for current rotation.
Definition: Adafruit_GFX.h:208
void cp437(bool x=true)
Enable (or disable) Code Page 437-compatible charset. There was an error in glcdfont.c for the longest time – one character (#176, the 'light shade' block) was missing – this threw off the index of every character that followed it. But a TON of code has been written with the erroneous character indices. By default, the library uses the original 'wrong' behavior and old sketches will still work. Pass 'true' to this function to use correct CP437 character values in your code.
Definition: Adafruit_GFX.h:185
virtual void setRotation(uint8_t r)
Set rotation setting for display.
Definition: Adafruit_GFX.cpp:1432
bool buffer_owned
Definition: Adafruit_GFX.h:369
void drawGrayscaleBitmap(int16_t x, int16_t y, const uint8_t bitmap[], int16_t w, int16_t h)
Draw a PROGMEM-resident 8-bit image (grayscale) at the specified (x,y) pos. Specifically for 8-bit di...
Definition: Adafruit_GFX.cpp:1001
bool buffer_owned
Definition: Adafruit_GFX.h:397
void charBounds(unsigned char c, int16_t *x, int16_t *y, int16_t *minx, int16_t *miny, int16_t *maxx, int16_t *maxy)
Helper to determine size of a character with current font/size. Broke this out as it's used by both t...
Definition: Adafruit_GFX.cpp:1487
uint8_t getRotation(void) const
Get rotation setting for display.
Definition: Adafruit_GFX.h:216
void setTextSize(uint8_t s)
Set text 'magnification' size. Each increase in s makes 1 pixel that much bigger. ...
Definition: Adafruit_GFX.cpp:1411
uint16_t textbgcolor
16-bit text color for print()
Definition: Adafruit_GFX.h:246
Adafruit_GFX(int16_t w, int16_t h)
Instatiate a GFX context for graphics! Can only be done by a superclass.
Definition: Adafruit_GFX.cpp:110
int16_t cursor_x
x location to start print()ing text
Definition: Adafruit_GFX.h:243
uint8_t textsize_y
Desired magnification in Y-axis of text to print()
Definition: Adafruit_GFX.h:248
int16_t _height
Display height as modified by current rotation.
Definition: Adafruit_GFX.h:242
int16_t _width
Display width as modified by current rotation.
Definition: Adafruit_GFX.h:241
void fillRoundRect(int16_t x0, int16_t y0, int16_t w, int16_t h, int16_t radius, uint16_t color)
Draw a rounded rectangle with fill color.
Definition: Adafruit_GFX.cpp:690
virtual void drawFastHLine(int16_t x, int16_t y, int16_t w, uint16_t color)
Draw a perfectly horizontal line (this is often optimized in a subclass!)
Definition: Adafruit_GFX.cpp:282
int16_t getCursorY(void) const
Get text cursor Y location.
Definition: Adafruit_GFX.h:234
uint8_t rotation
Display rotation (0 thru 3)
Definition: Adafruit_GFX.h:249
void setCursor(int16_t x, int16_t y)
Set text cursor location.
Definition: Adafruit_GFX.h:135
uint16_t * buffer
Raster data: no longer private, allow subclass access.
Definition: Adafruit_GFX.h:396
void drawEllipse(int16_t x0, int16_t y0, int16_t rw, int16_t rh, uint16_t color)
Draw an ellipse outline.
Definition: Adafruit_GFX.cpp:358
uint16_t textcolor
16-bit background color for print()
Definition: Adafruit_GFX.h:245
bool wrap
If set, 'wrap' text at right edge of display.
Definition: Adafruit_GFX.h:250
void fillTriangle(int16_t x0, int16_t y0, int16_t x1, int16_t y1, int16_t x2, int16_t y2, uint16_t color)
Draw a triangle with color-fill.
Definition: Adafruit_GFX.cpp:735
uint16_t * getBuffer(void) const
Get a pointer to the internal buffer memory.
Definition: Adafruit_GFX.h:390
virtual void drawFastVLine(int16_t x, int16_t y, int16_t h, uint16_t color)
Draw a perfectly vertical line (this is often optimized in a subclass!)
Definition: Adafruit_GFX.cpp:265
virtual void drawLine(int16_t x0, int16_t y0, int16_t x1, int16_t y1, uint16_t color)
Draw a line.
Definition: Adafruit_GFX.cpp:330
virtual void startWrite(void)
Start a display-writing routine, overwrite in subclasses.
Definition: Adafruit_GFX.cpp:180
int16_t HEIGHT
This is the 'raw' display height - never changes.
Definition: Adafruit_GFX.h:240
void drawCircle(int16_t x0, int16_t y0, int16_t r, uint16_t color)
Draw a circle outline.
Definition: Adafruit_GFX.cpp:473
virtual void writeFastHLine(int16_t x, int16_t y, int16_t w, uint16_t color)
Write a perfectly horizontal line, overwrite in subclasses if startWrite is defined! ...
Definition: Adafruit_GFX.cpp:222
void drawBitmap(int16_t x, int16_t y, const uint8_t bitmap[], int16_t w, int16_t h, uint16_t color)
Draw a PROGMEM-resident 1-bit image at the specified (x,y) position, using the specified foreground c...
Definition: Adafruit_GFX.cpp:833
virtual void writeFastVLine(int16_t x, int16_t y, int16_t h, uint16_t color)
Write a perfectly vertical line, overwrite in subclasses if startWrite is defined! ...
Definition: Adafruit_GFX.cpp:204
virtual void drawRect(int16_t x, int16_t y, int16_t w, int16_t h, uint16_t color)
Draw a rectangle with no fill color.
Definition: Adafruit_GFX.cpp:639
void getTextBounds(const char *string, int16_t x, int16_t y, int16_t *x1, int16_t *y1, uint16_t *w, uint16_t *h)
Helper to determine size of a string with current font/size. Pass string and a cursor position...
Definition: Adafruit_GFX.cpp:1564
virtual void write(uint8_t)
Print one byte/character of data, used to support print()
Definition: Adafruit_GFX.cpp:1358
virtual void fillScreen(uint16_t color)
Fill the screen completely with one color. Update in subclasses if desired!
Definition: Adafruit_GFX.cpp:316
int16_t WIDTH
This is the 'raw' display width - never changes.
Definition: Adafruit_GFX.h:239
int16_t width(void) const
Get width of the display, accounting for current rotation.
Definition: Adafruit_GFX.h:200