src/main/drivers/osd.h

   1 /*
   2  * This file is part of Cleanflight, Betaflight and INAV
   3  *
   4  * Cleanflight, Betaflight and INAV are free software. You can
   5  * redistribute this software and/or modify this software under
   6  * the terms of the GNU General Public License as published by
   7  * the Free Software Foundation, either version 3 of the License,
   8  * or (at your option) any later version.
   9  *
  10  * Cleanflight, Betaflight and INAV are distributed in the hope that
  11  * they will be useful, but WITHOUT ANY WARRANTY; without even the
  12  * implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
  13  * PURPOSE. See the GNU General Public License for more details.
  14  *
  15  * You should have received a copy of the GNU General Public License
  16  * along with this software.
  17  *
  18  * If not, see <http://www.gnu.org/licenses/>.
  19  */
  20
  21 #pragma once
  22
  23 #include <stdint.h>
  24
  25 #include "common/utils.h"
  26
  27 #define OSD_CHAR_WIDTH 12
  28 #define OSD_CHAR_HEIGHT 18
  29 #define OSD_CHAR_BITS_PER_PIXEL 2
  30 #define OSD_CHAR_VISIBLE_BYTES (OSD_CHAR_WIDTH * OSD_CHAR_HEIGHT * OSD_CHAR_BITS_PER_PIXEL / 8)
  31 // Only the first 54 bytes of a character represent visible data. However, some OSD drivers
  32 // accept 64 bytes and use the extra 10 bytes for metadata.
  33 #define OSD_CHAR_BYTES 64
  34
  35 #define OSD_CHARACTER_COLOR_BLACK 0
  36 #define OSD_CHARACTER_COLOR_TRANSPARENT 1
  37 #define OSD_CHARACTER_COLOR_WHITE 2
  38
  39 // 3 is unused but it's interpreted as transparent by all drivers
  40
  41 typedef struct displayCanvas_s displayCanvas_t;
  42
  43 // Video Character Display parameters
  44
  45 typedef enum {
  46     VIDEO_SYSTEM_AUTO = 0,
  47     VIDEO_SYSTEM_PAL,
  48     VIDEO_SYSTEM_NTSC
  49 } videoSystem_e;
  50
  51 typedef enum {
  52     OSD_DRIVER_NONE = 0,
  53     OSD_DRIVER_MAX7456 = 1,
  54 } osdDriver_e;
  55
  56 // osdCharacter_t represents the binary data for an OSD
  57 // character. All OSD drivers use the same character format
  58 // as defined by OSD_CHARACTER_WIDTH, OSD_CHARACTER_HEIGHT
  59 // and OSD_CHARACTER_BITS_PER_PIXEL.
  60 typedef struct osdCharacter_s {
  61     uint8_t data[OSD_CHAR_BYTES];
  62 } osdCharacter_t;
  63
  64 typedef struct osdUnit_t
  65 {
  66     uint16_t scale;             // The scale between the value and the represented unit. e.g. if you're providing cms but you want to draw meters this should be 100 ([0, 1023])
  67     uint16_t symbol;            // Symbol to append/prepend to the value when it's not scaled [0, 511]
  68     uint16_t divisor;           // If abs(value) > divisor, divide it by this. e.g. for meters and km you'd set this to 1000 [0, UINT16_MAX)
  69     uint16_t divided_symbol;    // Symbol to append/prepend to the value when it's divided (e.g. the km symbol) [0, 511]
  70 } osdUnit_t;
  71
  72 #define OSD_CHARACTER_GRID_MAX_WIDTH 30
  73 #define OSD_CHARACTER_GRID_MAX_HEIGHT 16
  74 #define OSD_CHARACTER_GRID_BUFFER_SIZE (OSD_CHARACTER_GRID_MAX_WIDTH * OSD_CHARACTER_GRID_MAX_HEIGHT)
  75
  76 extern uint16_t osdCharacterGridBuffer[OSD_CHARACTER_GRID_BUFFER_SIZE] ALIGNED(4);
  77
  78 // Sets all buffer entries to SYM_BLANK
  79 void osdCharacterGridBufferClear(void);
  80 void osdGridBufferClearGridRect(int x, int y, int w, int h);
  81 void osdGridBufferClearPixelRect(displayCanvas_t *canvas, int x, int y, int w, int h);
  82
  83 uint16_t *osdCharacterGridBufferGetEntryPtr(unsigned x, unsigned y);