src/main/drivers/display_canvas.h

   1 /*
   2  * This file is part of Cleanflight, Betaflight and INAV.
   3  *
   4  * This Source Code Form is subject to the terms of the Mozilla Public
   5  * License, v. 2.0. If a copy of the MPL was not distributed with this file,
   6  * You can obtain one at http://mozilla.org/MPL/2.0/.
   7  *
   8  * Alternatively, the contents of this file may be used under the terms
   9  * of the GNU General Public License Version 3, as described below:
  10  *
  11  * This file is free software: you may copy, redistribute and/or modify
  12  * it under the terms of the GNU General Public License as published by the
  13  * Free Software Foundation, either version 3 of the License, or (at your
  14  * option) any later version.
  15  *
  16  * This file is distributed in the hope that it will be useful, but
  17  * WITHOUT ANY WARRANTY; without even the implied warranty of
  18  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
  19  * Public License for more details.
  20  *
  21  * You should have received a copy of the GNU General Public License
  22  * along with this program. If not, see http://www.gnu.org/licenses/.
  23  *
  24  * @author Alberto Garcia Hierro <alberto@garciahierro.com>
  25  */
  26
  27 #pragma once
  28
  29 #include <stdbool.h>
  30 #include <stdint.h>
  31
  32 typedef enum {
  33     DISPLAY_CANVAS_BITMAP_OPT_INVERT_COLORS = 1 << 0,
  34     DISPLAY_CANVAS_BITMAP_OPT_SOLID_BACKGROUND = 1 << 1,
  35     DISPLAY_CANVAS_BITMAP_OPT_ERASE_TRANSPARENT = 1 << 2,
  36 } displayCanvasBitmapOption_t;
  37
  38 typedef enum {
  39     DISPLAY_CANVAS_COLOR_BLACK = 0,
  40     DISPLAY_CANVAS_COLOR_TRANSPARENT = 1,
  41     DISPLAY_CANVAS_COLOR_WHITE = 2,
  42     DISPLAY_CANVAS_COLOR_GRAY = 3,
  43 } displayCanvasColor_e;
  44
  45 typedef enum {
  46     DISPLAY_CANVAS_OUTLINE_TYPE_NONE = 0,
  47     DISPLAY_CANVAS_OUTLINE_TYPE_TOP = 1 << 0,
  48     DISPLAY_CANVAS_OUTLINE_TYPE_RIGHT = 1 << 1,
  49     DISPLAY_CANVAS_OUTLINE_TYPE_BOTTOM = 1 << 2,
  50     DISPLAY_CANVAS_OUTLINE_TYPE_LEFT = 1 << 3,
  51 } displayCanvasOutlineType_e;
  52
  53 struct displayCanvasVTable_s;
  54
  55 typedef struct displayCanvas_s {
  56     const struct displayCanvasVTable_s *vTable;
  57     void *device;
  58     uint16_t width;
  59     uint16_t height;
  60     uint8_t gridElementWidth;
  61     uint8_t gridElementHeight;
  62 } displayCanvas_t;
  63
  64 typedef struct displayCanvasVTable_s {
  65     void (*setStrokeColor)(displayCanvas_t *displayCanvas, displayCanvasColor_e color);
  66     void (*setFillColor)(displayCanvas_t *displayCanvas, displayCanvasColor_e color);
  67     void (*setStrokeAndFillColor)(displayCanvas_t *displayCanvas, displayCanvasColor_e color);
  68     void (*setColorInversion)(displayCanvas_t *displayCanvas, bool inverted);
  69     void (*setPixel)(displayCanvas_t *displayCanvas, int x, int y, displayCanvasColor_e color);
  70     void (*setPixelToStrokeColor)(displayCanvas_t *displayCanvas, int x, int y);
  71     void (*setPixelToFillColor)(displayCanvas_t *displayCanvas, int x, int y);
  72     void (*setStrokeWidth)(displayCanvas_t *displayCanvas, unsigned w);
  73     void (*setLineOutlineType)(displayCanvas_t *displayCanvas, displayCanvasOutlineType_e outlineType);
  74     void (*setLineOutlineColor)(displayCanvas_t *displayCanvas, displayCanvasColor_e outlineColor);
  75
  76     void (*clipToRect)(displayCanvas_t *displayCanvas, int x, int y, int w, int h);
  77     void (*clearRect)(displayCanvas_t *displayCanvas, int x, int y, int w, int h);
  78     void (*resetDrawingState)(displayCanvas_t *displayCanvas);
  79     void (*drawCharacter)(displayCanvas_t *displayCanvas, int x, int y, uint16_t chr, displayCanvasBitmapOption_t opts);
  80     void (*drawCharacterMask)(displayCanvas_t *displayCanvas, int x, int y, uint16_t chr, displayCanvasColor_e color, displayCanvasBitmapOption_t opts);
  81     void (*drawString)(displayCanvas_t *displayCanvas, int x, int y, const char *s, displayCanvasBitmapOption_t opts);
  82     void (*drawStringMask)(displayCanvas_t *displayCanvas, int x, int y, const char *s, displayCanvasColor_e color, displayCanvasBitmapOption_t opts);
  83     void (*moveToPoint)(displayCanvas_t *displayCanvas, int x, int y);
  84     void (*strokeLineToPoint)(displayCanvas_t *displayCanvas, int x, int y);
  85     void (*strokeTriangle)(displayCanvas_t *displayCanvas, int x1, int y1, int x2, int y2, int x3, int y3);
  86     void (*fillTriangle)(displayCanvas_t *displayCanvas, int x1, int y1, int x2, int y2, int x3, int y3);
  87     void (*fillStrokeTriangle)(displayCanvas_t *displayCanvas, int x1, int y1, int x2, int y2, int x3, int y3);
  88     void (*strokeRect)(displayCanvas_t *displayCanvas, int x, int y, int w, int h);
  89     void (*fillRect)(displayCanvas_t *displayCanvas, int x, int y, int w, int h);
  90     void (*fillStrokeRect)(displayCanvas_t *displayCanvas, int x, int y, int w, int h);
  91     void (*strokeEllipseInRect)(displayCanvas_t *displayCanvas, int x, int y, int w, int h);
  92     void (*fillEllipseInRect)(displayCanvas_t *displayCanvas, int x, int y, int w, int h);
  93     void (*fillStrokeEllipseInRect)(displayCanvas_t *displayCanvas, int x, int y, int w, int h);
  94
  95     void (*ctmReset)(displayCanvas_t *displayCanvas);
  96     void (*ctmSet)(displayCanvas_t *displayCanvas, float m11, float m12, float m21, float m22, float m31, float m32);
  97     void (*ctmTranslate)(displayCanvas_t *displayCanvas, float tx, float ty);
  98     void (*ctmScale)(displayCanvas_t *displayCanvas, float sx, float sy);
  99     void (*ctmRotate)(displayCanvas_t *displayCanvas, float r);
 100
 101     void (*contextPush)(displayCanvas_t *displayCanvas);
 102     void (*contextPop)(displayCanvas_t *displayCanvas);
 103 } displayCanvasVTable_t;
 104
 105 void displayCanvasSetStrokeColor(displayCanvas_t *displayCanvas, displayCanvasColor_e color);
 106 void displayCanvasSetFillColor(displayCanvas_t *displayCanvas, displayCanvasColor_e color);
 107 void displayCanvasSetStrokeAndFillColor(displayCanvas_t *displayCanvas, displayCanvasColor_e color);
 108 void displayCanvasSetColorInversion(displayCanvas_t *displayCanvas, bool inverted);
 109 void displayCanvasSetPixel(displayCanvas_t *displayCanvas, int x, int y, displayCanvasColor_e);
 110 void displayCanvasSetPixelToStrokeColor(displayCanvas_t *displayCanvas, int x, int y);
 111 void displayCanvasSetPixelToFillColor(displayCanvas_t *displayCanvas, int x, int y);
 112 void displayCanvasSetStrokeWidth(displayCanvas_t *displayCanvas, unsigned w);
 113 void displayCanvasSetLineOutlineType(displayCanvas_t *displayCanvas, displayCanvasOutlineType_e outlineType);
 114 void displayCanvasSetLineOutlineColor(displayCanvas_t *displayCanvas, displayCanvasColor_e outlineColor);
 115
 116 void displayCanvasClipToRect(displayCanvas_t *displayCanvas, int x, int y, int w, int h);
 117 void displayCanvasClearRect(displayCanvas_t *displayCanvas, int x, int y, int w, int h);
 118 void displayCanvasResetDrawingState(displayCanvas_t *displayCanvas);
 119 void displayCanvasDrawCharacter(displayCanvas_t *displayCanvas, int x, int y, uint16_t chr, displayCanvasBitmapOption_t opts);
 120 void displayCanvasDrawCharacterMask(displayCanvas_t *displayCanvas, int x, int y, uint16_t chr, displayCanvasColor_e color, displayCanvasBitmapOption_t opts);
 121 void displayCanvasDrawString(displayCanvas_t *displayCanvas, int x, int y, const char *s, displayCanvasBitmapOption_t opts);
 122 void displayCanvasDrawStringMask(displayCanvas_t *displayCanvas, int x, int y, const char *s, displayCanvasColor_e color, displayCanvasBitmapOption_t opts);
 123 void displayCanvasMoveToPoint(displayCanvas_t *displayCanvas, int x, int y);
 124 void displayCanvasStrokeLineToPoint(displayCanvas_t *displayCanvas, int x, int y);
 125 void displayCanvasStrokeTriangle(displayCanvas_t *displayCanvas, int x1, int y1, int x2, int y2, int x3, int y3);
 126 void displayCanvasFillTriangle(displayCanvas_t *displayCanvas, int x1, int y1, int x2, int y2, int x3, int y3);
 127 void displayCanvasFillStrokeTriangle(displayCanvas_t *displayCanvas, int x1, int y1, int x2, int y2, int x3, int y3);
 128 void displayCanvasStrokeRect(displayCanvas_t *displayCanvas, int x, int y, int w, int h);
 129 void displayCanvasFillRect(displayCanvas_t *displayCanvas, int x, int y, int w, int h);
 130 void displayCanvasFillStrokeRect(displayCanvas_t *displayCanvas, int x, int y, int w, int h);
 131 void displayCanvasStrokeEllipseInRect(displayCanvas_t *displayCanvas, int x, int y, int w, int h);
 132 void displayCanvasFillEllipseInRect(displayCanvas_t *displayCanvas, int x, int y, int w, int h);
 133 void displayCanvasFillStrokeEllipseInRect(displayCanvas_t *displayCanvas, int x, int y, int w, int h);
 134
 135 void displayCanvasCtmReset(displayCanvas_t *displayCanvas);
 136 void displayCanvasCtmSet(displayCanvas_t *displayCanvas, float m11, float m12, float m21, float m22, float m31, float m32);
 137 void displayCanvasCtmTranslate(displayCanvas_t *displayCanvas, float tx, float ty);
 138 void displayCanvasCtmScale(displayCanvas_t *displayCanvas, float sx, float sy);
 139 void displayCanvasCtmRotate(displayCanvas_t *displayCanvas, float r);
 140
 141 void displayCanvasContextPush(displayCanvas_t *displayCanvas);
 142 void displayCanvasContextPop(displayCanvas_t *displayCanvas);