3567 lines
103 KiB
C++
3567 lines
103 KiB
C++
/***************************************************
|
|
Arduino TFT graphics library targetted at ESP8266
|
|
based boards. (ESP32 support is planned!)
|
|
|
|
This library has been derived from the Adafruit_GFX
|
|
library and the associated driver library. See text
|
|
at the end of this file.
|
|
|
|
This is a standalone library that contains the
|
|
hardware driver, the graphics funtions and the
|
|
proportional fonts.
|
|
|
|
The larger fonts are Run Length Encoded to reduce their
|
|
size.
|
|
|
|
Created by Bodmer 2/12/16
|
|
Bodmer: Added RPi 16 bit display support
|
|
****************************************************/
|
|
|
|
#include "TFT_eSPI.h"
|
|
|
|
#include <pgmspace.h>
|
|
|
|
#include <limits.h>
|
|
#include "pins_arduino.h"
|
|
#include "wiring_private.h"
|
|
#include <SPI.h>
|
|
|
|
// If it is a 16bit serial display we must transfer 16 bits every time
|
|
#ifdef RPI_ILI9486_DRIVER
|
|
#define SEND_16_BITS
|
|
#define CMD_BITS 16-1
|
|
#else
|
|
#define CMD_BITS 8-1
|
|
#endif
|
|
|
|
// If the SPI library has transaction support, these functions
|
|
// establish settings and protect from interference from other
|
|
// libraries. Otherwise, they simply do nothing.
|
|
|
|
inline void TFT_eSPI::spi_begin(void){
|
|
#ifdef SPI_HAS_TRANSACTION
|
|
#ifdef SUPPORT_TRANSACTIONS
|
|
#ifdef SET_SPI_TO_LSB_FIRST
|
|
SPI.beginTransaction(SPISettings(SPI_FREQUENCY, LSBFIRST, SPI_MODE0));
|
|
#else
|
|
SPI.beginTransaction(SPISettings(SPI_FREQUENCY, MSBFIRST, SPI_MODE0));
|
|
#endif
|
|
#endif
|
|
#endif
|
|
}
|
|
|
|
inline void TFT_eSPI::spi_end(void){
|
|
#ifdef SPI_HAS_TRANSACTION
|
|
#ifdef SUPPORT_TRANSACTIONS
|
|
SPI.endTransaction();
|
|
#endif
|
|
#endif
|
|
}
|
|
|
|
|
|
/***************************************************************************************
|
|
** Function name: TFT_eSPI
|
|
** Description: Constructor , we must use hardware SPI pins
|
|
***************************************************************************************/
|
|
TFT_eSPI::TFT_eSPI(int16_t w, int16_t h)
|
|
{
|
|
|
|
// The control pins are deliberately set to the inactive state (CS high) as setup()
|
|
// might call and initialise another SPI peripherals which would could cause conflicts
|
|
// if CS is floating or undefined.
|
|
#ifdef TFT_CS
|
|
digitalWrite(TFT_CS, HIGH); // Chip select high (inactive)
|
|
pinMode(TFT_CS, OUTPUT);
|
|
#endif
|
|
|
|
#ifdef TFT_WR
|
|
digitalWrite(TFT_WR, HIGH); // Chip select high (inactive)
|
|
pinMode(TFT_WR, OUTPUT);
|
|
#endif
|
|
|
|
digitalWrite(TFT_DC, HIGH); // Data/Command high = data mode
|
|
pinMode(TFT_DC, OUTPUT);
|
|
|
|
#ifdef TFT_RST
|
|
if (TFT_RST >= 0) {
|
|
digitalWrite(TFT_RST, HIGH); // Set high, do not share pin with another SPI device
|
|
pinMode(TFT_RST, OUTPUT);
|
|
}
|
|
#endif
|
|
|
|
|
|
_width = w; // Set by specific xxxxx_Defines.h file or by users sketch
|
|
_height = h; // Set by specific xxxxx_Defines.h file or by users sketch
|
|
rotation = 0;
|
|
cursor_y = cursor_x = 0;
|
|
textfont = 1;
|
|
textsize = 1;
|
|
textcolor = 0xFFFF; // White
|
|
textbgcolor = 0x0000; // Black
|
|
padX = 0; // No padding
|
|
textwrap = true; // Wrap text when using print stream
|
|
textdatum = TL_DATUM; // Top Left text alignment is default
|
|
fontsloaded = 0;
|
|
|
|
addr_row = 0xFFFF;
|
|
addr_col = 0xFFFF;
|
|
|
|
#ifdef LOAD_GLCD
|
|
fontsloaded = 0x0002; // Bit 1 set
|
|
#endif
|
|
|
|
#ifdef LOAD_FONT2
|
|
fontsloaded |= 0x0004; // Bit 2 set
|
|
#endif
|
|
|
|
#ifdef LOAD_FONT4
|
|
fontsloaded |= 0x0010; // Bit 4 set
|
|
#endif
|
|
|
|
#ifdef LOAD_FONT6
|
|
fontsloaded |= 0x0040; // Bit 6 set
|
|
#endif
|
|
|
|
#ifdef LOAD_FONT7
|
|
fontsloaded |= 0x0080; // Bit 7 set
|
|
#endif
|
|
|
|
#ifdef LOAD_FONT8
|
|
fontsloaded |= 0x0100; // Bit 8 set
|
|
#endif
|
|
|
|
}
|
|
|
|
|
|
/***************************************************************************************
|
|
** Function name: begin
|
|
** Description: Included for backwards compatibility
|
|
***************************************************************************************/
|
|
void TFT_eSPI::begin(void)
|
|
{
|
|
init();
|
|
}
|
|
|
|
|
|
/***************************************************************************************
|
|
** Function name: init
|
|
** Description: Reset, then initialise the TFT display registers
|
|
***************************************************************************************/
|
|
void TFT_eSPI::init(void)
|
|
{
|
|
csport = portOutputRegister(digitalPinToPort(TFT_CS));
|
|
cspinmask = (uint32_t) digitalPinToBitMask(TFT_CS);
|
|
dcport = portOutputRegister(digitalPinToPort(TFT_DC));
|
|
dcpinmask = (uint32_t) digitalPinToBitMask(TFT_DC);
|
|
|
|
#ifdef TFT_WR
|
|
wrpinmask = (uint32_t) digitalPinToBitMask(TFT_WR);
|
|
#endif
|
|
|
|
SPI.begin(); // This will set MISO to input
|
|
|
|
#ifndef SUPPORT_TRANSACTIONS
|
|
#ifdef SET_SPI_TO_LSB_FIRST
|
|
SPI.setBitOrder(LSBFIRST);
|
|
#else
|
|
SPI.setBitOrder(MSBFIRST);
|
|
#endif
|
|
SPI.setDataMode(SPI_MODE0);
|
|
SPI.setFrequency(SPI_FREQUENCY);
|
|
#endif
|
|
|
|
// SPI1U1 |= SPIUSIO; // Single I/O pin on MOSI (bi-directional) - not tested
|
|
|
|
// Set to output once again incase D6 (MISO) is used for CS or DC
|
|
#ifdef TFT_CS
|
|
digitalWrite(TFT_CS, HIGH); // Chip select high (inactive)
|
|
pinMode(TFT_CS, OUTPUT);
|
|
#endif
|
|
|
|
digitalWrite(TFT_DC, HIGH); // Data/Command high = data mode
|
|
pinMode(TFT_DC, OUTPUT);
|
|
|
|
// toggle RST low to reset
|
|
#ifdef TFT_RST
|
|
if (TFT_RST >= 0) {
|
|
digitalWrite(TFT_RST, HIGH);
|
|
delay(5);
|
|
digitalWrite(TFT_RST, LOW);
|
|
delay(20);
|
|
digitalWrite(TFT_RST, HIGH);
|
|
delay(150);
|
|
}
|
|
#endif
|
|
|
|
spi_begin();
|
|
writecommand(TFT_SWRST); // Software reset
|
|
spi_end();
|
|
|
|
delay(5); // Wait for software reset to complete
|
|
|
|
spi_begin();
|
|
|
|
// This loads the driver specific initialisation code <<<<<<<<<<<<<<<<<<<<< ADD NEW DRIVERS TO THE LIST HERE <<<<<<<<<<<<<<<<<<<<<<<
|
|
#if defined (ILI9341_DRIVER)
|
|
#include "TFT_Drivers\ILI9341_Init.h"
|
|
|
|
#elif defined (ST7735_DRIVER)
|
|
#include "TFT_Drivers\ST7735_Init.h"
|
|
|
|
#elif defined (ILI9163_DRIVER)
|
|
#include "TFT_Drivers\ILI9163_Init.h"
|
|
|
|
#elif defined (S6D02A1_DRIVER)
|
|
#include "TFT_Drivers\S6D02A1_Init.h"
|
|
|
|
#elif defined (RPI_ILI9486_DRIVER)
|
|
#include "TFT_Drivers\RPI_ILI9486_Init.h"
|
|
#endif
|
|
|
|
spi_end();
|
|
|
|
}
|
|
|
|
|
|
/***************************************************************************************
|
|
** Function name: setRotation
|
|
** Description: rotate the screen orientation m = 0-3 or 4-7 for BMP drawing
|
|
***************************************************************************************/
|
|
void TFT_eSPI::setRotation(uint8_t m)
|
|
{
|
|
|
|
spi_begin();
|
|
|
|
// This loads the driver specific rotation code <<<<<<<<<<<<<<<<<<<<< ADD NEW DRIVERS TO THE LIST HERE <<<<<<<<<<<<<<<<<<<<<<<
|
|
#if defined (ILI9341_DRIVER)
|
|
#include "TFT_Drivers\ILI9341_Rotation.h"
|
|
|
|
#elif defined (ST7735_DRIVER)
|
|
#include "TFT_Drivers\ST7735_Rotation.h"
|
|
|
|
#elif defined (ILI9163_DRIVER)
|
|
#include "TFT_Drivers\ILI9163_Rotation.h"
|
|
|
|
#elif defined (S6D02A1_DRIVER)
|
|
#include "TFT_Drivers\S6D02A1_Rotation.h"
|
|
|
|
#elif defined (RPI_ILI9486_DRIVER)
|
|
#include "TFT_Drivers\RPI_ILI9486_Rotation.h"
|
|
|
|
#endif
|
|
|
|
spi_end();
|
|
|
|
addr_row = 0xFFFF;
|
|
addr_col = 0xFFFF;
|
|
}
|
|
|
|
|
|
/***************************************************************************************
|
|
** Function name: commandList, used for FLASH based lists only (e.g. ST7735)
|
|
** Description: Get initialisation commands from FLASH and send to TFT
|
|
***************************************************************************************/
|
|
void TFT_eSPI::commandList (const uint8_t *addr)
|
|
{
|
|
uint8_t numCommands;
|
|
uint8_t numArgs;
|
|
uint8_t ms;
|
|
|
|
spi_begin();
|
|
|
|
numCommands = pgm_read_byte(addr++); // Number of commands to follow
|
|
|
|
while (numCommands--) // For each command...
|
|
{
|
|
writecommand(pgm_read_byte(addr++)); // Read, issue command
|
|
numArgs = pgm_read_byte(addr++); // Number of args to follow
|
|
ms = numArgs & TFT_INIT_DELAY; // If hibit set, delay follows args
|
|
numArgs &= ~TFT_INIT_DELAY; // Mask out delay bit
|
|
|
|
while (numArgs--) // For each argument...
|
|
{
|
|
writedata(pgm_read_byte(addr++)); // Read, issue argument
|
|
}
|
|
|
|
if (ms)
|
|
{
|
|
ms = pgm_read_byte(addr++); // Read post-command delay time (ms)
|
|
delay( (ms==255 ? 500 : ms) );
|
|
}
|
|
}
|
|
spi_end();
|
|
}
|
|
|
|
|
|
/***************************************************************************************
|
|
** Function name: spiwrite
|
|
** Description: Write 8 bits to SPI port (legacy support only)
|
|
***************************************************************************************/
|
|
void TFT_eSPI::spiwrite(uint8_t c)
|
|
{
|
|
SPI.transfer(c);
|
|
}
|
|
|
|
|
|
/***************************************************************************************
|
|
** Function name: writecommand
|
|
** Description: Send an 8 bit command to the TFT
|
|
***************************************************************************************/
|
|
void TFT_eSPI::writecommand(uint8_t c)
|
|
{
|
|
DC_C;
|
|
CS_L;
|
|
#ifdef SEND_16_BITS
|
|
SPI.transfer(0);
|
|
#endif
|
|
SPI.transfer(c);
|
|
CS_H;
|
|
DC_D;
|
|
}
|
|
|
|
|
|
/***************************************************************************************
|
|
** Function name: writedata
|
|
** Description: Send a 8 bit data value to the TFT
|
|
***************************************************************************************/
|
|
void TFT_eSPI::writedata(uint8_t c)
|
|
{
|
|
CS_L;
|
|
#ifdef SEND_16_BITS
|
|
SPI.transfer(0);
|
|
#endif
|
|
SPI.transfer(c);
|
|
CS_H;
|
|
}
|
|
|
|
|
|
/***************************************************************************************
|
|
** Function name: readcommand8 (for ILI9341 Interface II i.e. IM [3:0] = "1101")
|
|
** Description: Read a 8 bit data value from an indexed command register
|
|
***************************************************************************************/
|
|
uint8_t TFT_eSPI::readcommand8(uint8_t cmd_function, uint8_t index)
|
|
{
|
|
spi_begin();
|
|
index = 0x10 + (index & 0x0F);
|
|
|
|
DC_C;
|
|
CS_L;
|
|
SPI.transfer(0xD9);
|
|
DC_D;
|
|
SPI.transfer(index);
|
|
CS_H;
|
|
|
|
DC_C;
|
|
CS_L;
|
|
SPI.transfer(cmd_function);
|
|
DC_D;
|
|
uint8_t reg = SPI.transfer(0);
|
|
CS_H;
|
|
|
|
spi_end();
|
|
return reg;
|
|
}
|
|
|
|
|
|
/***************************************************************************************
|
|
** Function name: readcommand16 (for ILI9341 Interface II i.e. IM [3:0] = "1101")
|
|
** Description: Read a 16 bit data value from an indexed command register
|
|
***************************************************************************************/
|
|
uint16_t TFT_eSPI::readcommand16(uint8_t cmd_function, uint8_t index)
|
|
{
|
|
uint32_t reg = 0;
|
|
reg |= (readcommand8(cmd_function, index + 0) << 8);
|
|
reg |= (readcommand8(cmd_function, index + 1) << 0);
|
|
|
|
return reg;
|
|
}
|
|
|
|
|
|
/***************************************************************************************
|
|
** Function name: readcommand32 (for ILI9341 Interface II i.e. IM [3:0] = "1101")
|
|
** Description: Read a 32 bit data value from an indexed command register
|
|
***************************************************************************************/
|
|
uint32_t TFT_eSPI::readcommand32(uint8_t cmd_function, uint8_t index)
|
|
{
|
|
uint32_t reg;
|
|
|
|
reg = (readcommand8(cmd_function, index + 0) << 24);
|
|
reg |= (readcommand8(cmd_function, index + 1) << 16);
|
|
reg |= (readcommand8(cmd_function, index + 2) << 8);
|
|
reg |= (readcommand8(cmd_function, index + 3) << 0);
|
|
|
|
return reg;
|
|
}
|
|
|
|
|
|
/***************************************************************************************
|
|
** Function name: read pixel (for SPI Interface II i.e. IM [3:0] = "1101")
|
|
** Description: Read 565 pixel colours from a pixel
|
|
***************************************************************************************/
|
|
uint16_t TFT_eSPI::readPixel(int32_t x0, int32_t y0)
|
|
{
|
|
spi_begin();
|
|
|
|
readAddrWindow(x0, y0, x0, y0); // Sets CS low
|
|
|
|
// Dummy read to throw away don't care value
|
|
SPI.transfer(0);
|
|
|
|
// Read window pixel 24 bit RGB values
|
|
uint8_t r = SPI.transfer(0);
|
|
uint8_t g = SPI.transfer(0);
|
|
uint8_t b = SPI.transfer(0);
|
|
|
|
CS_H;
|
|
|
|
spi_end();
|
|
|
|
return color565(r, g, b);
|
|
}
|
|
|
|
|
|
/***************************************************************************************
|
|
** Function name: read rectangle (for SPI Interface II i.e. IM [3:0] = "1101")
|
|
** Description: Read 565 pixel colours from a defined area
|
|
***************************************************************************************/
|
|
void TFT_eSPI::readRect(uint32_t x, uint32_t y, uint32_t w, uint32_t h, uint16_t *data)
|
|
{
|
|
if ((x > _width) || (y > _height) || (w == 0) || (h == 0)) return;
|
|
|
|
spi_begin();
|
|
|
|
readAddrWindow(x, y, x + w - 1, y + h - 1); // Sets CS low
|
|
|
|
// Dummy read to throw away don't care value
|
|
SPI.transfer(0);
|
|
|
|
// Read window pixel 24 bit RGB values
|
|
uint32_t len = w * h;
|
|
while (len--) {
|
|
// Read the 3 RGB bytes, colour is actually only in the top 6 bits of each byte
|
|
// as the TFT stores colours as 18 bits
|
|
uint8_t r = SPI.transfer(0);
|
|
uint8_t g = SPI.transfer(0);
|
|
uint8_t b = SPI.transfer(0);
|
|
// Swapped colour byte order for compatibility with pushRect()
|
|
*data++ = (r & 0xF8) | (g & 0xE0) >> 5 | (b & 0xF8) << 5 | (g & 0x1C) << 11;
|
|
}
|
|
|
|
// Write NOP command to stop read mode
|
|
//DC_C;
|
|
//SPI.transfer(TFT_NOP);
|
|
//DC_D;
|
|
|
|
CS_H;
|
|
|
|
spi_end();
|
|
}
|
|
|
|
|
|
/***************************************************************************************
|
|
** Function name: push rectangle (for SPI Interface II i.e. IM [3:0] = "1101")
|
|
** Description: push 565 pixel colours into a defined area
|
|
***************************************************************************************/
|
|
void TFT_eSPI::pushRect(uint32_t x, uint32_t y, uint32_t w, uint32_t h, uint16_t *data)
|
|
{
|
|
if ((x > _width) || (y > _height) || (w == 0) || (h == 0)) return;
|
|
|
|
spi_begin();
|
|
|
|
setAddrWindow(x, y, x + w - 1, y + h - 1); // Sets CS low and sent RAMWR
|
|
|
|
uint32_t len = w * h * 2;
|
|
// Push pixels into window rectangle, data is a 16 bit pointer thus increment is halved
|
|
while ( len >=32 ) {SPI.writeBytes((uint8_t*)data, 32); data += 16; len -= 32; }
|
|
if (len) SPI.writeBytes((uint8_t*)data, len);
|
|
|
|
CS_H;
|
|
|
|
spi_end();
|
|
}
|
|
|
|
|
|
/***************************************************************************************
|
|
** Function name: read rectangle (for SPI Interface II i.e. IM [3:0] = "1101")
|
|
** Description: Read RGB pixel colours from a defined area
|
|
***************************************************************************************/
|
|
// If w and h are 1, then 1 pixel is read, *data array size must be 3 bytes per pixel
|
|
void TFT_eSPI::readRectRGB(int32_t x0, int32_t y0, int32_t w, int32_t h, uint8_t *data)
|
|
{
|
|
spi_begin();
|
|
|
|
readAddrWindow(x0, y0, x0 + w - 1, y0 + h - 1); // Sets CS low
|
|
|
|
// Dummy read to throw away don't care value
|
|
SPI.transfer(0);
|
|
|
|
// Read window pixel 24 bit RGB values, buffer must be set in sketch to 3 * w * h
|
|
uint32_t len = w * h;
|
|
while (len--) {
|
|
// Read the 3 RGB bytes, colour is actually only in the top 6 bits of each byte
|
|
// as the TFT stores colours as 18 bits
|
|
*data++ = SPI.transfer(0);
|
|
*data++ = SPI.transfer(0);
|
|
*data++ = SPI.transfer(0);
|
|
}
|
|
CS_H;
|
|
|
|
spi_end();
|
|
}
|
|
|
|
|
|
/***************************************************************************************
|
|
** Function name: drawCircle
|
|
** Description: Draw a circle outline
|
|
***************************************************************************************/
|
|
/*
|
|
// Midpoint circle algorithm, we can optimise this since y = 0 on first pass
|
|
// and we can eliminate the multiply as well
|
|
void TFT_eSPI::drawCircle(int32_t x0, int32_t y0, int32_t radius, uint32_t color)
|
|
{
|
|
int32_t x = radius;
|
|
int32_t y = 0;
|
|
int32_t err = 0;
|
|
|
|
while (x >= y)
|
|
{
|
|
drawPixel(x0 + x, y0 + y, color);
|
|
drawPixel(x0 + x, y0 - y, color);
|
|
drawPixel(x0 - x, y0 - y, color);
|
|
drawPixel(x0 - x, y0 + y, color);
|
|
|
|
drawPixel(x0 + y, y0 + x, color);
|
|
drawPixel(x0 + y, y0 - x, color);
|
|
drawPixel(x0 - y, y0 - x, color);
|
|
drawPixel(x0 - y, y0 + x, color);
|
|
|
|
if (err <= 0)
|
|
{
|
|
y += 1;
|
|
err += 2*y + 1;
|
|
}
|
|
if (err > 0)
|
|
{
|
|
x -= 1;
|
|
err -= 2*x + 1;
|
|
}
|
|
}
|
|
}
|
|
*/
|
|
|
|
// Optimised midpoint circle algorithm
|
|
void TFT_eSPI::drawCircle(int32_t x0, int32_t y0, int32_t r, uint32_t color)
|
|
{
|
|
int32_t x = 0;
|
|
int32_t dx = 1;
|
|
int32_t dy = r+r;
|
|
int32_t p = -(r>>1);
|
|
|
|
// These are ordered to minimise coordinate changes in x or y
|
|
// drawPixel can then send fewer bounding box commands
|
|
drawPixel(x0 + r, y0, color);
|
|
drawPixel(x0 - r, y0, color);
|
|
drawPixel(x0, y0 - r, color);
|
|
drawPixel(x0, y0 + r, color);
|
|
|
|
while(x<r){
|
|
|
|
if(p>=0) {
|
|
dy-=2;
|
|
p-=dy;
|
|
r--;
|
|
}
|
|
|
|
dx+=2;
|
|
p+=dx;
|
|
|
|
x++;
|
|
|
|
// These are ordered to minimise coordinate changes in x or y
|
|
// drawPixel can then send fewer bounding box commands
|
|
drawPixel(x0 + x, y0 + r, color);
|
|
drawPixel(x0 - x, y0 + r, color);
|
|
drawPixel(x0 - x, y0 - r, color);
|
|
drawPixel(x0 + x, y0 - r, color);
|
|
|
|
drawPixel(x0 + r, y0 + x, color);
|
|
drawPixel(x0 - r, y0 + x, color);
|
|
drawPixel(x0 - r, y0 - x, color);
|
|
drawPixel(x0 + r, y0 - x, color);
|
|
}
|
|
}
|
|
|
|
|
|
/***************************************************************************************
|
|
** Function name: drawCircleHelper
|
|
** Description: Support function for circle drawing
|
|
***************************************************************************************/
|
|
void TFT_eSPI::drawCircleHelper( int32_t x0, int32_t y0, int32_t r, uint8_t cornername, uint32_t color)
|
|
{
|
|
int32_t f = 1 - r;
|
|
int32_t ddF_x = 1;
|
|
int32_t ddF_y = -2 * r;
|
|
int32_t x = 0;
|
|
|
|
while (x < r) {
|
|
if (f >= 0) {
|
|
r--;
|
|
ddF_y += 2;
|
|
f += ddF_y;
|
|
}
|
|
x++;
|
|
ddF_x += 2;
|
|
f += ddF_x;
|
|
if (cornername & 0x4) {
|
|
drawPixel(x0 + x, y0 + r, color);
|
|
drawPixel(x0 + r, y0 + x, color);
|
|
}
|
|
if (cornername & 0x2) {
|
|
drawPixel(x0 + x, y0 - r, color);
|
|
drawPixel(x0 + r, y0 - x, color);
|
|
}
|
|
if (cornername & 0x8) {
|
|
drawPixel(x0 - r, y0 + x, color);
|
|
drawPixel(x0 - x, y0 + r, color);
|
|
}
|
|
if (cornername & 0x1) {
|
|
drawPixel(x0 - r, y0 - x, color);
|
|
drawPixel(x0 - x, y0 - r, color);
|
|
}
|
|
}
|
|
}
|
|
|
|
|
|
/***************************************************************************************
|
|
** Function name: fillCircle
|
|
** Description: draw a filled circle
|
|
***************************************************************************************/
|
|
/*
|
|
void TFT_eSPI::fillCircle(int32_t x0, int32_t y0, int32_t r, uint32_t color)
|
|
{
|
|
drawFastVLine(x0, y0 - r, r + r + 1, color);
|
|
fillCircleHelper(x0, y0, r, 3, 0, color);
|
|
}
|
|
*/
|
|
|
|
// Optimised midpoint circle algorithm
|
|
void TFT_eSPI::fillCircle(int32_t x0, int32_t y0, int32_t r, uint32_t color)
|
|
|
|
{
|
|
int32_t x = 0;
|
|
int32_t dx = 1;
|
|
int32_t dy = r+r;
|
|
int32_t p = -(r>>1);
|
|
|
|
drawFastVLine(x0, y0 - r, dy+1, color);
|
|
|
|
while(x<r){
|
|
|
|
if(p>=0) {
|
|
dy-=2;
|
|
p-=dy;
|
|
r--;
|
|
}
|
|
|
|
dx+=2;
|
|
p+=dx;
|
|
|
|
x++;
|
|
|
|
drawFastVLine(x0 + x, y0 - r, 2 * r+1, color);
|
|
drawFastVLine(x0 - x, y0 - r, 2 * r+1, color);
|
|
drawFastVLine(x0 + r, y0 - x, 2 * x+1, color);
|
|
drawFastVLine(x0 - r, y0 - x, 2 * x+1, color);
|
|
|
|
}
|
|
}
|
|
|
|
|
|
/*
|
|
// Another algorithm, this one tends to produce less pretty circles with odd edge pixels
|
|
void TFT_eSPI::fillCircle(int32_t x, int32_t y, int32_t r, uint32_t color)
|
|
{
|
|
for (int y1 = -r; y1 <= 0; y1++)
|
|
for (int x1 = -r; x1 <= 0; x1++)
|
|
if (x1 * x1 + y1 * y1 <= r * r)
|
|
{
|
|
drawFastHLine(x + x1, y + y1, 2 * (-x1), color);
|
|
drawFastHLine(x + x1, y - y1, 2 * (-x1), color);
|
|
break;
|
|
}
|
|
}
|
|
*/
|
|
|
|
|
|
/***************************************************************************************
|
|
** Function name: fillCircleHelper
|
|
** Description: Support function for filled circle drawing
|
|
***************************************************************************************/
|
|
// Used to support drawing roundrects
|
|
void TFT_eSPI::fillCircleHelper(int32_t x0, int32_t y0, int32_t r, uint8_t cornername, int32_t delta, uint32_t color)
|
|
{
|
|
int32_t f = 1 - r;
|
|
int32_t ddF_x = 1;
|
|
int32_t ddF_y = -r - r;
|
|
int32_t x = 0;
|
|
|
|
delta++;
|
|
while (x < r) {
|
|
if (f >= 0) {
|
|
r--;
|
|
ddF_y += 2;
|
|
f += ddF_y;
|
|
}
|
|
x++;
|
|
ddF_x += 2;
|
|
f += ddF_x;
|
|
|
|
if (cornername & 0x1) {
|
|
drawFastVLine(x0 + x, y0 - r, r + r + delta, color);
|
|
drawFastVLine(x0 + r, y0 - x, x + x + delta, color);
|
|
}
|
|
if (cornername & 0x2) {
|
|
drawFastVLine(x0 - x, y0 - r, r + r + delta, color);
|
|
drawFastVLine(x0 - r, y0 - x, x + x + delta, color);
|
|
}
|
|
}
|
|
}
|
|
|
|
|
|
/***************************************************************************************
|
|
** Function name: drawEllipse
|
|
** Description: Draw a ellipse outline
|
|
***************************************************************************************/
|
|
void TFT_eSPI::drawEllipse(int16_t x0, int16_t y0, int16_t rx, int16_t ry, uint16_t color)
|
|
{
|
|
if (rx<2) return;
|
|
if (ry<2) return;
|
|
int32_t x, y;
|
|
int32_t rx2 = rx * rx;
|
|
int32_t ry2 = ry * ry;
|
|
int32_t fx2 = 4 * rx2;
|
|
int32_t fy2 = 4 * ry2;
|
|
int32_t s;
|
|
|
|
for (x = 0, y = ry, s = 2*ry2+rx2*(1-2*ry); ry2*x <= rx2*y; x++)
|
|
{
|
|
// These are ordered to minimise coordinate changes in x or y
|
|
// drawPixel can then send fewer bounding box commands
|
|
drawPixel(x0 + x, y0 + y, color);
|
|
drawPixel(x0 - x, y0 + y, color);
|
|
drawPixel(x0 - x, y0 - y, color);
|
|
drawPixel(x0 + x, y0 - y, color);
|
|
if (s >= 0)
|
|
{
|
|
s += fx2 * (1 - y);
|
|
y--;
|
|
}
|
|
s += ry2 * ((4 * x) + 6);
|
|
}
|
|
|
|
for (x = rx, y = 0, s = 2*rx2+ry2*(1-2*rx); rx2*y <= ry2*x; y++)
|
|
{
|
|
// These are ordered to minimise coordinate changes in x or y
|
|
// drawPixel can then send fewer bounding box commands
|
|
drawPixel(x0 + x, y0 + y, color);
|
|
drawPixel(x0 - x, y0 + y, color);
|
|
drawPixel(x0 - x, y0 - y, color);
|
|
drawPixel(x0 + x, y0 - y, color);
|
|
if (s >= 0)
|
|
{
|
|
s += fy2 * (1 - x);
|
|
x--;
|
|
}
|
|
s += rx2 * ((4 * y) + 6);
|
|
}
|
|
}
|
|
|
|
|
|
/***************************************************************************************
|
|
** Function name: fillEllipse
|
|
** Description: draw a filled ellipse
|
|
***************************************************************************************/
|
|
void TFT_eSPI::fillEllipse(int16_t x0, int16_t y0, int16_t rx, int16_t ry, uint16_t color)
|
|
{
|
|
if (rx<2) return;
|
|
if (ry<2) return;
|
|
int32_t x, y;
|
|
int32_t rx2 = rx * rx;
|
|
int32_t ry2 = ry * ry;
|
|
int32_t fx2 = 4 * rx2;
|
|
int32_t fy2 = 4 * ry2;
|
|
int32_t s;
|
|
|
|
for (x = 0, y = ry, s = 2*ry2+rx2*(1-2*ry); ry2*x <= rx2*y; x++)
|
|
{
|
|
drawFastHLine(x0 - x, y0 - y, x + x + 1, color);
|
|
drawFastHLine(x0 - x, y0 + y, x + x + 1, color);
|
|
|
|
if (s >= 0)
|
|
{
|
|
s += fx2 * (1 - y);
|
|
y--;
|
|
}
|
|
s += ry2 * ((4 * x) + 6);
|
|
}
|
|
|
|
for (x = rx, y = 0, s = 2*rx2+ry2*(1-2*rx); rx2*y <= ry2*x; y++)
|
|
{
|
|
drawFastHLine(x0 - x, y0 - y, x + x + 1, color);
|
|
drawFastHLine(x0 - x, y0 + y, x + x + 1, color);
|
|
|
|
if (s >= 0)
|
|
{
|
|
s += fy2 * (1 - x);
|
|
x--;
|
|
}
|
|
s += rx2 * ((4 * y) + 6);
|
|
}
|
|
|
|
}
|
|
|
|
|
|
/***************************************************************************************
|
|
** Function name: fillScreen
|
|
** Description: Clear the screen to defined colour
|
|
***************************************************************************************/
|
|
void TFT_eSPI::fillScreen(uint32_t color)
|
|
{
|
|
fillRect(0, 0, _width, _height, color);
|
|
}
|
|
|
|
|
|
/***************************************************************************************
|
|
** Function name: drawRect
|
|
** Description: Draw a rectangle outline
|
|
***************************************************************************************/
|
|
// Draw a rectangle
|
|
void TFT_eSPI::drawRect(int32_t x, int32_t y, int32_t w, int32_t h, uint32_t color)
|
|
{
|
|
drawFastHLine(x, y, w, color);
|
|
drawFastHLine(x, y + h - 1, w, color);
|
|
drawFastVLine(x, y, h, color);
|
|
drawFastVLine(x + w - 1, y, h, color);
|
|
}
|
|
|
|
|
|
/***************************************************************************************
|
|
** Function name: drawRoundRect
|
|
** Description: Draw a rounded corner rectangle outline
|
|
***************************************************************************************/
|
|
// Draw a rounded rectangle
|
|
void TFT_eSPI::drawRoundRect(int32_t x, int32_t y, int32_t w, int32_t h, int32_t r, uint32_t color)
|
|
{
|
|
// smarter version
|
|
drawFastHLine(x + r , y , w - r - r, color); // Top
|
|
drawFastHLine(x + r , y + h - 1, w - r - r, color); // Bottom
|
|
drawFastVLine(x , y + r , h - r - r, color); // Left
|
|
drawFastVLine(x + w - 1, y + r , h - r - r, color); // Right
|
|
// draw four corners
|
|
drawCircleHelper(x + r , y + r , r, 1, color);
|
|
drawCircleHelper(x + w - r - 1, y + r , r, 2, color);
|
|
drawCircleHelper(x + w - r - 1, y + h - r - 1, r, 4, color);
|
|
drawCircleHelper(x + r , y + h - r - 1, r, 8, color);
|
|
}
|
|
|
|
|
|
/***************************************************************************************
|
|
** Function name: fillRoundRect
|
|
** Description: Draw a rounded corner filled rectangle
|
|
***************************************************************************************/
|
|
// Fill a rounded rectangle
|
|
void TFT_eSPI::fillRoundRect(int32_t x, int32_t y, int32_t w, int32_t h, int32_t r, uint32_t color)
|
|
{
|
|
// smarter version
|
|
fillRect(x + r, y, w - r - r, h, color);
|
|
|
|
// draw four corners
|
|
fillCircleHelper(x + w - r - 1, y + r, r, 1, h - r - r - 1, color);
|
|
fillCircleHelper(x + r , y + r, r, 2, h - r - r - 1, color);
|
|
}
|
|
|
|
|
|
/***************************************************************************************
|
|
** Function name: drawTriangle
|
|
** Description: Draw a triangle outline using 3 arbitrary points
|
|
***************************************************************************************/
|
|
// Draw a triangle
|
|
void TFT_eSPI::drawTriangle(int32_t x0, int32_t y0, int32_t x1, int32_t y1, int32_t x2, int32_t y2, uint32_t color)
|
|
{
|
|
drawLine(x0, y0, x1, y1, color);
|
|
drawLine(x1, y1, x2, y2, color);
|
|
drawLine(x2, y2, x0, y0, color);
|
|
}
|
|
|
|
|
|
/***************************************************************************************
|
|
** Function name: fillTriangle
|
|
** Description: Draw a filled triangle using 3 arbitrary points
|
|
***************************************************************************************/
|
|
// Fill a triangle - original Adafruit function works well and code footprint is small
|
|
void TFT_eSPI::fillTriangle ( int32_t x0, int32_t y0, int32_t x1, int32_t y1, int32_t x2, int32_t y2, uint32_t color)
|
|
{
|
|
int32_t a, b, y, last;
|
|
|
|
// Sort coordinates by Y order (y2 >= y1 >= y0)
|
|
if (y0 > y1) {
|
|
swap(y0, y1); swap(x0, x1);
|
|
}
|
|
if (y1 > y2) {
|
|
swap(y2, y1); swap(x2, x1);
|
|
}
|
|
if (y0 > y1) {
|
|
swap(y0, y1); swap(x0, x1);
|
|
}
|
|
|
|
if (y0 == y2) { // Handle awkward all-on-same-line case as its own thing
|
|
a = b = x0;
|
|
if (x1 < a) a = x1;
|
|
else if (x1 > b) b = x1;
|
|
if (x2 < a) a = x2;
|
|
else if (x2 > b) b = x2;
|
|
drawFastHLine(a, y0, b - a + 1, color);
|
|
return;
|
|
}
|
|
|
|
int32_t
|
|
dx01 = x1 - x0,
|
|
dy01 = y1 - y0,
|
|
dx02 = x2 - x0,
|
|
dy02 = y2 - y0,
|
|
dx12 = x2 - x1,
|
|
dy12 = y2 - y1,
|
|
sa = 0,
|
|
sb = 0;
|
|
|
|
// For upper part of triangle, find scanline crossings for segments
|
|
// 0-1 and 0-2. If y1=y2 (flat-bottomed triangle), the scanline y1
|
|
// is included here (and second loop will be skipped, avoiding a /0
|
|
// error there), otherwise scanline y1 is skipped here and handled
|
|
// in the second loop...which also avoids a /0 error here if y0=y1
|
|
// (flat-topped triangle).
|
|
if (y1 == y2) last = y1; // Include y1 scanline
|
|
else last = y1 - 1; // Skip it
|
|
|
|
for (y = y0; y <= last; y++) {
|
|
a = x0 + sa / dy01;
|
|
b = x0 + sb / dy02;
|
|
sa += dx01;
|
|
sb += dx02;
|
|
|
|
if (a > b) swap(a, b);
|
|
drawFastHLine(a, y, b - a + 1, color);
|
|
}
|
|
|
|
// For lower part of triangle, find scanline crossings for segments
|
|
// 0-2 and 1-2. This loop is skipped if y1=y2.
|
|
sa = dx12 * (y - y1);
|
|
sb = dx02 * (y - y0);
|
|
for (; y <= y2; y++) {
|
|
a = x1 + sa / dy12;
|
|
b = x0 + sb / dy02;
|
|
sa += dx12;
|
|
sb += dx02;
|
|
|
|
if (a > b) swap(a, b);
|
|
drawFastHLine(a, y, b - a + 1, color);
|
|
}
|
|
}
|
|
|
|
|
|
/***************************************************************************************
|
|
** Function name: drawBitmap
|
|
** Description: Draw an image stored in an array on the TFT
|
|
***************************************************************************************/
|
|
void TFT_eSPI::drawBitmap(int16_t x, int16_t y, const uint8_t *bitmap, int16_t w, int16_t h, uint16_t color) {
|
|
|
|
int32_t i, j, byteWidth = (w + 7) / 8;
|
|
|
|
for (j = 0; j < h; j++) {
|
|
for (i = 0; i < w; i++ ) {
|
|
if (pgm_read_byte(bitmap + j * byteWidth + i / 8) & (128 >> (i & 7))) {
|
|
drawPixel(x + i, y + j, color);
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
|
|
/***************************************************************************************
|
|
** Function name: setCursor
|
|
** Description: Set the text cursor x,y position
|
|
***************************************************************************************/
|
|
void TFT_eSPI::setCursor(int16_t x, int16_t y)
|
|
{
|
|
cursor_x = x;
|
|
cursor_y = y;
|
|
}
|
|
|
|
|
|
/***************************************************************************************
|
|
** Function name: setCursor
|
|
** Description: Set the text cursor x,y position and font
|
|
***************************************************************************************/
|
|
void TFT_eSPI::setCursor(int16_t x, int16_t y, uint8_t font)
|
|
{
|
|
textfont = font;
|
|
cursor_x = x;
|
|
cursor_y = y;
|
|
}
|
|
|
|
|
|
/***************************************************************************************
|
|
** Function name: setTextSize
|
|
** Description: Set the text size multiplier
|
|
***************************************************************************************/
|
|
void TFT_eSPI::setTextSize(uint8_t s)
|
|
{
|
|
if (s>7) s = 7; // Limit the maximum size multiplier so byte variables can be used for rendering
|
|
textsize = (s > 0) ? s : 1; // Don't allow font size 0
|
|
}
|
|
|
|
|
|
/***************************************************************************************
|
|
** Function name: setTextColor
|
|
** Description: Set the font foreground colour (background is transparent)
|
|
***************************************************************************************/
|
|
void TFT_eSPI::setTextColor(uint16_t c)
|
|
{
|
|
// For 'transparent' background, we'll set the bg
|
|
// to the same as fg instead of using a flag
|
|
textcolor = textbgcolor = c;
|
|
}
|
|
|
|
|
|
/***************************************************************************************
|
|
** Function name: setTextColor
|
|
** Description: Set the font foreground and background colour
|
|
***************************************************************************************/
|
|
void TFT_eSPI::setTextColor(uint16_t c, uint16_t b)
|
|
{
|
|
textcolor = c;
|
|
textbgcolor = b;
|
|
}
|
|
|
|
|
|
/***************************************************************************************
|
|
** Function name: setTextWrap
|
|
** Description: Define if text should wrap at end of line
|
|
***************************************************************************************/
|
|
void TFT_eSPI::setTextWrap(boolean w)
|
|
{
|
|
textwrap = w;
|
|
}
|
|
|
|
|
|
/***************************************************************************************
|
|
** Function name: setTextDatum
|
|
** Description: Set the text position reference datum
|
|
***************************************************************************************/
|
|
void TFT_eSPI::setTextDatum(uint8_t d)
|
|
{
|
|
textdatum = d;
|
|
}
|
|
|
|
|
|
/***************************************************************************************
|
|
** Function name: setTextPadding
|
|
** Description: Define padding width (aids erasing old text and numbers)
|
|
***************************************************************************************/
|
|
void TFT_eSPI::setTextPadding(uint16_t x_width)
|
|
{
|
|
padX = x_width;
|
|
}
|
|
|
|
|
|
/***************************************************************************************
|
|
** Function name: getRotation
|
|
** Description: Return the rotation value (as used by setRotation())
|
|
***************************************************************************************/
|
|
uint8_t TFT_eSPI::getRotation(void)
|
|
{
|
|
return rotation;
|
|
}
|
|
|
|
|
|
/***************************************************************************************
|
|
** Function name: width
|
|
** Description: Return the pixel width of display (per current rotation)
|
|
***************************************************************************************/
|
|
// Return the size of the display (per current rotation)
|
|
int16_t TFT_eSPI::width(void)
|
|
{
|
|
return _width;
|
|
}
|
|
|
|
|
|
/***************************************************************************************
|
|
** Function name: height
|
|
** Description: Return the pixel height of display (per current rotation)
|
|
***************************************************************************************/
|
|
int16_t TFT_eSPI::height(void)
|
|
{
|
|
return _height;
|
|
}
|
|
|
|
|
|
/***************************************************************************************
|
|
** Function name: textWidth
|
|
** Description: Return the width in pixels of a string in a given font
|
|
***************************************************************************************/
|
|
int16_t TFT_eSPI::textWidth(const String& string)
|
|
{
|
|
int16_t len = string.length() + 2;
|
|
char buffer[len];
|
|
string.toCharArray(buffer, len);
|
|
return textWidth(buffer, textfont);
|
|
}
|
|
|
|
int16_t TFT_eSPI::textWidth(const String& string, int font)
|
|
{
|
|
int16_t len = string.length() + 2;
|
|
char buffer[len];
|
|
string.toCharArray(buffer, len);
|
|
return textWidth(buffer, font);
|
|
}
|
|
|
|
int16_t TFT_eSPI::textWidth(const char *string)
|
|
{
|
|
return textWidth(string, textfont);
|
|
}
|
|
|
|
int16_t TFT_eSPI::textWidth(const char *string, int font)
|
|
{
|
|
unsigned int str_width = 0;
|
|
char uniCode;
|
|
char *widthtable;
|
|
|
|
if (font>1 && font<9)
|
|
{
|
|
widthtable = (char *)pgm_read_dword( &(fontdata[font].widthtbl ) ) - 32; //subtract the 32 outside the loop
|
|
|
|
while (*string)
|
|
{
|
|
uniCode = *(string++);
|
|
|
|
str_width += pgm_read_byte( widthtable + uniCode); // Normally we need to subract 32 from uniCode
|
|
}
|
|
}
|
|
else
|
|
{
|
|
|
|
#ifdef LOAD_GFXFF
|
|
if(gfxFont) // New font
|
|
{
|
|
while (*string)
|
|
{
|
|
uniCode = *(string++);
|
|
if (uniCode > (uint8_t)pgm_read_byte(&gfxFont->last)) uniCode = pgm_read_byte(&gfxFont->first);
|
|
uniCode -= pgm_read_byte(&gfxFont->first);
|
|
GFXglyph *glyph = &(((GFXglyph *)pgm_read_dword(&gfxFont->glyph))[uniCode]);
|
|
// If this is not the last character then use xAdvance
|
|
if (*string) str_width += pgm_read_byte(&glyph->xAdvance);
|
|
// Else use the offset plus width since this can be bigger than xAdvance
|
|
else str_width += ((int8_t)pgm_read_byte(&glyph->xOffset) + pgm_read_byte(&glyph->width));
|
|
}
|
|
}
|
|
else
|
|
#endif
|
|
{
|
|
#ifdef LOAD_GLCD
|
|
while (*string++) str_width += 6;
|
|
#endif
|
|
}
|
|
}
|
|
return str_width * textsize;
|
|
}
|
|
|
|
|
|
/***************************************************************************************
|
|
** Function name: fontsLoaded
|
|
** Description: return an encoded 16 bit value showing the fonts loaded
|
|
***************************************************************************************/
|
|
// Returns a value showing which fonts are loaded (bit N set = Font N loaded)
|
|
|
|
uint16_t TFT_eSPI::fontsLoaded(void)
|
|
{
|
|
return fontsloaded;
|
|
}
|
|
|
|
|
|
/***************************************************************************************
|
|
** Function name: fontHeight
|
|
** Description: return the height of a font (yAdvance for free fonts)
|
|
***************************************************************************************/
|
|
int16_t TFT_eSPI::fontHeight(int16_t font)
|
|
{
|
|
#ifdef LOAD_GFXFF
|
|
if (font==1)
|
|
{
|
|
if(gfxFont) // New font
|
|
{
|
|
return pgm_read_byte(&gfxFont->yAdvance) * textsize;
|
|
}
|
|
}
|
|
#endif
|
|
return pgm_read_byte( &fontdata[font].height ) * textsize;
|
|
}
|
|
|
|
|
|
/***************************************************************************************
|
|
** Function name: drawChar
|
|
** Description: draw a single character in the Adafruit GLCD font
|
|
***************************************************************************************/
|
|
void TFT_eSPI::drawChar(int32_t x, int32_t y, unsigned char c, uint32_t color, uint32_t bg, uint8_t size)
|
|
{
|
|
if ((x >= (int16_t)_width) || // Clip right
|
|
(y >= (int16_t)_height) || // Clip bottom
|
|
((x + 6 * size - 1) < 0) || // Clip left
|
|
((y + 8 * size - 1) < 0)) // Clip top
|
|
return;
|
|
|
|
#ifdef LOAD_GLCD
|
|
//>>>>>>>>>>>>>>>>>>
|
|
#ifdef LOAD_GFXFF
|
|
if(!gfxFont) { // 'Classic' built-in font
|
|
#endif
|
|
//>>>>>>>>>>>>>>>>>>
|
|
|
|
boolean fillbg = (bg != color);
|
|
|
|
spi_begin();
|
|
|
|
if ((size==1) && fillbg)
|
|
{
|
|
byte column[6];
|
|
byte mask = 0x1;
|
|
setAddrWindow(x, y, x+5, y+8);
|
|
for (int8_t i = 0; i < 5; i++ ) column[i] = pgm_read_byte(font + (c * 5) + i);
|
|
column[5] = 0;
|
|
uint32_t spimask = ~((SPIMMOSI << SPILMOSI) | (SPIMMISO << SPILMISO));
|
|
SPI1U1 = spimask | (15 << SPILMOSI) | (15 << SPILMISO);
|
|
for (int8_t j = 0; j < 8; j++) {
|
|
for (int8_t k = 0; k < 5; k++ ) {
|
|
if (column[k] & mask) {
|
|
SPI1W0 = (color >> 8) | (color << 8);
|
|
}
|
|
else {
|
|
SPI1W0 = (bg >> 8) | (bg << 8);
|
|
}
|
|
SPI1CMD |= SPIBUSY;
|
|
while(SPI1CMD & SPIBUSY) {}
|
|
}
|
|
|
|
mask <<= 1;
|
|
|
|
SPI1W0 = (bg >> 8) | (bg << 8);
|
|
SPI1CMD |= SPIBUSY;
|
|
while(SPI1CMD & SPIBUSY) {}
|
|
}
|
|
CS_H;
|
|
}
|
|
else
|
|
{
|
|
for (int8_t i = 0; i < 6; i++ ) {
|
|
uint8_t line;
|
|
if (i == 5)
|
|
line = 0x0;
|
|
else
|
|
line = pgm_read_byte(font + (c * 5) + i);
|
|
|
|
if (size == 1) // default size
|
|
{
|
|
for (int8_t j = 0; j < 8; j++) {
|
|
if (line & 0x1) drawPixel(x + i, y + j, color);
|
|
line >>= 1;
|
|
}
|
|
}
|
|
else { // big size
|
|
for (int8_t j = 0; j < 8; j++) {
|
|
if (line & 0x1) fillRect(x + (i * size), y + (j * size), size, size, color);
|
|
else if (fillbg) fillRect(x + i * size, y + j * size, size, size, bg);
|
|
line >>= 1;
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
//>>>>>>>>>>>>>>>>>>>>>>>>>>>
|
|
#ifdef LOAD_GFXFF
|
|
} else { // Custom font
|
|
#endif
|
|
//>>>>>>>>>>>>>>>>>>>>>>>>>>>
|
|
#endif // LOAD_GLCD
|
|
|
|
#ifdef LOAD_GFXFF
|
|
//>>>>>>>>>>>>>>>>>>>>>>>>>>>
|
|
// Character is assumed previously filtered by write() to eliminate
|
|
// newlines, returns, non-printable characters, etc. Calling drawChar()
|
|
// directly with 'bad' characters of font may cause mayhem!
|
|
if (c > pgm_read_byte(&gfxFont->last)) c = pgm_read_byte(&gfxFont->first);;
|
|
c -= pgm_read_byte(&gfxFont->first);
|
|
GFXglyph *glyph = &(((GFXglyph *)pgm_read_dword(&gfxFont->glyph))[c]);
|
|
uint8_t *bitmap = (uint8_t *)pgm_read_dword(&gfxFont->bitmap);
|
|
|
|
uint16_t bo = pgm_read_word(&glyph->bitmapOffset);
|
|
uint8_t w = pgm_read_byte(&glyph->width),
|
|
h = pgm_read_byte(&glyph->height),
|
|
xa = pgm_read_byte(&glyph->xAdvance);
|
|
int8_t xo = pgm_read_byte(&glyph->xOffset),
|
|
yo = pgm_read_byte(&glyph->yOffset);
|
|
uint8_t xx, yy, bits, bit=0;
|
|
int16_t xo16, yo16;
|
|
|
|
if(size > 1) {
|
|
xo16 = xo;
|
|
yo16 = yo;
|
|
}
|
|
|
|
// Todo: Add character clipping here
|
|
|
|
// NOTE: THERE IS NO 'BACKGROUND' COLOR OPTION ON CUSTOM FONTS.
|
|
// THIS IS ON PURPOSE AND BY DESIGN. The background color feature
|
|
// has typically been used with the 'classic' font to overwrite old
|
|
// screen contents with new data. This ONLY works because the
|
|
// characters are a uniform size; it's not a sensible thing to do with
|
|
// proportionally-spaced fonts with glyphs of varying sizes (and that
|
|
// may overlap). To replace previously-drawn text when using a custom
|
|
// font, use the getTextBounds() function to determine the smallest
|
|
// rectangle encompassing a string, erase the area with fillRect(),
|
|
// then draw new text. This WILL infortunately 'blink' the text, but
|
|
// is unavoidable. Drawing 'background' pixels will NOT fix this,
|
|
// only creates a new set of problems. Have an idea to work around
|
|
// this (a canvas object type for MCUs that can afford the RAM and
|
|
// displays supporting setAddrWindow() and pushColors()), but haven't
|
|
// implemented this yet.
|
|
|
|
// Here we have 3 versions of the same function just for evaluation purposes
|
|
// Comment out the next two #defines to revert to the slower Adafruit implementation
|
|
|
|
// If FAST_LINE is defined then the free fonts are rendered using horizontal lines
|
|
// this makes rendering fonts 2-5 times faster. Particularly good for large fonts.
|
|
// This is an elegant solution since it still uses generic functions present in the
|
|
// stock library.
|
|
|
|
// If FAST_SHIFT is defined then a slightly faster (at least for AVR processors)
|
|
// shifting bit mask is used
|
|
|
|
// Free fonts don't look good when the size multiplier is >1 so we could remove
|
|
// code if this is not wanted and speed things up
|
|
|
|
#define FAST_HLINE
|
|
#define FAST_SHIFT
|
|
//FIXED_SIZE is an option in User_Setup.h that only works with FAST_LINE enabled
|
|
|
|
#ifdef FIXED_SIZE
|
|
x+=xo; // Save 88 bytes of FLASH
|
|
y+=yo;
|
|
#endif
|
|
|
|
#ifdef FAST_HLINE
|
|
|
|
#ifdef FAST_SHIFT
|
|
uint16_t hpc = 0; // Horizontal foreground pixel count
|
|
for(yy=0; yy<h; yy++) {
|
|
for(xx=0; xx<w; xx++) {
|
|
if(bit == 0) {
|
|
bits = pgm_read_byte(&bitmap[bo++]);
|
|
bit = 0x80;
|
|
}
|
|
if(bits & bit) hpc++;
|
|
else {
|
|
if (hpc) {
|
|
#ifndef FIXED_SIZE
|
|
if(size == 1) drawFastHLine(x+xo+xx-hpc, y+yo+yy, hpc, color);
|
|
else fillRect(x+(xo16+xx-hpc)*size, y+(yo16+yy)*size, size*hpc, size, color);
|
|
#else
|
|
drawFastHLine(x+xx-hpc, y+yy, hpc, color);
|
|
#endif
|
|
hpc=0;
|
|
}
|
|
}
|
|
bit >>= 1;
|
|
}
|
|
// Draw pixels for this line as we are about to increment yy
|
|
if (hpc) {
|
|
#ifndef FIXED_SIZE
|
|
if(size == 1) drawFastHLine(x+xo+xx-hpc, y+yo+yy, hpc, color);
|
|
else fillRect(x+(xo16+xx-hpc)*size, y+(yo16+yy)*size, size*hpc, size, color);
|
|
#else
|
|
drawFastHLine(x+xx-hpc, y+yy, hpc, color);
|
|
#endif
|
|
hpc=0;
|
|
}
|
|
}
|
|
#else
|
|
uint16_t hpc = 0; // Horizontal foreground pixel count
|
|
for(yy=0; yy<h; yy++) {
|
|
for(xx=0; xx<w; xx++) {
|
|
if(!(bit++ & 7)) {
|
|
bits = pgm_read_byte(&bitmap[bo++]);
|
|
}
|
|
if(bits & 0x80) hpc++;
|
|
else {
|
|
if (hpc) {
|
|
if(size == 1) drawFastHLine(x+xo+xx-hpc, y+yo+yy, hpc, color);
|
|
else fillRect(x+(xo16+xx-hpc)*size, y+(yo16+yy)*size, size*hpc, size, color);
|
|
hpc=0;
|
|
}
|
|
}
|
|
bits <<= 1;
|
|
}
|
|
// Draw pixels for this line as we are about to increment yy
|
|
if (hpc) {
|
|
if(size == 1) drawFastHLine(x+xo+xx-hpc, y+yo+yy, hpc, color);
|
|
else fillRect(x+(xo16+xx-hpc)*size, y+(yo16+yy)*size, size*hpc, size, color);
|
|
hpc=0;
|
|
}
|
|
}
|
|
#endif
|
|
|
|
#else
|
|
for(yy=0; yy<h; yy++) {
|
|
for(xx=0; xx<w; xx++) {
|
|
if(!(bit++ & 7)) {
|
|
bits = pgm_read_byte(&bitmap[bo++]);
|
|
}
|
|
if(bits & 0x80) {
|
|
if(size == 1) {
|
|
drawPixel(x+xo+xx, y+yo+yy, color);
|
|
} else {
|
|
fillRect(x+(xo16+xx)*size, y+(yo16+yy)*size, size, size, color);
|
|
}
|
|
}
|
|
bits <<= 1;
|
|
}
|
|
}
|
|
#endif
|
|
#endif
|
|
|
|
|
|
#ifdef LOAD_GLCD
|
|
#ifdef LOAD_GFXFF
|
|
} // End classic vs custom font
|
|
#endif
|
|
#endif
|
|
|
|
spi_end();
|
|
}
|
|
|
|
|
|
/***************************************************************************************
|
|
** Function name: setWindow
|
|
** Description: define an area to receive a stream of pixels
|
|
***************************************************************************************/
|
|
// Chip select is high at the end of this function
|
|
|
|
void TFT_eSPI::setWindow(int16_t x0, int16_t y0, int16_t x1, int16_t y1)
|
|
{
|
|
spi_begin();
|
|
setAddrWindow(x0, y0, x1, y1);
|
|
CS_H;
|
|
spi_end();
|
|
}
|
|
|
|
|
|
/***************************************************************************************
|
|
** Function name: setAddrWindow
|
|
** Description: define an area to receive a stream of pixels
|
|
***************************************************************************************/
|
|
// Chip select stays low, use setWindow() from sketches
|
|
|
|
#if defined (ESP8266) && !defined (RPI_WRITE_STROBE) && !defined (RPI_ILI9486_DRIVER)
|
|
inline void TFT_eSPI::setAddrWindow(int32_t xs, int32_t ys, int32_t xe, int32_t ye)
|
|
{
|
|
spi_begin();
|
|
|
|
addr_col = 0xFFFF;
|
|
addr_row = 0xFFFF;
|
|
|
|
#if defined (ST7735_DRIVER) && (defined (ST7735_GREENTAB) || defined (ST7735_GREENTAB2) || defined (ST7735_GREENTAB3))
|
|
xs+=colstart;
|
|
xe+=colstart;
|
|
ys+=rowstart;
|
|
ye+=rowstart;
|
|
#endif
|
|
|
|
// Column addr set
|
|
DC_C;
|
|
CS_L;
|
|
|
|
uint32_t mask = ~((SPIMMOSI << SPILMOSI) | (SPIMMISO << SPILMISO));
|
|
mask = SPI1U1 & mask;
|
|
|
|
SPI1U1 = mask | (CMD_BITS << SPILMOSI) | (CMD_BITS << SPILMISO);
|
|
|
|
SPI1W0 = TFT_CASET;
|
|
SPI1CMD |= SPIBUSY;
|
|
while(SPI1CMD & SPIBUSY) {}
|
|
|
|
DC_D;
|
|
|
|
SPI1U1 = mask | (31 << SPILMOSI) | (31 << SPILMISO);
|
|
// Load the two coords as a 32 bit value and shift in one go
|
|
SPI1W0 = (xs >> 8) | (uint16_t)(xs << 8) | ((uint8_t)(xe >> 8)<<16 | (xe << 24));
|
|
SPI1CMD |= SPIBUSY;
|
|
while(SPI1CMD & SPIBUSY) {}
|
|
|
|
// This proves we can only change the byte level bit SPI register read-out order, not the actual byte order
|
|
// So we can't use this method to avoid coordinate byte order swapping!
|
|
//uint32_t x = (xs << 16) | xe;
|
|
// Swap bits in 32 bit word end for end
|
|
//x = (((x & 0xAAAAAAAA) >> 1) | ((x & 0x55555555) << 1));
|
|
//x = (((x & 0xCCCCCCCC) >> 2) | ((x & 0x33333333) << 2));
|
|
//x = (((x & 0xF0F0F0F0) >> 4) | ((x & 0x0F0F0F0F) << 4));
|
|
//x = (((x & 0xFF00FF00) >> 8) | ((x & 0x00FF00FF) << 8));
|
|
//x = (x >> 16) | (x << 16);
|
|
//SPI1W0 = x;
|
|
//SPI1C |= (SPICWBO | SPICRBO); // LSB first
|
|
//SPI1CMD |= SPIBUSY;
|
|
//while(SPI1CMD & SPIBUSY) {}
|
|
//SPI1C &= ~(SPICWBO | SPICRBO); // MSB first = default
|
|
|
|
// Row addr set
|
|
DC_C;
|
|
|
|
SPI1U1 = mask | (CMD_BITS << SPILMOSI) | (CMD_BITS << SPILMISO);
|
|
|
|
SPI1W0 = TFT_PASET;
|
|
SPI1CMD |= SPIBUSY;
|
|
while(SPI1CMD & SPIBUSY) {}
|
|
|
|
DC_D;
|
|
|
|
SPI1U1 = mask | (31 << SPILMOSI) | (31 << SPILMISO);
|
|
// Load the two coords as a 32 bit value and shift in one go
|
|
SPI1W0 = (ys >> 8) | (uint16_t)(ys << 8) | ((uint8_t)(ye >> 8)<<16 | (ye << 24));
|
|
SPI1CMD |= SPIBUSY;
|
|
while(SPI1CMD & SPIBUSY) {}
|
|
|
|
// write to RAM
|
|
DC_C;
|
|
|
|
SPI1U1 = mask | (CMD_BITS << SPILMOSI) | (CMD_BITS << SPILMISO);
|
|
SPI1W0 = TFT_RAMWR;
|
|
SPI1CMD |= SPIBUSY;
|
|
while(SPI1CMD & SPIBUSY) {}
|
|
|
|
DC_D;
|
|
|
|
spi_end();
|
|
}
|
|
|
|
#elif defined (ESP8266) && !defined (RPI_WRITE_STROBE) && defined (RPI_ILI9486_DRIVER) // This is for the RPi display that needs 16 bits
|
|
|
|
inline void TFT_eSPI::setAddrWindow(int32_t xs, int32_t ys, int32_t xe, int32_t ye)
|
|
{
|
|
spi_begin();
|
|
|
|
addr_col = 0xFFFF;
|
|
addr_row = 0xFFFF;
|
|
|
|
// Column addr set
|
|
DC_C;
|
|
CS_L;
|
|
|
|
uint32_t mask = ~((SPIMMOSI << SPILMOSI) | (SPIMMISO << SPILMISO));
|
|
mask = SPI1U1 & mask;
|
|
|
|
SPI1U1 = mask | (CMD_BITS << SPILMOSI) | (CMD_BITS << SPILMISO);
|
|
|
|
SPI1W0 = TFT_CASET<<8;
|
|
SPI1CMD |= SPIBUSY;
|
|
while(SPI1CMD & SPIBUSY) {}
|
|
|
|
DC_D;
|
|
|
|
uint8_t xBin[] = { 0, (uint8_t) (xs>>8), 0, (uint8_t) (xs>>0), 0, (uint8_t) (xe>>8), 0, (uint8_t) (xe>>0), };
|
|
SPI.writePattern(&xBin[0], 8, 1);
|
|
|
|
// Row addr set
|
|
DC_C;
|
|
|
|
SPI1U1 = mask | (CMD_BITS << SPILMOSI) | (CMD_BITS << SPILMISO);
|
|
|
|
SPI1W0 = TFT_PASET<<8;
|
|
SPI1CMD |= SPIBUSY;
|
|
while(SPI1CMD & SPIBUSY) {}
|
|
|
|
DC_D;
|
|
|
|
uint8_t yBin[] = { 0, (uint8_t) (ys>>8), 0, (uint8_t) (ys>>0), 0, (uint8_t) (ye>>8), 0, (uint8_t) (ye>>0), };
|
|
SPI.writePattern(&yBin[0], 8, 1);
|
|
|
|
// write to RAM
|
|
DC_C;
|
|
|
|
SPI1U1 = mask | (CMD_BITS << SPILMOSI) | (CMD_BITS << SPILMISO);
|
|
SPI1W0 = TFT_RAMWR<<8;
|
|
SPI1CMD |= SPIBUSY;
|
|
while(SPI1CMD & SPIBUSY) {}
|
|
|
|
DC_D;
|
|
|
|
spi_end();
|
|
}
|
|
|
|
#else // This is for the ESP32 where we cannot use low level register access (yet)
|
|
|
|
#if defined (RPI_ILI9486_DRIVER) // This is for the RPi display that needs 16 bits
|
|
inline void TFT_eSPI::setAddrWindow(int32_t x0, int32_t y0, int32_t x1, int32_t y1)
|
|
{
|
|
spi_begin();
|
|
|
|
addr_col = 0xFFFF;
|
|
addr_row = 0xFFFF;
|
|
|
|
CS_L;
|
|
uint32_t mask = ~((SPIMMOSI << SPILMOSI) | (SPIMMISO << SPILMISO));
|
|
mask = SPI1U1 & mask;
|
|
SPI1U1 = mask | (CMD_BITS << SPILMOSI) | (CMD_BITS << SPILMISO);
|
|
|
|
// Column addr set
|
|
DC_C;
|
|
|
|
//SPI.write16(TFT_CASET);
|
|
//SPI1U1 = mask | (CMD_BITS << SPILMOSI) | (CMD_BITS << SPILMISO);
|
|
SPI1W0 = TFT_CASET<<(CMD_BITS + 1 - 8);
|
|
SPI1CMD |= SPIBUSY;
|
|
while(SPI1CMD & SPIBUSY) {}
|
|
DC_D;
|
|
|
|
//SPI.write16(x >> 8); // Not tested on ESP32 <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<
|
|
//SPI1U1 = mask | (CMD_BITS << SPILMOSI) | (CMD_BITS << SPILMISO);
|
|
SPI1W0 = x0 >> 0;
|
|
SPI1CMD |= SPIBUSY;
|
|
while(SPI1CMD & SPIBUSY) {}
|
|
//DC_D; // Small delay
|
|
//SPI.write16(x);
|
|
//SPI1U1 = mask | (CMD_BITS << SPILMOSI) | (CMD_BITS << SPILMISO);
|
|
SPI1W0 = x0 << 8;
|
|
SPI1CMD |= SPIBUSY;
|
|
while(SPI1CMD & SPIBUSY) {}
|
|
//DC_D; // Small delay
|
|
//SPI.write16(x >> 8);
|
|
//SPI1U1 = mask | (CMD_BITS << SPILMOSI) | (CMD_BITS << SPILMISO);
|
|
SPI1W0 = x1 >> 0;
|
|
SPI1CMD |= SPIBUSY;
|
|
while(SPI1CMD & SPIBUSY) {}
|
|
//DC_D; // Small delay
|
|
//SPI.write16(x);
|
|
//SPI1U1 = mask | (CMD_BITS << SPILMOSI) | (CMD_BITS << SPILMISO);
|
|
SPI1W0 = x1 << 8;
|
|
SPI1CMD |= SPIBUSY;
|
|
while(SPI1CMD & SPIBUSY) {}
|
|
|
|
// Row addr set
|
|
DC_C;
|
|
|
|
//SPI.write16(TFT_PASET);
|
|
//SPI1U1 = mask | (CMD_BITS << SPILMOSI) | (CMD_BITS << SPILMISO);
|
|
SPI1W0 = TFT_PASET<<(CMD_BITS + 1 - 8);
|
|
SPI1CMD |= SPIBUSY;
|
|
while(SPI1CMD & SPIBUSY) {}
|
|
DC_D;
|
|
|
|
//SPI.write16(y >> 8); // Not tested on ESP32 <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<
|
|
//SPI1U1 = mask | (CMD_BITS << SPILMOSI) | (CMD_BITS << SPILMISO);
|
|
SPI1W0 = y0 >> 0;
|
|
SPI1CMD |= SPIBUSY;
|
|
while(SPI1CMD & SPIBUSY) {}
|
|
//DC_D; // Small delay
|
|
//SPI.write16(y);
|
|
//SPI1U1 = mask | (CMD_BITS << SPILMOSI) | (CMD_BITS << SPILMISO);
|
|
SPI1W0 = y0 << 8;
|
|
SPI1CMD |= SPIBUSY;
|
|
while(SPI1CMD & SPIBUSY) {}
|
|
//DC_D; // Small delay
|
|
//SPI.write16(y >> 8);
|
|
//SPI1U1 = mask | (CMD_BITS << SPILMOSI) | (CMD_BITS << SPILMISO);
|
|
SPI1W0 = y1 >> 0;
|
|
SPI1CMD |= SPIBUSY;
|
|
while(SPI1CMD & SPIBUSY) {}
|
|
//DC_D; // Small delay
|
|
//SPI.write16(y);
|
|
//SPI1U1 = mask | (CMD_BITS << SPILMOSI) | (CMD_BITS << SPILMISO);
|
|
SPI1W0 = y1 << 8;
|
|
SPI1CMD |= SPIBUSY;
|
|
while(SPI1CMD & SPIBUSY) {}
|
|
|
|
// write to RAM
|
|
DC_C;
|
|
|
|
SPI1W0 = TFT_RAMWR<<(CMD_BITS + 1 - 8);
|
|
SPI1CMD |= SPIBUSY;
|
|
while(SPI1CMD & SPIBUSY) {}
|
|
|
|
DC_D;
|
|
|
|
spi_end();
|
|
}
|
|
/*
|
|
inline void TFT_eSPI::setAddrWindow(int32_t x0, int32_t y0, int32_t x1, int32_t y1)
|
|
{
|
|
spi_begin();
|
|
|
|
addr_col = 0xFFFF;
|
|
addr_row = 0xFFFF;
|
|
|
|
// Column addr set
|
|
DC_C;
|
|
CS_L;
|
|
|
|
SPI.write16(TFT_CASET);
|
|
|
|
DC_D;
|
|
|
|
SPI.write16(x0 >> 8); // Not tested on ESP32 <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<
|
|
SPI.write16(x0);
|
|
|
|
SPI.write16(x1 >> 8);
|
|
SPI.write16(x1);
|
|
|
|
// Row addr set
|
|
DC_C;
|
|
|
|
SPI.write16(TFT_PASET);
|
|
|
|
DC_D;
|
|
|
|
SPI.write16(y0 >> 8); // Not tested on ESP32 <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<
|
|
SPI.write16(y0);
|
|
|
|
SPI.write16(y1 >> 8);
|
|
SPI.write16(y1);
|
|
|
|
// write to RAM
|
|
DC_C;
|
|
|
|
SPI.write16(TFT_RAMWR);
|
|
|
|
DC_D;
|
|
|
|
spi_end();
|
|
}
|
|
*/
|
|
#else
|
|
|
|
inline void TFT_eSPI::setAddrWindow(int32_t x0, int32_t y0, int32_t x1, int32_t y1)
|
|
{
|
|
spi_begin();
|
|
|
|
addr_col = 0xFFFF;
|
|
addr_row = 0xFFFF;
|
|
|
|
#if defined (ST7735_DRIVER) && (defined (ST7735_GREENTAB) || defined (ST7735_GREENTAB2) || defined (ST7735_GREENTAB3))
|
|
x0+=colstart;
|
|
x1+=colstart;
|
|
y0+=rowstart;
|
|
y1+=rowstart;
|
|
#endif
|
|
|
|
// Column addr set
|
|
DC_C;
|
|
CS_L;
|
|
|
|
SPI.write(TFT_CASET);
|
|
|
|
DC_D;
|
|
|
|
SPI.write16((x0 >> 8) | (x0 << 8));
|
|
|
|
SPI.write16((x1 >> 8) | (x1 << 8));
|
|
|
|
// Row addr set
|
|
DC_C;
|
|
|
|
SPI.write(TFT_PASET);
|
|
|
|
DC_D;
|
|
|
|
SPI.write16((y0 >> 8) | (y0 << 8));
|
|
|
|
SPI.write16((y1 >> 8) | (y1 << 8));
|
|
|
|
// write to RAM
|
|
DC_C;
|
|
|
|
SPI.write(TFT_RAMWR);
|
|
|
|
DC_D;
|
|
|
|
spi_end();
|
|
}
|
|
#endif // end RPI_ILI9486_DRIVER check
|
|
#endif // end ESP32 check
|
|
|
|
|
|
/***************************************************************************************
|
|
** Function name: readAddrWindow
|
|
** Description: define an area to read a stream of pixels
|
|
***************************************************************************************/
|
|
// Chip select stays low
|
|
#if defined (ESP8266) && !defined (RPI_WRITE_STROBE)
|
|
void TFT_eSPI::readAddrWindow(int32_t xs, int32_t ys, int32_t xe, int32_t ye)
|
|
{
|
|
//spi_begin();
|
|
|
|
addr_col = 0xFFFF;
|
|
addr_row = 0xFFFF;
|
|
|
|
#if defined (ST7735_DRIVER) && (defined (ST7735_GREENTAB) || defined (ST7735_GREENTAB2) || defined (ST7735_GREENTAB3))
|
|
xs+=colstart;
|
|
xe+=colstart;
|
|
ys+=rowstart;
|
|
ye+=rowstart;
|
|
#endif
|
|
|
|
// Column addr set
|
|
DC_C;
|
|
CS_L;
|
|
|
|
uint32_t mask = ~((SPIMMOSI << SPILMOSI) | (SPIMMISO << SPILMISO));
|
|
mask = SPI1U1 & mask;
|
|
|
|
SPI1U1 = mask | (CMD_BITS << SPILMOSI) | (CMD_BITS << SPILMISO);
|
|
|
|
SPI1W0 = TFT_CASET;
|
|
SPI1CMD |= SPIBUSY;
|
|
while(SPI1CMD & SPIBUSY) {}
|
|
|
|
DC_D;
|
|
|
|
SPI1U1 = mask | (31 << SPILMOSI) | (31 << SPILMISO);
|
|
// Load the two coords as a 32 bit value and shift in one go
|
|
SPI1W0 = (xs >> 8) | (uint16_t)(xs << 8) | ((uint8_t)(xe >> 8)<<16 | (xe << 24));
|
|
SPI1CMD |= SPIBUSY;
|
|
while(SPI1CMD & SPIBUSY) {}
|
|
|
|
// Row addr set
|
|
DC_C;
|
|
|
|
SPI1U1 = mask | (CMD_BITS << SPILMOSI) | (CMD_BITS << SPILMISO);
|
|
|
|
SPI1W0 = TFT_PASET;
|
|
SPI1CMD |= SPIBUSY;
|
|
while(SPI1CMD & SPIBUSY) {}
|
|
|
|
DC_D;
|
|
|
|
SPI1U1 = mask | (31 << SPILMOSI) | (31 << SPILMISO);
|
|
// Load the two coords as a 32 bit value and shift in one go
|
|
SPI1W0 = (ys >> 8) | (uint16_t)(ys << 8) | ((uint8_t)(ye >> 8)<<16 | (ye << 24));
|
|
SPI1CMD |= SPIBUSY;
|
|
while(SPI1CMD & SPIBUSY) {}
|
|
|
|
// read from RAM
|
|
DC_C;
|
|
|
|
SPI1U1 = mask | (CMD_BITS << SPILMOSI) | (CMD_BITS << SPILMISO);
|
|
SPI1W0 = TFT_RAMRD;
|
|
SPI1CMD |= SPIBUSY;
|
|
while(SPI1CMD & SPIBUSY) {}
|
|
|
|
DC_D;
|
|
//spi_end();
|
|
}
|
|
|
|
#else
|
|
|
|
void TFT_eSPI::readAddrWindow(int32_t x0, int32_t y0, int32_t x1, int32_t y1)
|
|
{
|
|
//spi_begin();
|
|
|
|
addr_col = 0xFFFF;
|
|
addr_row = 0xFFFF;
|
|
|
|
#if defined (ST7735_DRIVER) && (defined (ST7735_GREENTAB) || defined (ST7735_GREENTAB2) || defined (ST7735_GREENTAB3))
|
|
x0+=colstart;
|
|
x1+=colstart;
|
|
y0+=rowstart;
|
|
y1+=rowstart;
|
|
#endif
|
|
|
|
// Column addr set
|
|
DC_C;
|
|
CS_L;
|
|
|
|
SPI.write(TFT_CASET);
|
|
|
|
DC_D;
|
|
|
|
SPI.write16((x0 >> 8) | (x0 << 8));
|
|
|
|
SPI.write16((x1 >> 8) | (x1 << 8));
|
|
|
|
// Row addr set
|
|
DC_C;
|
|
|
|
SPI.write(TFT_PASET);
|
|
|
|
DC_D;
|
|
|
|
SPI.write16((y0 >> 8) | (y0 << 8));
|
|
|
|
SPI.write16((y1 >> 8) | (y1 << 8));
|
|
|
|
DC_C;
|
|
SPI.transfer(TFT_RAMRD); // Read CGRAM command
|
|
DC_D;
|
|
|
|
//spi_end();
|
|
}
|
|
|
|
#endif
|
|
|
|
/***************************************************************************************
|
|
** Function name: drawPixel
|
|
** Description: push a single pixel at an arbitrary position
|
|
***************************************************************************************/
|
|
#if defined (ESP8266) && !defined (RPI_WRITE_STROBE)
|
|
void TFT_eSPI::drawPixel(uint32_t x, uint32_t y, uint32_t color)
|
|
{
|
|
// Faster range checking, possible because x and y are unsigned
|
|
if ((x >= _width) || (y >= _height)) return;
|
|
|
|
#if defined (ST7735_DRIVER) && (defined (ST7735_GREENTAB) || defined (ST7735_GREENTAB2) || defined (ST7735_GREENTAB3))
|
|
x+=colstart;
|
|
y+=rowstart;
|
|
#endif
|
|
|
|
spi_begin();
|
|
|
|
CS_L;
|
|
|
|
uint32_t mask = ~((SPIMMOSI << SPILMOSI) | (SPIMMISO << SPILMISO));
|
|
mask = SPI1U1 & mask;
|
|
// No need to send x if it has not changed (speeds things up)
|
|
if (addr_col != x) {
|
|
|
|
DC_C;
|
|
|
|
SPI1U1 = mask | (CMD_BITS << SPILMOSI) | (CMD_BITS << SPILMISO);
|
|
SPI1W0 = TFT_CASET<<(CMD_BITS + 1 - 8);
|
|
SPI1CMD |= SPIBUSY;
|
|
while(SPI1CMD & SPIBUSY) {}
|
|
|
|
DC_D;
|
|
|
|
#if defined (RPI_ILI9486_DRIVER) // This is for the RPi display that needs 16 bits per byte
|
|
uint8_t cBin[] = { 0, (uint8_t) (x>>8), 0, (uint8_t) (x>>0)};
|
|
SPI.writePattern(&cBin[0], 4, 2);
|
|
#else
|
|
SPI1U1 = mask | (31 << SPILMOSI) | (31 << SPILMISO);
|
|
// Load the two coords as a 32 bit value and shift in one go
|
|
uint32_t xswap = (x >> 8) | (uint16_t)(x << 8);
|
|
SPI1W0 = xswap | (xswap << 16);
|
|
SPI1CMD |= SPIBUSY;
|
|
while(SPI1CMD & SPIBUSY) {}
|
|
#endif
|
|
|
|
addr_col = x;
|
|
}
|
|
|
|
// No need to send y if it has not changed (speeds things up)
|
|
if (addr_row != y) {
|
|
|
|
DC_C;
|
|
|
|
SPI1U1 = mask | (CMD_BITS << SPILMOSI) | (CMD_BITS << SPILMISO);
|
|
|
|
SPI1W0 = TFT_PASET<<(CMD_BITS + 1 - 8);
|
|
SPI1CMD |= SPIBUSY;
|
|
while(SPI1CMD & SPIBUSY) {}
|
|
|
|
DC_D;
|
|
|
|
#if defined (RPI_ILI9486_DRIVER) // This is for the RPi display that needs 16 bits per byte
|
|
uint8_t cBin[] = { 0, (uint8_t) (y>>8), 0, (uint8_t) (y>>0)};
|
|
SPI.writePattern(&cBin[0], 4, 2);
|
|
#else
|
|
SPI1U1 = mask | (31 << SPILMOSI) | (31 << SPILMISO);
|
|
// Load the two coords as a 32 bit value and shift in one go
|
|
uint32_t yswap = (y >> 8) | (uint16_t)(y << 8);
|
|
SPI1W0 = yswap | (yswap << 16);
|
|
SPI1CMD |= SPIBUSY;
|
|
while(SPI1CMD & SPIBUSY) {}
|
|
#endif
|
|
|
|
addr_row = y;
|
|
}
|
|
|
|
DC_C;
|
|
|
|
SPI1U1 = mask | (CMD_BITS << SPILMOSI) | (CMD_BITS << SPILMISO);
|
|
|
|
SPI1W0 = TFT_RAMWR<<(CMD_BITS + 1 - 8);
|
|
SPI1CMD |= SPIBUSY;
|
|
while(SPI1CMD & SPIBUSY) {}
|
|
|
|
DC_D;
|
|
|
|
SPI1U1 = mask | (15 << SPILMOSI) | (15 << SPILMISO);
|
|
|
|
SPI1W0 = (color >> 8) | (color << 8);
|
|
SPI1CMD |= SPIBUSY;
|
|
while(SPI1CMD & SPIBUSY) {}
|
|
|
|
CS_H;
|
|
|
|
spi_end();
|
|
}
|
|
|
|
#else
|
|
|
|
#if defined (RPI_ILI9486_DRIVER) // This is for the RPi display that needs 16 bits
|
|
|
|
void TFT_eSPI::drawPixel(uint32_t x, uint32_t y, uint32_t color)
|
|
{
|
|
// Faster range checking, possible because x and y are unsigned
|
|
if ((x >= _width) || (y >= _height)) return;
|
|
spi_begin();
|
|
|
|
CS_L;
|
|
uint32_t mask = ~((SPIMMOSI << SPILMOSI) | (SPIMMISO << SPILMISO));
|
|
mask = SPI1U1 & mask;
|
|
SPI1U1 = mask | (CMD_BITS << SPILMOSI) | (CMD_BITS << SPILMISO);
|
|
// No need to send x if it has not changed (speeds things up)
|
|
if (addr_col != x) {
|
|
DC_C;
|
|
|
|
//SPI.write16(TFT_CASET);
|
|
//SPI1U1 = mask | (CMD_BITS << SPILMOSI) | (CMD_BITS << SPILMISO);
|
|
SPI1W0 = TFT_CASET<<(CMD_BITS + 1 - 8);
|
|
SPI1CMD |= SPIBUSY;
|
|
while(SPI1CMD & SPIBUSY) {}
|
|
DC_D;
|
|
|
|
//SPI.write16(x >> 8); // Not tested on ESP32 <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<
|
|
//SPI1U1 = mask | (CMD_BITS << SPILMOSI) | (CMD_BITS << SPILMISO);
|
|
SPI1W0 = x >> 0;
|
|
SPI1CMD |= SPIBUSY;
|
|
while(SPI1CMD & SPIBUSY) {}
|
|
//DC_D; // Small delay
|
|
//SPI.write16(x);
|
|
//SPI1U1 = mask | (CMD_BITS << SPILMOSI) | (CMD_BITS << SPILMISO);
|
|
SPI1W0 = x << 8;
|
|
SPI1CMD |= SPIBUSY;
|
|
while(SPI1CMD & SPIBUSY) {}
|
|
//DC_D; // Small delay
|
|
//SPI.write16(x >> 8);
|
|
//SPI1U1 = mask | (CMD_BITS << SPILMOSI) | (CMD_BITS << SPILMISO);
|
|
SPI1W0 = x >> 0;
|
|
SPI1CMD |= SPIBUSY;
|
|
while(SPI1CMD & SPIBUSY) {}
|
|
//DC_D; // Small delay
|
|
//SPI.write16(x);
|
|
//SPI1U1 = mask | (CMD_BITS << SPILMOSI) | (CMD_BITS << SPILMISO);
|
|
SPI1W0 = x << 8;
|
|
SPI1CMD |= SPIBUSY;
|
|
while(SPI1CMD & SPIBUSY) {}
|
|
|
|
addr_col = x;
|
|
}
|
|
|
|
// No need to send y if it has not changed (speeds things up)
|
|
if (addr_row != y) {
|
|
DC_C;
|
|
|
|
//SPI.write16(TFT_PASET);
|
|
//SPI1U1 = mask | (CMD_BITS << SPILMOSI) | (CMD_BITS << SPILMISO);
|
|
SPI1W0 = TFT_PASET<<(CMD_BITS + 1 - 8);
|
|
SPI1CMD |= SPIBUSY;
|
|
while(SPI1CMD & SPIBUSY) {}
|
|
DC_D;
|
|
|
|
//SPI.write16(y >> 8); // Not tested on ESP32 <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<
|
|
//SPI1U1 = mask | (CMD_BITS << SPILMOSI) | (CMD_BITS << SPILMISO);
|
|
SPI1W0 = y >> 0;
|
|
SPI1CMD |= SPIBUSY;
|
|
while(SPI1CMD & SPIBUSY) {}
|
|
//DC_D; // Small delay
|
|
//SPI.write16(y);
|
|
//SPI1U1 = mask | (CMD_BITS << SPILMOSI) | (CMD_BITS << SPILMISO);
|
|
SPI1W0 = y << 8;
|
|
SPI1CMD |= SPIBUSY;
|
|
while(SPI1CMD & SPIBUSY) {}
|
|
//DC_D; // Small delay
|
|
//SPI.write16(y >> 8);
|
|
//SPI1U1 = mask | (CMD_BITS << SPILMOSI) | (CMD_BITS << SPILMISO);
|
|
SPI1W0 = y >> 0;
|
|
SPI1CMD |= SPIBUSY;
|
|
while(SPI1CMD & SPIBUSY) {}
|
|
//DC_D; // Small delay
|
|
//SPI.write16(y);
|
|
//SPI1U1 = mask | (CMD_BITS << SPILMOSI) | (CMD_BITS << SPILMISO);
|
|
SPI1W0 = y << 8;
|
|
SPI1CMD |= SPIBUSY;
|
|
while(SPI1CMD & SPIBUSY) {}
|
|
|
|
addr_row = y;
|
|
}
|
|
|
|
DC_C;
|
|
|
|
//SPI.write16(TFT_RAMWR);
|
|
//SPI1U1 = mask | (CMD_BITS << SPILMOSI) | (CMD_BITS << SPILMISO);
|
|
SPI1W0 = TFT_RAMWR<<(CMD_BITS + 1 - 8);
|
|
SPI1CMD |= SPIBUSY;
|
|
while(SPI1CMD & SPIBUSY) {}
|
|
|
|
DC_D;
|
|
|
|
//SPI.write16((color));// >> 8) | (color << 8));
|
|
//SPI1U1 = mask | (CMD_BITS << SPILMOSI) | (CMD_BITS << SPILMISO);
|
|
SPI1W0 = (color >> 8) | (color << 8);
|
|
SPI1CMD |= SPIBUSY;
|
|
while(SPI1CMD & SPIBUSY) {}
|
|
|
|
CS_H;
|
|
|
|
spi_end();
|
|
}
|
|
|
|
#else
|
|
|
|
void TFT_eSPI::drawPixel(uint32_t x, uint32_t y, uint32_t color)
|
|
{
|
|
// Faster range checking, possible because x and y are unsigned
|
|
if ((x >= _width) || (y >= _height)) return;
|
|
spi_begin();
|
|
|
|
#if defined (ST7735_DRIVER) && (defined (ST7735_GREENTAB) || defined (ST7735_GREENTAB2) || defined (ST7735_GREENTAB3))
|
|
x+=colstart;
|
|
y+=rowstart;
|
|
#endif
|
|
|
|
CS_L;
|
|
|
|
// No need to send x if it has not changed (speeds things up)
|
|
if (addr_col != x) {
|
|
|
|
DC_C;
|
|
|
|
SPI.write(TFT_CASET);
|
|
|
|
DC_D;
|
|
|
|
SPI.write16((x >> 8) | (x << 8));
|
|
|
|
// Send same x value again
|
|
SPI.write16((x >> 8) | (x << 8));
|
|
|
|
addr_col = x;
|
|
}
|
|
|
|
// No need to send y if it has not changed (speeds things up)
|
|
if (addr_row != y) {
|
|
|
|
DC_C;
|
|
|
|
SPI.write(TFT_PASET);
|
|
|
|
DC_D;
|
|
|
|
SPI.write16((y >> 8) | (y << 8));
|
|
|
|
// Send same y value again
|
|
SPI.write16((y >> 8) | (y << 8));
|
|
|
|
addr_row = y;
|
|
}
|
|
|
|
DC_C;
|
|
|
|
SPI.write(TFT_RAMWR);
|
|
|
|
DC_D;
|
|
|
|
SPI.write16((color >> 8) | (color << 8));
|
|
|
|
CS_H;
|
|
|
|
spi_end();
|
|
}
|
|
#endif
|
|
#endif
|
|
|
|
|
|
/***************************************************************************************
|
|
** Function name: pushColor
|
|
** Description: push a single pixel
|
|
***************************************************************************************/
|
|
void TFT_eSPI::pushColor(uint16_t color)
|
|
{
|
|
spi_begin();
|
|
|
|
CS_L;
|
|
|
|
SPI.write16(color);
|
|
|
|
CS_H;
|
|
|
|
spi_end();
|
|
}
|
|
|
|
|
|
/***************************************************************************************
|
|
** Function name: pushColor
|
|
** Description: push a single colour to "len" pixels
|
|
***************************************************************************************/
|
|
void TFT_eSPI::pushColor(uint16_t color, uint16_t len)
|
|
{
|
|
spi_begin();
|
|
|
|
CS_L;
|
|
|
|
uint8_t colorBin[] = { (uint8_t) (color >> 8), (uint8_t) color };
|
|
|
|
#ifdef RPI_WRITE_STROBE
|
|
if(len) SPI.writePattern(&colorBin[0], 2, 1); len--;
|
|
while(len--) {WR_L; WR_H;}
|
|
#else
|
|
while(len>32) { SPI.writePattern(&colorBin[0], 2, 32); len-=32;}
|
|
SPI.writePattern(&colorBin[0], 2, len);
|
|
#endif
|
|
|
|
CS_H;
|
|
|
|
spi_end();
|
|
}
|
|
|
|
|
|
/***************************************************************************************
|
|
** Function name: pushColors
|
|
** Description: push an aray of pixels for BMP image drawing
|
|
***************************************************************************************/
|
|
// Sends an array of 16-bit color values to the TFT; used
|
|
// externally by BMP examples. Assumes that setWindow() has
|
|
// previously been called to define the bounds. Max 255 pixels at
|
|
// a time (BMP examples read in small chunks due to limited RAM).
|
|
|
|
void TFT_eSPI::pushColors(uint16_t *data, uint8_t len)
|
|
{
|
|
spi_begin();
|
|
|
|
CS_L;
|
|
|
|
while (len--) SPI.write16(*(data++));
|
|
|
|
CS_H;
|
|
|
|
spi_end();
|
|
}
|
|
|
|
|
|
/***************************************************************************************
|
|
** Function name: pushColors
|
|
** Description: push an aray of pixels for 16 bit raw image drawing
|
|
***************************************************************************************/
|
|
// Assumed that setWindow() has previously been called
|
|
|
|
void TFT_eSPI::pushColors(uint8_t *data, uint32_t len)
|
|
{
|
|
spi_begin();
|
|
|
|
CS_L;
|
|
|
|
#if defined (RPI_WRITE_STROBE)
|
|
while ( len ) {SPI.writePattern(data, 2, 1); data += 2; len -= 2; }
|
|
#else
|
|
while ( len >=64 ) {SPI.writePattern(data, 64, 1); data += 64; len -= 64; }
|
|
if (len) SPI.writePattern(data, len, 1);
|
|
#endif
|
|
|
|
CS_H;
|
|
|
|
spi_end();
|
|
}
|
|
|
|
|
|
/***************************************************************************************
|
|
** Function name: drawLine
|
|
** Description: draw a line between 2 arbitrary points
|
|
***************************************************************************************/
|
|
// Bresenham's algorithm - thx wikipedia - speed enhanced by Bodmer to use
|
|
// an eficient FastH/V Line draw routine for line segments of 2 pixels or more
|
|
|
|
#if defined (ESP32) || defined (RPI_WRITE_STROBE)
|
|
|
|
void TFT_eSPI::drawLine(int32_t x0, int32_t y0, int32_t x1, int32_t y1, uint32_t color)
|
|
{
|
|
|
|
boolean steep = abs(y1 - y0) > abs(x1 - x0);
|
|
if (steep) {
|
|
swap(x0, y0);
|
|
swap(x1, y1);
|
|
}
|
|
|
|
if (x0 > x1) {
|
|
swap(x0, x1);
|
|
swap(y0, y1);
|
|
}
|
|
|
|
int32_t dx = x1 - x0, dy = abs(y1 - y0);;
|
|
|
|
int32_t err = dx >> 1, ystep = -1, xs = x0, dlen = 0;
|
|
|
|
if (y0 < y1) ystep = 1;
|
|
|
|
// Split into steep and not steep for FastH/V separation
|
|
if (steep) {
|
|
for (; x0 <= x1; x0++) {
|
|
dlen++;
|
|
err -= dy;
|
|
if (err < 0) {
|
|
err += dx;
|
|
if (dlen == 1) drawPixel(y0, xs, color);
|
|
else drawFastVLine(y0, xs, dlen, color);
|
|
dlen = 0; y0 += ystep; xs = x0 + 1;
|
|
}
|
|
}
|
|
if (dlen) drawFastVLine(y0, xs, dlen, color);
|
|
}
|
|
else
|
|
{
|
|
for (; x0 <= x1; x0++) {
|
|
dlen++;
|
|
err -= dy;
|
|
if (err < 0) {
|
|
err += dx;
|
|
if (dlen == 1) drawPixel(xs, y0, color);
|
|
else drawFastHLine(xs, y0, dlen, color);
|
|
dlen = 0; y0 += ystep; xs = x0 + 1;
|
|
}
|
|
}
|
|
if (dlen) drawFastHLine(xs, y0, dlen, color);
|
|
}
|
|
}
|
|
|
|
#else
|
|
|
|
// This is a weeny bit faster
|
|
void TFT_eSPI::drawLine(int32_t x0, int32_t y0, int32_t x1, int32_t y1, uint32_t color)
|
|
{
|
|
spi_begin();
|
|
|
|
boolean steep = abs(y1 - y0) > abs(x1 - x0);
|
|
|
|
if (steep) {
|
|
swap(x0, y0);
|
|
swap(x1, y1);
|
|
}
|
|
|
|
if (x0 > x1) {
|
|
swap(x0, x1);
|
|
swap(y0, y1);
|
|
}
|
|
|
|
if (x1 < 0) return;
|
|
|
|
int16_t dx, dy;
|
|
dx = x1 - x0;
|
|
dy = abs(y1 - y0);
|
|
|
|
int16_t err = dx / 2;
|
|
int8_t ystep = (y0 < y1) ? 1 : (-1);
|
|
|
|
uint32_t mask = ~((SPIMMOSI << SPILMOSI) | (SPIMMISO << SPILMISO));
|
|
mask = (SPI1U1 & mask) | (15 << SPILMOSI) | (15 << SPILMISO);
|
|
|
|
int16_t swapped_color = (color >> 8) | (color << 8);
|
|
|
|
if (steep) // y increments every iteration (y0 is x-axis, and x0 is y-axis)
|
|
{
|
|
if (x1 >= _height) x1 = _height - 1;
|
|
|
|
for (; x0 <= x1; x0++) {
|
|
if ((x0 >= 0) && (y0 >= 0) && (y0 < _width)) break;
|
|
err -= dy;
|
|
if (err < 0) {
|
|
err += dx;
|
|
y0 += ystep;
|
|
}
|
|
}
|
|
|
|
if (x0 > x1) return;
|
|
|
|
setAddrWindow(y0, x0, y0, _height);
|
|
SPI1U1 = mask;
|
|
for (; x0 <= x1; x0++) {
|
|
while(SPI1CMD & SPIBUSY) {}
|
|
SPI1W0 = swapped_color;
|
|
SPI1CMD |= SPIBUSY;
|
|
|
|
err -= dy;
|
|
if (err < 0) {
|
|
y0 += ystep;
|
|
if ((y0 < 0) || (y0 >= _width)) break;
|
|
err += dx;
|
|
while(SPI1CMD & SPIBUSY) {}
|
|
setAddrWindow(y0, x0+1, y0, _height);
|
|
SPI1U1 = mask;
|
|
}
|
|
}
|
|
}
|
|
else // x increments every iteration (x0 is x-axis, and y0 is y-axis)
|
|
{
|
|
if (x1 >= _width) x1 = _width - 1;
|
|
|
|
for (; x0 <= x1; x0++) {
|
|
if ((x0 >= 0) && (y0 >= 0) && (y0 < _height)) break;
|
|
err -= dy;
|
|
if (err < 0) {
|
|
err += dx;
|
|
y0 += ystep;
|
|
}
|
|
}
|
|
|
|
if (x0 > x1) return;
|
|
|
|
setAddrWindow(x0, y0, _width, y0);
|
|
SPI1U1 = mask;
|
|
|
|
for (; x0 <= x1; x0++) {
|
|
while(SPI1CMD & SPIBUSY) {}
|
|
SPI1W0 = swapped_color;
|
|
SPI1CMD |= SPIBUSY;
|
|
|
|
err -= dy;
|
|
if (err < 0) {
|
|
y0 += ystep;
|
|
if ((y0 < 0) || (y0 >= _height)) break;
|
|
err += dx;
|
|
while(SPI1CMD & SPIBUSY) {}
|
|
setAddrWindow(x0+1, y0, _width, y0);
|
|
SPI1U1 = mask;
|
|
}
|
|
}
|
|
}
|
|
|
|
while(SPI1CMD & SPIBUSY) {}
|
|
CS_H;
|
|
spi_end();
|
|
}
|
|
#endif
|
|
|
|
|
|
/***************************************************************************************
|
|
** Function name: drawFastVLine
|
|
** Description: draw a vertical line
|
|
***************************************************************************************/
|
|
#if defined (ESP8266) && !defined (RPI_WRITE_STROBE)
|
|
void TFT_eSPI::drawFastVLine(int32_t x, int32_t y, int32_t h, uint32_t color)
|
|
{
|
|
// Rudimentary clipping
|
|
if ((x >= _width) || (y >= _height) || (h < 1)) return;
|
|
if ((y + h - 1) >= _height) h = _height - y;
|
|
|
|
spi_begin();
|
|
|
|
setAddrWindow(x, y, x, y + h - 1);
|
|
|
|
uint8_t colorBin[] = { (uint8_t) (color >> 8), (uint8_t) color};
|
|
SPI.writePattern(&colorBin[0], 2, h);
|
|
|
|
CS_H;
|
|
|
|
spi_end();
|
|
}
|
|
#else
|
|
void TFT_eSPI::drawFastVLine(int32_t x, int32_t y, int32_t h, uint32_t color)
|
|
{
|
|
// Rudimentary clipping
|
|
if ((x >= _width) || (y >= _height) || (h < 1)) return;
|
|
if ((y + h - 1) >= _height) h = _height - y;
|
|
|
|
spi_begin();
|
|
|
|
setAddrWindow(x, y, x, y + h - 1);
|
|
|
|
#ifdef RPI_WRITE_STROBE
|
|
SPI1W0 = (color >> 8) | (color << 8);
|
|
SPI1CMD |= SPIBUSY;
|
|
while(SPI1CMD & SPIBUSY) {}
|
|
h--;
|
|
while(h--) {WR_L; WR_H;}
|
|
#else
|
|
while(h--) SPI.write16(color);
|
|
#endif
|
|
|
|
CS_H;
|
|
|
|
spi_end();
|
|
}
|
|
#endif
|
|
|
|
/***************************************************************************************
|
|
** Function name: drawFastHLine
|
|
** Description: draw a horizontal line
|
|
***************************************************************************************/
|
|
#if defined (ESP8266) && !defined (RPI_WRITE_STROBE)
|
|
void TFT_eSPI::drawFastHLine(int32_t x, int32_t y, int32_t w, uint32_t color)
|
|
{
|
|
// Rudimentary clipping
|
|
if ((x >= _width) || (y >= _height) || (w < 1)) return;
|
|
if ((x + w - 1) >= _width) w = _width - x;
|
|
|
|
spi_begin();
|
|
|
|
setAddrWindow(x, y, x + w - 1, y);
|
|
|
|
uint8_t colorBin[] = { (uint8_t) (color >> 8), (uint8_t) color};
|
|
SPI.writePattern(&colorBin[0], 2, w);
|
|
|
|
CS_H;
|
|
|
|
spi_end();
|
|
}
|
|
#else
|
|
void TFT_eSPI::drawFastHLine(int32_t x, int32_t y, int32_t w, uint32_t color)
|
|
{
|
|
// Rudimentary clipping
|
|
if ((x >= _width) || (y >= _height) || (w < 1)) return;
|
|
if ((x + w - 1) >= _width) w = _width - x;
|
|
|
|
spi_begin();
|
|
setAddrWindow(x, y, x + w - 1, y);
|
|
|
|
#ifdef RPI_WRITE_STROBE
|
|
SPI1W0 = (color >> 8) | (color << 8);
|
|
SPI1CMD |= SPIBUSY;
|
|
while(SPI1CMD & SPIBUSY) {}
|
|
w--;
|
|
while(w--) {WR_L; WR_H;}
|
|
#else
|
|
while(w--) SPI.write16(color);
|
|
#endif
|
|
|
|
CS_H;
|
|
|
|
spi_end();
|
|
}
|
|
#endif
|
|
|
|
/***************************************************************************************
|
|
** Function name: fillRect
|
|
** Description: draw a filled rectangle
|
|
***************************************************************************************/
|
|
#if defined (ESP8266) && !defined (RPI_WRITE_STROBE)
|
|
void TFT_eSPI::fillRect(int32_t x, int32_t y, int32_t w, int32_t h, uint32_t color)
|
|
{
|
|
// rudimentary clipping (drawChar w/big text requires this)
|
|
if ((x > _width) || (y > _height) || (w < 1) || (h < 1)) return;
|
|
if ((x + w - 1) > _width) w = _width - x;
|
|
if ((y + h - 1) > _height) h = _height - y;
|
|
|
|
spi_begin();
|
|
setAddrWindow(x, y, x + w - 1, y + h - 1);
|
|
|
|
uint8_t colorBin[] = { (uint8_t) (color >> 8), (uint8_t) color};
|
|
uint32_t n = (uint32_t)w * (uint32_t)h;
|
|
SPI.writePattern(&colorBin[0], 2, n);
|
|
|
|
CS_H;
|
|
|
|
spi_end();
|
|
}
|
|
#else
|
|
void TFT_eSPI::fillRect(int32_t x, int32_t y, int32_t w, int32_t h, uint32_t color)
|
|
{
|
|
// rudimentary clipping (drawChar w/big text requires this)
|
|
if ((x > _width) || (y > _height) || (w < 1) || (h < 1)) return;
|
|
if ((x + w - 1) > _width) w = _width - x;
|
|
if ((y + h - 1) > _height) h = _height - y;
|
|
|
|
spi_begin();
|
|
setAddrWindow(x, y, x + w - 1, y + h - 1);
|
|
|
|
uint32_t n = (uint32_t)w * (uint32_t)h;
|
|
|
|
#ifdef RPI_WRITE_STROBE
|
|
if(n) {SPI.write16(color); n--;}
|
|
while(n--) {WR_L; WR_H;}
|
|
#else
|
|
while(n--) SPI.write16(color);
|
|
#endif
|
|
|
|
CS_H;
|
|
|
|
spi_end();
|
|
}
|
|
#endif
|
|
|
|
/***************************************************************************************
|
|
** Function name: color565
|
|
** Description: convert three 8 bit RGB levels to a 16 bit colour value
|
|
***************************************************************************************/
|
|
uint16_t TFT_eSPI::color565(uint8_t r, uint8_t g, uint8_t b)
|
|
{
|
|
return ((r & 0xF8) << 8) | ((g & 0xFC) << 3) | (b >> 3);
|
|
}
|
|
|
|
|
|
/***************************************************************************************
|
|
** Function name: invertDisplay
|
|
** Description: invert the display colours i = 1 invert, i = 0 normal
|
|
***************************************************************************************/
|
|
void TFT_eSPI::invertDisplay(boolean i)
|
|
{
|
|
spi_begin();
|
|
// Send the command twice as otherwise it does not always work!
|
|
writecommand(i ? TFT_INVON : TFT_INVOFF);
|
|
writecommand(i ? TFT_INVON : TFT_INVOFF);
|
|
spi_end();
|
|
}
|
|
|
|
|
|
/***************************************************************************************
|
|
** Function name: write
|
|
** Description: draw characters piped through serial stream
|
|
***************************************************************************************/
|
|
size_t TFT_eSPI::write(uint8_t utf8)
|
|
{
|
|
if (utf8 == '\r') return 1;
|
|
|
|
uint8_t uniCode = utf8; // Work with a copy
|
|
if (utf8 == '\n') uniCode+=22; // Make it a valid space character to stop errors
|
|
|
|
uint16_t width = 0;
|
|
uint16_t height = 0;
|
|
|
|
//vvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvv DEBUG vvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvv
|
|
//Serial.print((uint8_t) uniCode); // Debug line sends all printed TFT text to serial port
|
|
//Serial.println(uniCode, HEX); // Debug line sends all printed TFT text to serial port
|
|
//delay(5); // Debug optional wait for serial port to flush through
|
|
//^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ DEBUG ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
//<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<
|
|
#ifdef LOAD_GFXFF
|
|
if(!gfxFont) {
|
|
#endif
|
|
//<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<
|
|
|
|
#ifdef LOAD_FONT2
|
|
if (textfont == 2)
|
|
{
|
|
// This is 20us faster than using the fontdata structure (0.443ms per character instead of 0.465ms)
|
|
width = pgm_read_byte(widtbl_f16 + uniCode-32);
|
|
height = chr_hgt_f16;
|
|
// Font 2 is rendered in whole byte widths so we must allow for this
|
|
width = (width + 6) / 8; // Width in whole bytes for font 2, should be + 7 but must allow for font width change
|
|
width = width * 8; // Width converted back to pixles
|
|
}
|
|
#ifdef LOAD_RLE
|
|
else
|
|
#endif
|
|
#endif
|
|
|
|
#ifdef LOAD_RLE
|
|
{
|
|
if ((textfont>2) && (textfont<9))
|
|
{
|
|
// Uses the fontinfo struct array to avoid lots of 'if' or 'switch' statements
|
|
// A tad slower than above but this is not significant and is more convenient for the RLE fonts
|
|
width = pgm_read_byte( pgm_read_dword( &(fontdata[textfont].widthtbl ) ) + uniCode-32 );
|
|
height= pgm_read_byte( &fontdata[textfont].height );
|
|
}
|
|
}
|
|
#endif
|
|
|
|
#ifdef LOAD_GLCD
|
|
if (textfont==1)
|
|
{
|
|
width = 6;
|
|
height = 8;
|
|
}
|
|
#else
|
|
if (textfont==1) return 0;
|
|
#endif
|
|
|
|
height = height * textsize;
|
|
|
|
if (utf8 == '\n') {
|
|
cursor_y += height;
|
|
cursor_x = 0;
|
|
}
|
|
else
|
|
{
|
|
if (textwrap && (cursor_x + width * textsize >= _width))
|
|
{
|
|
cursor_y += height;
|
|
cursor_x = 0;
|
|
}
|
|
cursor_x += drawChar(uniCode, cursor_x, cursor_y, textfont);
|
|
}
|
|
|
|
//<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<
|
|
#ifdef LOAD_GFXFF
|
|
} // Custom GFX font
|
|
else
|
|
{
|
|
|
|
if(utf8 == '\n') {
|
|
cursor_x = 0;
|
|
cursor_y += (int16_t)textsize *
|
|
(uint8_t)pgm_read_byte(&gfxFont->yAdvance);
|
|
} else if(uniCode != '\r') {
|
|
if (uniCode > (uint8_t)pgm_read_byte(&gfxFont->last)) uniCode = pgm_read_byte(&gfxFont->first);
|
|
|
|
if(uniCode >= pgm_read_byte(&gfxFont->first)) {
|
|
uint8_t c2 = uniCode - pgm_read_byte(&gfxFont->first);
|
|
GFXglyph *glyph = &(((GFXglyph *)pgm_read_dword(&gfxFont->glyph))[c2]);
|
|
uint8_t w = pgm_read_byte(&glyph->width),
|
|
h = pgm_read_byte(&glyph->height);
|
|
if((w > 0) && (h > 0)) { // Is there an associated bitmap?
|
|
int16_t xo = (int8_t)pgm_read_byte(&glyph->xOffset);
|
|
if(textwrap && ((cursor_x + textsize * (xo + w)) >= _width)) {
|
|
// Drawing character would go off right edge; wrap to new line
|
|
cursor_x = 0;
|
|
cursor_y += (int16_t)textsize *
|
|
(uint8_t)pgm_read_byte(&gfxFont->yAdvance);
|
|
}
|
|
drawChar(cursor_x, cursor_y, uniCode, textcolor, textbgcolor, textsize);
|
|
}
|
|
cursor_x += pgm_read_byte(&glyph->xAdvance) * (int16_t)textsize;
|
|
}
|
|
}
|
|
|
|
}
|
|
#endif // LOAD_GFXFF
|
|
//<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<
|
|
|
|
return 1;
|
|
}
|
|
|
|
|
|
/***************************************************************************************
|
|
** Function name: drawChar
|
|
** Description: draw a unicode onto the screen
|
|
***************************************************************************************/
|
|
int16_t TFT_eSPI::drawChar(unsigned int uniCode, int x, int y)
|
|
{
|
|
return drawChar(uniCode, x, y, textfont);
|
|
}
|
|
|
|
int16_t TFT_eSPI::drawChar(unsigned int uniCode, int x, int y, int font)
|
|
{
|
|
|
|
if (font==1)
|
|
{
|
|
#ifdef LOAD_GLCD
|
|
#ifndef LOAD_GFXFF
|
|
drawChar(x, y, uniCode, textcolor, textbgcolor, textsize);
|
|
return 6 * textsize;
|
|
#endif
|
|
#else
|
|
#ifndef LOAD_GFXFF
|
|
return 0;
|
|
#endif
|
|
#endif
|
|
|
|
#ifdef LOAD_GFXFF
|
|
drawChar(x, y, uniCode, textcolor, textbgcolor, textsize);
|
|
if(!gfxFont) { // 'Classic' built-in font
|
|
#ifdef LOAD_GLCD
|
|
return 6 * textsize;
|
|
#else
|
|
return 0;
|
|
#endif
|
|
}
|
|
else
|
|
{
|
|
if (uniCode > pgm_read_byte(&gfxFont->last)) uniCode = pgm_read_byte(&gfxFont->first);
|
|
|
|
if(uniCode >= pgm_read_byte(&gfxFont->first))
|
|
{
|
|
uint8_t c2 = uniCode - pgm_read_byte(&gfxFont->first);
|
|
GFXglyph *glyph = &(((GFXglyph *)pgm_read_dword(&gfxFont->glyph))[c2]);
|
|
return pgm_read_byte(&glyph->xAdvance) * textsize;
|
|
}
|
|
else
|
|
{
|
|
return 0;
|
|
}
|
|
}
|
|
#endif
|
|
}
|
|
|
|
int width = 0;
|
|
int height = 0;
|
|
uint32_t flash_address = 0;
|
|
uniCode -= 32;
|
|
|
|
#ifdef LOAD_FONT2
|
|
if (font == 2)
|
|
{
|
|
// This is faster than using the fontdata structure
|
|
flash_address = pgm_read_dword(&chrtbl_f16[uniCode]);
|
|
width = pgm_read_byte(widtbl_f16 + uniCode);
|
|
height = chr_hgt_f16;
|
|
}
|
|
#ifdef LOAD_RLE
|
|
else
|
|
#endif
|
|
#endif
|
|
|
|
#ifdef LOAD_RLE
|
|
{
|
|
if ((font>2) && (font<9))
|
|
{
|
|
// This is slower than above but is more convenient for the RLE fonts
|
|
flash_address = pgm_read_dword( pgm_read_dword( &(fontdata[font].chartbl ) ) + uniCode*sizeof(void *) );
|
|
width = pgm_read_byte( pgm_read_dword( &(fontdata[font].widthtbl ) ) + uniCode );
|
|
height= pgm_read_byte( &fontdata[font].height );
|
|
}
|
|
}
|
|
#endif
|
|
|
|
int w = width;
|
|
int pX = 0;
|
|
int pY = y;
|
|
byte line = 0;
|
|
|
|
#ifdef LOAD_FONT2 // chop out code if we do not need it
|
|
if (font == 2) {
|
|
w = w + 6; // Should be + 7 but we need to compensate for width increment
|
|
w = w / 8;
|
|
if (x + width * textsize >= (int16_t)_width) return width * textsize ;
|
|
|
|
if (textcolor == textbgcolor || textsize != 1) {
|
|
|
|
for (int i = 0; i < height; i++)
|
|
{
|
|
if (textcolor != textbgcolor) fillRect(x, pY, width * textsize, textsize, textbgcolor);
|
|
|
|
for (int k = 0; k < w; k++)
|
|
{
|
|
line = pgm_read_byte(flash_address + w * i + k);
|
|
if (line) {
|
|
if (textsize == 1) {
|
|
pX = x + k * 8;
|
|
if (line & 0x80) drawPixel(pX, pY, textcolor);
|
|
if (line & 0x40) drawPixel(pX + 1, pY, textcolor);
|
|
if (line & 0x20) drawPixel(pX + 2, pY, textcolor);
|
|
if (line & 0x10) drawPixel(pX + 3, pY, textcolor);
|
|
if (line & 0x08) drawPixel(pX + 4, pY, textcolor);
|
|
if (line & 0x04) drawPixel(pX + 5, pY, textcolor);
|
|
if (line & 0x02) drawPixel(pX + 6, pY, textcolor);
|
|
if (line & 0x01) drawPixel(pX + 7, pY, textcolor);
|
|
}
|
|
else {
|
|
pX = x + k * 8 * textsize;
|
|
if (line & 0x80) fillRect(pX, pY, textsize, textsize, textcolor);
|
|
if (line & 0x40) fillRect(pX + textsize, pY, textsize, textsize, textcolor);
|
|
if (line & 0x20) fillRect(pX + 2 * textsize, pY, textsize, textsize, textcolor);
|
|
if (line & 0x10) fillRect(pX + 3 * textsize, pY, textsize, textsize, textcolor);
|
|
if (line & 0x08) fillRect(pX + 4 * textsize, pY, textsize, textsize, textcolor);
|
|
if (line & 0x04) fillRect(pX + 5 * textsize, pY, textsize, textsize, textcolor);
|
|
if (line & 0x02) fillRect(pX + 6 * textsize, pY, textsize, textsize, textcolor);
|
|
if (line & 0x01) fillRect(pX + 7 * textsize, pY, textsize, textsize, textcolor);
|
|
}
|
|
}
|
|
}
|
|
pY += textsize;
|
|
}
|
|
}
|
|
else
|
|
// Faster drawing of characters and background using block write
|
|
{
|
|
spi_begin();
|
|
setAddrWindow(x, y, (x + w * 8) - 1, y + height - 1);
|
|
|
|
byte mask;
|
|
for (int i = 0; i < height; i++)
|
|
{
|
|
for (int k = 0; k < w; k++)
|
|
{
|
|
line = pgm_read_byte(flash_address + w * i + k);
|
|
pX = x + k * 8;
|
|
mask = 0x80;
|
|
while (mask) {
|
|
if (line & mask) {
|
|
SPI.write16(textcolor);
|
|
}
|
|
else {
|
|
SPI.write16(textbgcolor);
|
|
}
|
|
mask = mask >> 1;
|
|
}
|
|
}
|
|
pY += textsize;
|
|
}
|
|
|
|
CS_H;
|
|
spi_end();
|
|
}
|
|
}
|
|
|
|
#ifdef LOAD_RLE
|
|
else
|
|
#endif
|
|
#endif //FONT2
|
|
|
|
#ifdef LOAD_RLE //674 bytes of code
|
|
// Font is not 2 and hence is RLE encoded
|
|
{
|
|
spi_begin();
|
|
|
|
w *= height; // Now w is total number of pixels in the character
|
|
if ((textsize != 1) || (textcolor == textbgcolor)) {
|
|
if (textcolor != textbgcolor) fillRect(x, pY, width * textsize, textsize * height, textbgcolor);
|
|
int px = 0, py = pY; // To hold character block start and end column and row values
|
|
int pc = 0; // Pixel count
|
|
byte np = textsize * textsize; // Number of pixels in a drawn pixel
|
|
|
|
byte tnp = 0; // Temporary copy of np for while loop
|
|
byte ts = textsize - 1; // Temporary copy of textsize
|
|
// 16 bit pixel count so maximum font size is equivalent to 180x180 pixels in area
|
|
// w is total number of pixels to plot to fill character block
|
|
while (pc < w)
|
|
{
|
|
line = pgm_read_byte(flash_address);
|
|
flash_address++; // 20 bytes smaller by incrementing here
|
|
if (line & 0x80) {
|
|
line &= 0x7F;
|
|
line++;
|
|
if (ts) {
|
|
px = x + textsize * (pc % width); // Keep these px and py calculations outside the loop as they are slow
|
|
py = y + textsize * (pc / width);
|
|
}
|
|
else {
|
|
px = x + pc % width; // Keep these px and py calculations outside the loop as they are slow
|
|
py = y + pc / width;
|
|
}
|
|
while (line--) { // In this case the while(line--) is faster
|
|
pc++; // This is faster than putting pc+=line before while()?
|
|
setAddrWindow(px, py, px + ts, py + ts);
|
|
|
|
if (ts) {
|
|
tnp = np;
|
|
while (tnp--) {
|
|
SPI.write16(textcolor);
|
|
}
|
|
}
|
|
else {
|
|
SPI.write16(textcolor);
|
|
}
|
|
px += textsize;
|
|
|
|
if (px >= (x + width * textsize))
|
|
{
|
|
px = x;
|
|
py += textsize;
|
|
}
|
|
}
|
|
}
|
|
else {
|
|
line++;
|
|
pc += line;
|
|
}
|
|
}
|
|
|
|
CS_H;
|
|
spi_end();
|
|
}
|
|
else // Text colour != background && textsize = 1
|
|
// so use faster drawing of characters and background using block write
|
|
{
|
|
spi_begin();
|
|
setAddrWindow(x, y, x + width - 1, y + height - 1);
|
|
|
|
uint8_t textcolorBin[] = { (uint8_t) (textcolor >> 8), (uint8_t) textcolor };
|
|
uint8_t textbgcolorBin[] = { (uint8_t) (textbgcolor >> 8), (uint8_t) textbgcolor };
|
|
|
|
// Maximum font size is equivalent to 180x180 pixels in area
|
|
while (w > 0)
|
|
{
|
|
line = pgm_read_byte(flash_address++); // 8 bytes smaller when incrementing here
|
|
if (line & 0x80) {
|
|
line &= 0x7F;
|
|
line++; w -= line;
|
|
#ifdef RPI_WRITE_STROBE
|
|
SPI.writePattern(&textcolorBin[0], 2, 1); line--;
|
|
while(line--) {WR_L; WR_H;}
|
|
#else
|
|
while(line>32) { SPI.writePattern(&textcolorBin[0], 2, 32); line-=32;}
|
|
SPI.writePattern(&textcolorBin[0], 2, line);
|
|
#endif
|
|
}
|
|
else {
|
|
line++; w -= line;
|
|
#ifdef RPI_WRITE_STROBE
|
|
SPI.writePattern(&textbgcolorBin[0], 2, 1); line--;
|
|
while(line--) {WR_L; WR_H;}
|
|
#else
|
|
while(line>32) { SPI.writePattern(&textbgcolorBin[0], 2, 32); line-=32;}
|
|
SPI.writePattern(&textbgcolorBin[0], 2, line);
|
|
#endif
|
|
}
|
|
}
|
|
CS_H;
|
|
spi_end();
|
|
}
|
|
}
|
|
// End of RLE font rendering
|
|
#endif
|
|
return width * textsize; // x +
|
|
}
|
|
|
|
|
|
/***************************************************************************************
|
|
** Function name: drawString (with or without user defined font)
|
|
** Description : draw string with padding if it is defined
|
|
***************************************************************************************/
|
|
// Without font number, uses font set by setTextFont()
|
|
int16_t TFT_eSPI::drawString(const String& string, int poX, int poY)
|
|
{
|
|
int16_t len = string.length() + 2;
|
|
char buffer[len];
|
|
string.toCharArray(buffer, len);
|
|
return drawString(buffer, poX, poY, textfont);
|
|
}
|
|
// With font number
|
|
int16_t TFT_eSPI::drawString(const String& string, int poX, int poY, int font)
|
|
{
|
|
int16_t len = string.length() + 2;
|
|
char buffer[len];
|
|
string.toCharArray(buffer, len);
|
|
return drawString(buffer, poX, poY, font);
|
|
}
|
|
|
|
// Without font number, uses font set by setTextFont()
|
|
int16_t TFT_eSPI::drawString(const char *string, int poX, int poY)
|
|
{
|
|
return drawString(string, poX, poY, textfont);
|
|
}
|
|
// With font number
|
|
int16_t TFT_eSPI::drawString(const char *string, int poX, int poY, int font)
|
|
{
|
|
int16_t sumX = 0;
|
|
uint8_t padding = 1, baseline = 0;
|
|
uint16_t cwidth = textWidth(string, font); // Find the pixel width of the string in the font
|
|
uint16_t cheight = 0;
|
|
|
|
#ifdef LOAD_GFXFF
|
|
if (font == 1) {
|
|
if(gfxFont) {
|
|
cheight = glyph_ab * textsize;
|
|
poY += cheight; // Adjust for baseline datum of free fonts
|
|
baseline = cheight;
|
|
padding =101; // Different padding method used for Free Fonts
|
|
|
|
// We need to make an adjustment for the botom of the string (eg 'y' character)
|
|
if ((textdatum == BL_DATUM) || (textdatum == BC_DATUM) || (textdatum == BR_DATUM)) {
|
|
cheight += glyph_bb * textsize;
|
|
}
|
|
}
|
|
}
|
|
#endif
|
|
|
|
if (textdatum || padX)
|
|
{
|
|
|
|
// If it is not font 1 (GLCD or free font) get the basline and pixel height of the font
|
|
if (font!=1) {
|
|
baseline = pgm_read_byte( &fontdata[font].baseline ) * textsize;
|
|
cheight = fontHeight(font);
|
|
}
|
|
|
|
switch(textdatum) {
|
|
case TC_DATUM:
|
|
poX -= cwidth/2;
|
|
padding += 1;
|
|
break;
|
|
case TR_DATUM:
|
|
poX -= cwidth;
|
|
padding += 2;
|
|
break;
|
|
case ML_DATUM:
|
|
poY -= cheight/2;
|
|
//padding += 0;
|
|
break;
|
|
case MC_DATUM:
|
|
poX -= cwidth/2;
|
|
poY -= cheight/2;
|
|
padding += 1;
|
|
break;
|
|
case MR_DATUM:
|
|
poX -= cwidth;
|
|
poY -= cheight/2;
|
|
padding += 2;
|
|
break;
|
|
case BL_DATUM:
|
|
poY -= cheight;
|
|
//padding += 0;
|
|
break;
|
|
case BC_DATUM:
|
|
poX -= cwidth/2;
|
|
poY -= cheight;
|
|
padding += 1;
|
|
break;
|
|
case BR_DATUM:
|
|
poX -= cwidth;
|
|
poY -= cheight;
|
|
padding += 2;
|
|
break;
|
|
case L_BASELINE:
|
|
poY -= baseline;
|
|
//padding += 0;
|
|
break;
|
|
case C_BASELINE:
|
|
poX -= cwidth/2;
|
|
poY -= baseline;
|
|
//padding += 1;
|
|
break;
|
|
case R_BASELINE:
|
|
poX -= cwidth;
|
|
poY -= baseline;
|
|
padding += 2;
|
|
break;
|
|
}
|
|
// Check coordinates are OK, adjust if not
|
|
if (poX < 0) poX = 0;
|
|
if (poX+cwidth>_width) poX = _width - cwidth;
|
|
if (poY < 0) poY = 0;
|
|
if (poY+cheight-baseline>_height) poY = _height - cheight;
|
|
}
|
|
|
|
#ifdef LOAD_GFXFF
|
|
int8_t xo = 0;
|
|
if ((font == 1) && (gfxFont) && (textcolor!=textbgcolor))
|
|
{
|
|
cheight = (glyph_ab + glyph_bb) * textsize;
|
|
// Get the offset for the first character only to allow for negative offsets
|
|
uint8_t c2 = *string - pgm_read_byte(&gfxFont->first);
|
|
GFXglyph *glyph = &(((GFXglyph *)pgm_read_dword(&gfxFont->glyph))[c2]);
|
|
xo = pgm_read_byte(&glyph->xOffset) * textsize;
|
|
// Adjust for negative xOffset, also see line 2708 below
|
|
//if (xo < 0)
|
|
cwidth -= xo;
|
|
// Add 1 pixel of padding all round
|
|
cheight +=2;
|
|
fillRect(poX+xo-1, poY - 1 - glyph_ab * textsize, cwidth+2, cheight, textbgcolor);
|
|
padding -=100;
|
|
}
|
|
#endif
|
|
|
|
while (*string) sumX += drawChar(*(string++), poX+sumX, poY, font);
|
|
|
|
//vvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvv DEBUG vvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvv
|
|
// Switch on debugging for the padding areas
|
|
//#define PADDING_DEBUG
|
|
|
|
#ifndef PADDING_DEBUG
|
|
//^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ DEBUG ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
if((padX>cwidth) && (textcolor!=textbgcolor))
|
|
{
|
|
int16_t padXc = poX+cwidth+xo;
|
|
#ifdef LOAD_GFXFF
|
|
if ((font == 1) && (gfxFont))
|
|
{
|
|
poX +=xo; // Adjust for negative offset start character
|
|
poY -= 1 + glyph_ab * textsize;
|
|
}
|
|
#endif
|
|
switch(padding) {
|
|
case 1:
|
|
fillRect(padXc,poY,padX-cwidth,cheight, textbgcolor);
|
|
break;
|
|
case 2:
|
|
fillRect(padXc,poY,(padX-cwidth)>>1,cheight, textbgcolor);
|
|
padXc = (padX-cwidth)>>1;
|
|
if (padXc>poX) padXc = poX;
|
|
fillRect(poX - padXc,poY,(padX-cwidth)>>1,cheight, textbgcolor);
|
|
break;
|
|
case 3:
|
|
if (padXc>padX) padXc = padX;
|
|
fillRect(poX + cwidth - padXc,poY,padXc-cwidth,cheight, textbgcolor);
|
|
break;
|
|
}
|
|
}
|
|
|
|
|
|
#else
|
|
|
|
//vvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvv DEBUG vvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvv
|
|
// This is debug code to show text (green box) and blanked (white box) areas
|
|
// It shows that the padding areas are being correctly sized and positioned
|
|
|
|
if((padX>sumX) && (textcolor!=textbgcolor))
|
|
{
|
|
int16_t padXc = poX+sumX; // Maximum left side padding
|
|
#ifdef LOAD_GFXFF
|
|
if ((font == 1) && (gfxFont)) poY -= glyph_ab;
|
|
#endif
|
|
drawRect(poX,poY,sumX,cheight, TFT_GREEN);
|
|
switch(padding) {
|
|
case 1:
|
|
drawRect(padXc,poY,padX-sumX,cheight, TFT_WHITE);
|
|
break;
|
|
case 2:
|
|
drawRect(padXc,poY,(padX-sumX)>>1, cheight, TFT_WHITE);
|
|
padXc = (padX-sumX)>>1;
|
|
if (padXc>poX) padXc = poX;
|
|
drawRect(poX - padXc,poY,(padX-sumX)>>1,cheight, TFT_WHITE);
|
|
break;
|
|
case 3:
|
|
if (padXc>padX) padXc = padX;
|
|
drawRect(poX + sumX - padXc,poY,padXc-sumX,cheight, TFT_WHITE);
|
|
break;
|
|
}
|
|
}
|
|
#endif
|
|
//^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ DEBUG ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
|
|
return sumX;
|
|
}
|
|
|
|
|
|
/***************************************************************************************
|
|
** Function name: drawCentreString (deprecated, use setTextDatum())
|
|
** Descriptions: draw string centred on dX
|
|
***************************************************************************************/
|
|
int16_t TFT_eSPI::drawCentreString(const String& string, int dX, int poY, int font)
|
|
{
|
|
int16_t len = string.length() + 2;
|
|
char buffer[len];
|
|
string.toCharArray(buffer, len);
|
|
return drawCentreString(buffer, dX, poY, font);
|
|
}
|
|
|
|
int16_t TFT_eSPI::drawCentreString(const char *string, int dX, int poY, int font)
|
|
{
|
|
byte tempdatum = textdatum;
|
|
int sumX = 0;
|
|
textdatum = TC_DATUM;
|
|
sumX = drawString(string, dX, poY, font);
|
|
textdatum = tempdatum;
|
|
return sumX;
|
|
}
|
|
|
|
|
|
/***************************************************************************************
|
|
** Function name: drawRightString (deprecated, use setTextDatum())
|
|
** Descriptions: draw string right justified to dX
|
|
***************************************************************************************/
|
|
int16_t TFT_eSPI::drawRightString(const String& string, int dX, int poY, int font)
|
|
{
|
|
int16_t len = string.length() + 2;
|
|
char buffer[len];
|
|
string.toCharArray(buffer, len);
|
|
return drawRightString(buffer, dX, poY, font);
|
|
}
|
|
|
|
int16_t TFT_eSPI::drawRightString(const char *string, int dX, int poY, int font)
|
|
{
|
|
byte tempdatum = textdatum;
|
|
int16_t sumX = 0;
|
|
textdatum = TR_DATUM;
|
|
sumX = drawString(string, dX, poY, font);
|
|
textdatum = tempdatum;
|
|
return sumX;
|
|
}
|
|
|
|
|
|
/***************************************************************************************
|
|
** Function name: drawNumber
|
|
** Description: draw a long integer
|
|
***************************************************************************************/
|
|
int16_t TFT_eSPI::drawNumber(long long_num, int poX, int poY)
|
|
{
|
|
char str[12];
|
|
ltoa(long_num, str, 10);
|
|
return drawString(str, poX, poY, textfont);
|
|
}
|
|
|
|
int16_t TFT_eSPI::drawNumber(long long_num, int poX, int poY, int font)
|
|
{
|
|
char str[12];
|
|
ltoa(long_num, str, 10);
|
|
return drawString(str, poX, poY, font);
|
|
}
|
|
|
|
|
|
/***************************************************************************************
|
|
** Function name: drawFloat
|
|
** Descriptions: drawFloat, prints 7 non zero digits maximum
|
|
***************************************************************************************/
|
|
// Assemble and print a string, this permits alignment relative to a datum
|
|
// looks complicated but much more compact and actually faster than using print class
|
|
int16_t TFT_eSPI::drawFloat(float floatNumber, int dp, int poX, int poY)
|
|
{
|
|
return drawFloat(floatNumber, dp, poX, poY, textfont);
|
|
}
|
|
|
|
int16_t TFT_eSPI::drawFloat(float floatNumber, int dp, int poX, int poY, int font)
|
|
{
|
|
char str[14]; // Array to contain decimal string
|
|
uint8_t ptr = 0; // Initialise pointer for array
|
|
int8_t digits = 1; // Count the digits to avoid array overflow
|
|
float rounding = 0.5; // Round up down delta
|
|
|
|
if (dp > 7) dp = 7; // Limit the size of decimal portion
|
|
|
|
// Adjust the rounding value
|
|
for (uint8_t i = 0; i < dp; ++i) rounding /= 10.0;
|
|
|
|
if (floatNumber < -rounding) // add sign, avoid adding - sign to 0.0!
|
|
{
|
|
str[ptr++] = '-'; // Negative number
|
|
str[ptr] = 0; // Put a null in the array as a precaution
|
|
digits = 0; // Set digits to 0 to compensate so pointer value can be used later
|
|
floatNumber = -floatNumber; // Make positive
|
|
}
|
|
|
|
floatNumber += rounding; // Round up or down
|
|
|
|
// For error put ... in string and return (all TFT_eSPI library fonts contain . character)
|
|
if (floatNumber >= 2147483647) {
|
|
strcpy(str, "...");
|
|
return drawString(str, poX, poY, font);
|
|
}
|
|
// No chance of overflow from here on
|
|
|
|
// Get integer part
|
|
unsigned long temp = (unsigned long)floatNumber;
|
|
|
|
// Put integer part into array
|
|
ltoa(temp, str + ptr, 10);
|
|
|
|
// Find out where the null is to get the digit count loaded
|
|
while ((uint8_t)str[ptr] != 0) ptr++; // Move the pointer along
|
|
digits += ptr; // Count the digits
|
|
|
|
str[ptr++] = '.'; // Add decimal point
|
|
str[ptr] = '0'; // Add a dummy zero
|
|
str[ptr + 1] = 0; // Add a null but don't increment pointer so it can be overwritten
|
|
|
|
// Get the decimal portion
|
|
floatNumber = floatNumber - temp;
|
|
|
|
// Get decimal digits one by one and put in array
|
|
// Limit digit count so we don't get a false sense of resolution
|
|
uint8_t i = 0;
|
|
while ((i < dp) && (digits < 9)) // while (i < dp) for no limit but array size must be increased
|
|
{
|
|
i++;
|
|
floatNumber *= 10; // for the next decimal
|
|
temp = floatNumber; // get the decimal
|
|
ltoa(temp, str + ptr, 10);
|
|
ptr++; digits++; // Increment pointer and digits count
|
|
floatNumber -= temp; // Remove that digit
|
|
}
|
|
|
|
// Finally we can plot the string and return pixel length
|
|
return drawString(str, poX, poY, font);
|
|
}
|
|
|
|
|
|
/***************************************************************************************
|
|
** Function name: setFreeFont
|
|
** Descriptions: Sets the GFX free font to use
|
|
***************************************************************************************/
|
|
|
|
#ifdef LOAD_GFXFF
|
|
|
|
void TFT_eSPI::setFreeFont(const GFXfont *f) {
|
|
//textdatum = L_BASELINE;
|
|
textfont = 1;
|
|
gfxFont = (GFXfont *)f;
|
|
|
|
glyph_ab = 0;
|
|
glyph_bb = 0;
|
|
uint8_t numChars = pgm_read_byte(&gfxFont->last) - pgm_read_byte(&gfxFont->first);
|
|
|
|
// Find the biggest above and below baseline offsets
|
|
for (uint8_t c = 0; c < numChars; c++)
|
|
{
|
|
GFXglyph *glyph1 = &(((GFXglyph *)pgm_read_dword(&gfxFont->glyph))[c]);
|
|
int8_t ab = -pgm_read_byte(&glyph1->yOffset);
|
|
if (ab > glyph_ab) glyph_ab = ab;
|
|
int8_t bb = pgm_read_byte(&glyph1->height) - ab;
|
|
if (bb > glyph_bb) glyph_bb = bb;
|
|
}
|
|
//Serial.print("new glyph_ab=");Serial.println(glyph_ab);
|
|
//Serial.print("new glyph_bb=");Serial.println(glyph_bb);
|
|
// Save above baseline (for say H) and below baseline (for y tail) heights
|
|
//uint16_t uniCode = FF_HEIGHT - pgm_read_byte(&gfxFont->first);
|
|
//GFXglyph *glyph1 = &(((GFXglyph *)pgm_read_dword(&gfxFont->glyph))[uniCode]);
|
|
//glyph_ab = -pgm_read_byte(&glyph1->yOffset);
|
|
|
|
//uniCode = FF_BOTTOM - pgm_read_byte(&gfxFont->first);
|
|
//GFXglyph *glyph2 = &(((GFXglyph *)pgm_read_dword(&gfxFont->glyph))[uniCode]);
|
|
//glyph_bb = pgm_read_byte(&glyph2->height) + (int8_t)pgm_read_byte(&glyph2->yOffset);
|
|
//Serial.print("glyph_ab=");Serial.println(glyph_ab);
|
|
//Serial.print("glyph_bb=");Serial.println(glyph_bb);
|
|
}
|
|
|
|
|
|
/***************************************************************************************
|
|
** Function name: setTextFont
|
|
** Description: Set the font for the print stream
|
|
***************************************************************************************/
|
|
void TFT_eSPI::setTextFont(uint8_t f)
|
|
{
|
|
textfont = (f > 0) ? f : 1; // Don't allow font 0
|
|
gfxFont = NULL;
|
|
}
|
|
|
|
#else
|
|
|
|
|
|
/***************************************************************************************
|
|
** Function name: setFreeFont
|
|
** Descriptions: Sets the GFX free font to use
|
|
***************************************************************************************/
|
|
|
|
// Alternative to setTextFont() so we don't need two different named functions
|
|
void TFT_eSPI::setFreeFont(uint8_t font) {
|
|
setTextFont(font);
|
|
}
|
|
|
|
|
|
/***************************************************************************************
|
|
** Function name: setTextFont
|
|
** Description: Set the font for the print stream
|
|
***************************************************************************************/
|
|
void TFT_eSPI::setTextFont(uint8_t f)
|
|
{
|
|
textfont = (f > 0) ? f : 1; // Don't allow font 0
|
|
}
|
|
|
|
#endif
|
|
|
|
|
|
/***************************************************
|
|
The majority of code in this file is "FunWare", the only condition of use of
|
|
those portions is that users have fun! Most of the effort has been spent on
|
|
the creation and incorporation of the proportional Run Length Encoded fonts
|
|
that can be rendered over an SPI bus at high speeds.
|
|
|
|
A significant number of new features have been added to the original source
|
|
libraries. Functions names have been retained where practical to allow old
|
|
Adafruit_GFX TFT screen compatible sketches to be easily adapted.
|
|
|
|
A significant level of effort has been made to optimise the library for speed
|
|
so that graphics intensive sketches can run at an acceptable speed over the
|
|
SPI bus. SPI bus speeds up to 80MHz can be used with some driver chips. At
|
|
this clock rate screen and block clears can achieve an average bit rate of
|
|
75Mbps.
|
|
|
|
The functions incldued are comaptible with the JPEGDecoder library here:
|
|
https://github.com/Bodmer/JPEGDecoder
|
|
|
|
This allows allows the ESP8266 (or ESP32) sketches to retrieve images from the
|
|
internet, store them in SPIFFS and render the images to the screen at an
|
|
acceptable speed. So some really cool IoT sketches are possible without tedious
|
|
manual loading of images.
|
|
|
|
Other portions of code are protected by the licenses as noted below.
|
|
|
|
The library would not have been created without the initial inspiration from
|
|
Adafruit_ILI9341 and Adafruit_GFX libraries.
|
|
|
|
|
|
If any other conditions of use have been missed then please raise this as an
|
|
issue on GitHub:
|
|
|
|
|
|
/***************************************************
|
|
The Adafruit_ILI9341 library has been used as a starting point
|
|
for this library.
|
|
|
|
ORIGINAL LIBRARY HEADER
|
|
|
|
This is our library for the Adafruit ILI9341 Breakout and Shield
|
|
----> http://www.adafruit.com/products/1651
|
|
|
|
Check out the links above for our tutorials and wiring diagrams
|
|
These displays use SPI to communicate, 4 or 5 pins are required to
|
|
interface (RST is optional)
|
|
Adafruit invests time and resources providing this open source code,
|
|
please support Adafruit and open-source hardware by purchasing
|
|
products from Adafruit!
|
|
|
|
Written by Limor Fried/Ladyada for Adafruit Industries.
|
|
MIT license, all text above must be included in any redistribution
|
|
|
|
****************************************************/
|
|
|
|
|
|
/****************************************************
|
|
|
|
Some member funtions have been imported from the Adafruit_GFX
|
|
library. The license associated with these is reproduced below.
|
|
|
|
ORIGINAL LIBRARY HEADER from Adafruit_GFX.cpp
|
|
|
|
This is the core graphics library for all our displays, providing a common
|
|
set of graphics primitives (points, lines, circles, etc.). It needs to be
|
|
paired with a hardware-specific library for each display device we carry
|
|
(to handle the lower-level functions).
|
|
|
|
Adafruit invests time and resources providing this open source code, please
|
|
support Adafruit & open-source hardware by purchasing products from Adafruit!
|
|
|
|
Copyright (c) 2013 Adafruit Industries. All rights reserved.
|
|
|
|
Redistribution and use in source and binary forms, with or without
|
|
modification, are permitted provided that the following conditions are met:
|
|
|
|
- Redistributions of source code must retain the above copyright notice,
|
|
this list of conditions and the following disclaimer.
|
|
- Redistributions in binary form must reproduce the above copyright notice,
|
|
this list of conditions and the following disclaimer in the documentation
|
|
and/or other materials provided with the distribution.
|
|
|
|
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
|
|
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
|
|
LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
|
|
CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
|
|
SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
|
|
INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
|
|
CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
|
|
ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
|
POSSIBILITY OF SUCH DAMAGE.
|
|
|
|
****************************************************/
|
|
|
|
|
|
/****************************************************
|
|
|
|
In compliance with the licence.txt file for the Adafruit_GFX library the
|
|
following is included.
|
|
|
|
Software License Agreement (BSD License)
|
|
|
|
Copyright (c) 2012 Adafruit Industries. All rights reserved.
|
|
|
|
Redistribution and use in source and binary forms, with or without
|
|
modification, are permitted provided that the following conditions are met:
|
|
|
|
- Redistributions of source code must retain the above copyright notice,
|
|
this list of conditions and the following disclaimer.
|
|
- Redistributions in binary form must reproduce the above copyright notice,
|
|
this list of conditions and the following disclaimer in the documentation
|
|
and/or other materials provided with the distribution.
|
|
|
|
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
|
|
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
|
|
LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
|
|
CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
|
|
SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
|
|
INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
|
|
CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
|
|
ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
|
POSSIBILITY OF SUCH DAMAGE.
|
|
|
|
*****************************************************/
|