1 | /******************************************************************
|
---|
2 | This is the core graphics library for all our displays, providing
|
---|
3 | basic graphics primitives (points, lines, circles, etc.). It needs
|
---|
4 | to be paired with a hardware-specific library for each display
|
---|
5 | device we carry (handling the lower-level functions).
|
---|
6 |
|
---|
7 | Adafruit invests time and resources providing this open
|
---|
8 | source code, please support Adafruit and open-source hardware
|
---|
9 | by purchasing products from Adafruit!
|
---|
10 |
|
---|
11 | Written by Limor Fried/Ladyada for Adafruit Industries.
|
---|
12 | BSD license, check license.txt for more information.
|
---|
13 | All text above must be included in any redistribution.
|
---|
14 | ******************************************************************/
|
---|
15 |
|
---|
16 | #ifndef _ADAFRUIT_GFX_H
|
---|
17 | #define _ADAFRUIT_GFX_H
|
---|
18 |
|
---|
19 | #if ARDUINO >= 100
|
---|
20 | #include "Arduino.h"
|
---|
21 | #include "Print.h"
|
---|
22 | #else
|
---|
23 | #include "WProgram.h"
|
---|
24 | #endif
|
---|
25 |
|
---|
26 | //#include "PImage.h"
|
---|
27 |
|
---|
28 | #define swap(a, b) { int16_t t = a; a = b; b = t; }
|
---|
29 |
|
---|
30 | /* TODO
|
---|
31 | enum RectMode {
|
---|
32 | CORNER,
|
---|
33 | CORNERS,
|
---|
34 | RADIUS,
|
---|
35 | CENTER
|
---|
36 | };
|
---|
37 | */
|
---|
38 |
|
---|
39 | typedef uint16_t color;
|
---|
40 |
|
---|
41 | class Adafruit_GFX : public Print {
|
---|
42 | public:
|
---|
43 |
|
---|
44 | Adafruit_GFX(int16_t w, int16_t h); // Constructor
|
---|
45 |
|
---|
46 | // This MUST be defined by the subclass:
|
---|
47 | virtual void drawPixel(int16_t x, int16_t y, uint16_t color) = 0;
|
---|
48 |
|
---|
49 | // These MAY be overridden by the subclass to provide device-specific
|
---|
50 | // optimized code. Otherwise 'generic' versions are used.
|
---|
51 | virtual void
|
---|
52 | drawLine(int16_t x0, int16_t y0, int16_t x1, int16_t y1, uint16_t color),
|
---|
53 | drawFastVLine(int16_t x, int16_t y, int16_t h, uint16_t color),
|
---|
54 | drawFastHLine(int16_t x, int16_t y, int16_t w, uint16_t color),
|
---|
55 | drawRect(int16_t x, int16_t y, int16_t w, int16_t h, uint16_t color),
|
---|
56 | fillRect(int16_t x, int16_t y, int16_t w, int16_t h, uint16_t color),
|
---|
57 | fillScreen(uint16_t color),
|
---|
58 | invertDisplay(boolean i);
|
---|
59 |
|
---|
60 | // These exist only with Adafruit_GFX (no subclass overrides)
|
---|
61 | void
|
---|
62 | drawCircle(int16_t x0, int16_t y0, int16_t r, uint16_t color),
|
---|
63 | drawCircleHelper(int16_t x0, int16_t y0, int16_t r, uint8_t cornername,
|
---|
64 | uint16_t color),
|
---|
65 | fillCircle(int16_t x0, int16_t y0, int16_t r, uint16_t color),
|
---|
66 | fillCircleHelper(int16_t x0, int16_t y0, int16_t r, uint8_t cornername,
|
---|
67 | int16_t delta, uint16_t color),
|
---|
68 | drawTriangle(int16_t x0, int16_t y0, int16_t x1, int16_t y1,
|
---|
69 | int16_t x2, int16_t y2, uint16_t color),
|
---|
70 | fillTriangle(int16_t x0, int16_t y0, int16_t x1, int16_t y1,
|
---|
71 | int16_t x2, int16_t y2, uint16_t color),
|
---|
72 | drawRoundRect(int16_t x0, int16_t y0, int16_t w, int16_t h,
|
---|
73 | int16_t radius, uint16_t color),
|
---|
74 | fillRoundRect(int16_t x0, int16_t y0, int16_t w, int16_t h,
|
---|
75 | int16_t radius, uint16_t color),
|
---|
76 | drawBitmap(int16_t x, int16_t y, const uint8_t *bitmap,
|
---|
77 | int16_t w, int16_t h, uint16_t color),
|
---|
78 | drawChar(int16_t x, int16_t y, unsigned char c, uint16_t color,
|
---|
79 | uint16_t bg, uint8_t size),
|
---|
80 | setCursor(int16_t x, int16_t y),
|
---|
81 | setTextColor(uint16_t c),
|
---|
82 | setTextColor(uint16_t c, uint16_t bg),
|
---|
83 | setTextSize(uint8_t s),
|
---|
84 | setTextWrap(boolean w),
|
---|
85 | setRotation(uint8_t r);
|
---|
86 |
|
---|
87 | #if ARDUINO >= 100
|
---|
88 | virtual size_t write(uint8_t);
|
---|
89 | #else
|
---|
90 | virtual void write(uint8_t);
|
---|
91 | #endif
|
---|
92 |
|
---|
93 | int16_t
|
---|
94 | height(void),
|
---|
95 | width(void);
|
---|
96 |
|
---|
97 | uint8_t getRotation(void);
|
---|
98 |
|
---|
99 |
|
---|
100 | /*
|
---|
101 | * Processing-like graphics primitives
|
---|
102 | */
|
---|
103 |
|
---|
104 | /// transforms a color in 16-bit form given the RGB components.
|
---|
105 | /// The default implementation makes a 5-bit red, a 6-bit
|
---|
106 | /// green and a 5-bit blue (MSB to LSB). Devices that use
|
---|
107 | /// different scheme should override this.
|
---|
108 | virtual uint16_t newColor(uint8_t red, uint8_t green, uint8_t blue);
|
---|
109 |
|
---|
110 |
|
---|
111 | // http://processing.org/reference/background_.html
|
---|
112 | void background(uint8_t red, uint8_t green, uint8_t blue);
|
---|
113 | void background(color c);
|
---|
114 |
|
---|
115 | // http://processing.org/reference/fill_.html
|
---|
116 | void fill(uint8_t red, uint8_t green, uint8_t blue);
|
---|
117 | void fill(color c);
|
---|
118 |
|
---|
119 | // http://processing.org/reference/noFill_.html
|
---|
120 | void noFill();
|
---|
121 |
|
---|
122 | // http://processing.org/reference/stroke_.html
|
---|
123 | void stroke(uint8_t red, uint8_t green, uint8_t blue);
|
---|
124 | void stroke(color c);
|
---|
125 |
|
---|
126 | // http://processing.org/reference/noStroke_.html
|
---|
127 | void noStroke();
|
---|
128 |
|
---|
129 | void text(const char * text, int16_t x, int16_t y);
|
---|
130 | void text(int value, uint8_t posX, uint8_t posY);
|
---|
131 | void text(long value, uint8_t posX, uint8_t posY);
|
---|
132 | void text(char value, uint8_t posX, uint8_t posY);
|
---|
133 |
|
---|
134 | void textWrap(const char * text, int16_t x, int16_t y);
|
---|
135 |
|
---|
136 | void textSize(uint8_t size);
|
---|
137 |
|
---|
138 | // similar to ellipse() in Processing, but with
|
---|
139 | // a single radius.
|
---|
140 | // http://processing.org/reference/ellipse_.html
|
---|
141 | void circle(int16_t x, int16_t y, int16_t r);
|
---|
142 |
|
---|
143 | void point(int16_t x, int16_t y);
|
---|
144 |
|
---|
145 | void line(int16_t x1, int16_t y1, int16_t x2, int16_t y2);
|
---|
146 |
|
---|
147 | void quad(int16_t x1, int16_t y1, int16_t x2, int16_t y2, int16_t x3, int16_t y3, int16_t x4, int16_t y4);
|
---|
148 |
|
---|
149 | void rect(int16_t x, int16_t y, int16_t width, int16_t height);
|
---|
150 |
|
---|
151 | void rect(int16_t x, int16_t y, int16_t width, int16_t height, int16_t radius);
|
---|
152 |
|
---|
153 | void triangle(int16_t x1, int16_t y1, int16_t x2, int16_t y2, int16_t x3, int16_t y3);
|
---|
154 |
|
---|
155 | /* TODO
|
---|
156 | void rectMode(RectMode mode);
|
---|
157 |
|
---|
158 | void pushStyle();
|
---|
159 | void popStyle();
|
---|
160 | */
|
---|
161 |
|
---|
162 | // PImage loadImage(const char * fileName) { return PImage::loadImage(fileName); }
|
---|
163 |
|
---|
164 | // void image(PImage & img, uint16_t x, uint16_t y);
|
---|
165 |
|
---|
166 | protected:
|
---|
167 | const int16_t
|
---|
168 | WIDTH, HEIGHT; // This is the 'raw' display w/h - never changes
|
---|
169 | int16_t
|
---|
170 | _width, _height, // Display w/h as modified by current rotation
|
---|
171 | cursor_x, cursor_y;
|
---|
172 | uint16_t
|
---|
173 | textcolor, textbgcolor;
|
---|
174 | uint8_t
|
---|
175 | textsize,
|
---|
176 | rotation;
|
---|
177 | boolean
|
---|
178 | wrap; // If set, 'wrap' text at right edge of display
|
---|
179 |
|
---|
180 | /*
|
---|
181 | * Processing-style graphics state
|
---|
182 | */
|
---|
183 |
|
---|
184 | color strokeColor;
|
---|
185 | bool useStroke;
|
---|
186 | color fillColor;
|
---|
187 | bool useFill;
|
---|
188 | };
|
---|
189 |
|
---|
190 | #endif // _ADAFRUIT_GFX_H
|
---|