198 lines
7.4 KiB
C
198 lines
7.4 KiB
C
/**************************************************************************************************************************************
|
|
* Project: discoverpixy
|
|
* Website: https://github.com/t-moe/discoverpixy
|
|
* Authors: Aaron Schmocker, Timo Lang
|
|
* Institution: BFH Bern University of Applied Sciences
|
|
* File: common/tft/tft.h
|
|
*
|
|
* Version History:
|
|
* Date Autor Email SHA Changes
|
|
* 2015-04-03 timolang@gmail.com 51089aa Refactored Project Structure for use with emulator
|
|
* 2015-04-03 timolang@gmail.com 1f2af9f Added more tft functions to common and emulator. Fixed eventloop.
|
|
* 2015-04-03 timolang@gmail.com 1aa9194 Fixed Drawing of rects in Emulator. Got frames from pixy to emulator. Slooooow.
|
|
* 2015-04-27 aaron@duckpond.ch aed90ef Drawcircle added (emulator)
|
|
* 2015-04-27 timolang@gmail.com e249fb2 Added font support
|
|
* 2015-04-30 timolang@gmail.com 76ea9d8 Added num up down support.
|
|
* 2015-05-04 aaron@duckpond.ch c224d40 Changed display init
|
|
* 2015-05-10 timolang@gmail.com 21edc56 Added doxyfile (doxygen) for the common folder. Started with doxygen comments for app and tft module.
|
|
* 2015-05-11 timolang@gmail.com a175a2f Added doxygen docu for touch module
|
|
* 2015-05-11 timolang@gmail.com 08d9fe0 More work on doxygen module structure
|
|
* 2015-05-12 timolang@gmail.com 1402598 Added doxygen stuff for button module and some minor changes to touch, screen_main and tft module.
|
|
* 2015-05-15 timolang@gmail.com 9a16865 Added doxgen comments to filesyste, checkbox, numupdown and screen module. And some minor changes to the other modules.
|
|
* 2015-05-15 timolang@gmail.com b08a897 Added tft method to draw a bmp from filesystem. Added another font to emulator.
|
|
*
|
|
**************************************************************************************************************************************/
|
|
|
|
#ifndef TFT_H
|
|
#define TFT_H
|
|
|
|
#include<stdbool.h>
|
|
#include<stdint.h>
|
|
|
|
/**
|
|
* @defgroup tft TFT
|
|
* The TFT Modul provides access to the display
|
|
*/
|
|
|
|
|
|
/**
|
|
* @addtogroup tft
|
|
*/
|
|
/*@{*/
|
|
|
|
|
|
/**
|
|
* Creates a 16bit color from 8bit * 3 colors (r,g,b)
|
|
* @return
|
|
*/
|
|
#define RGB(r,g,b) ((((r) & 0xF8) << 8) | (((g) & 0xFC) << 3) | (((b) & 0xF8) >> 3))
|
|
|
|
#define RED RGB(255,0,0)
|
|
#define GREEN RGB(0,255,0)
|
|
#define BLUE RGB(0,0,255)
|
|
#define WHITE 0xF7BE
|
|
#define BLACK RGB(0,0,0)
|
|
|
|
/**
|
|
* Creates a 16bit color from a 24bit hex rgb color code
|
|
* @return
|
|
*/
|
|
#define HEX(h) (RGB(((h)>>16),((h)>>8),(h)))
|
|
|
|
/**
|
|
* Transparent color
|
|
* @return
|
|
*/
|
|
#define TRANSPARENT ((uint16_t)0x80C2)
|
|
|
|
/**
|
|
* Initializes the display.
|
|
* Call this method before using any tft_* functions
|
|
* @return true on success
|
|
*/
|
|
bool tft_init();
|
|
|
|
/**
|
|
* Clears the entire display with the given color. Overpaints everything which was there before.
|
|
* @param color The 16-bit color to clear the display with.
|
|
*/
|
|
void tft_clear(uint16_t color);
|
|
|
|
/**
|
|
* Draws a line onto the display. The pixels specified by start/end point are inclusive!
|
|
* @param x1 The x-Coordinate of the start-point
|
|
* @param y1 The y-Coordinate of the start-point
|
|
* @param x2 The x-Coordinate of the end-point
|
|
* @param y2 The y-Coordinate of the end-point
|
|
* @param color The 16-bit color to draw the line with
|
|
*/
|
|
void tft_draw_line(uint16_t x1, uint16_t y1, uint16_t x2, uint16_t y2, uint16_t color);
|
|
|
|
/**
|
|
* Draws a pixel onto the display.
|
|
* @param x The x-Coordinate of the pixel
|
|
* @param y The y-Coordinate of the pixel
|
|
* @param color The 16-bit color to draw the pixel with
|
|
*/
|
|
void tft_draw_pixel(uint16_t x, uint16_t y, uint16_t color);
|
|
|
|
/**
|
|
* Draws the outline of a rectangle onto the display.
|
|
* The outline is one pixel wide and goes through the specified start and endpoint.
|
|
* @param x1 The x-Coordinate of the start-point
|
|
* @param y1 The y-Coordinate of the start-point
|
|
* @param x2 The x-Coordinate of the end-point
|
|
* @param y2 The y-Coordinate of the end-point
|
|
* @param color The 16-bit color to draw the pixel with
|
|
*/
|
|
void tft_draw_rectangle(uint16_t x1, uint16_t y1, uint16_t x2, uint16_t y2, uint16_t color);
|
|
|
|
/**
|
|
* Draws a filled rectangle onto the display. The start,end points are inclusive
|
|
* @param x1 The x-Coordinate of the start-point
|
|
* @param y1 The y-Coordinate of the start-point
|
|
* @param x2 The x-Coordinate of the end-point
|
|
* @param y2 The y-Coordinate of the end-point
|
|
* @param color The 16-bit color to draw the pixel with
|
|
*/
|
|
void tft_fill_rectangle(uint16_t x1, uint16_t y1, uint16_t x2, uint16_t y2, uint16_t color);
|
|
|
|
/**
|
|
* Draws a bitmap onto the display without scaling/cropping.
|
|
* The bitmap must be provided as an array of 16-bit colors
|
|
* @param x The x-coordinate of the top-left corner to draw the bitmap at
|
|
* @param y The y-coordinate of the top-left corner to draw the bitmap at
|
|
* @param width The width of the bitmap in pixels
|
|
* @param height The height of the bitmap in pixels
|
|
* @param dat A pointer to a uint16_t array containing the colors for each pixel. Starting in the topleft and going from left to right, line by line.
|
|
*/
|
|
void tft_draw_bitmap_unscaled(uint16_t x, uint16_t y, uint16_t width, uint16_t height, const uint16_t* dat);
|
|
|
|
|
|
/**
|
|
* Draws a bitmap from the filesystem onto the display without scaling/cropping
|
|
* The bitmap must be saved in the windows bitmap format (.bmp) without compression and with 24 (b,g,r) or 32 (a,r,g,b) bits per pixel
|
|
* @param x The x-coordinate of the top-left corner to draw the bitmap at
|
|
* @param y The y-coordinate of the top-left corner to draw the bitmap at
|
|
* @param filename The absolute path to the .bmp file
|
|
* @return true on success
|
|
*/
|
|
bool tft_draw_bitmap_file_unscaled(uint16_t x, uint16_t y, const char* filename);
|
|
|
|
|
|
/**
|
|
* Draws the outline of a circle onto the display
|
|
* @param x The x-Coordinate of the center point
|
|
* @param y The y-Coordinate of the center point
|
|
* @param r The Radius in Pixels
|
|
* @param color The 16-Bit color to draw the circle with
|
|
*/
|
|
void tft_draw_circle(uint16_t x, uint16_t y, uint16_t r, uint16_t color);
|
|
|
|
/**
|
|
* Queries the number of available fonts
|
|
* @return
|
|
*/
|
|
uint8_t tft_num_fonts();
|
|
|
|
/**
|
|
* Get the height of a font
|
|
* @param fontnum The number of the font, from 0 .. (num_fonts -1)
|
|
* @return The height in pixel
|
|
*/
|
|
uint8_t tft_font_height(uint8_t fontnum);
|
|
|
|
/**
|
|
* Get the width of a font
|
|
* @param fontnum The number of the font, from 0 .. (num_fonts -1)
|
|
* @return The width in pixel
|
|
*/
|
|
uint8_t tft_font_width(uint8_t fontnum);
|
|
|
|
/**
|
|
* Prints a unformatted/preformatted string onto the display
|
|
* @param x The x-Coordinate of the Top-Left corner where the text should be drawn
|
|
* @param y The y-Coordinate of the Top-Left corner where the text should be drawn
|
|
* @param color The 16-bit foreground color of the text
|
|
* @param bgcolor The 16-bit background color of the text. You may pass TRANSPARENT as Color
|
|
* @param font The Fontnum to use for drawing
|
|
* @param text The text to draw
|
|
*/
|
|
void tft_print_line(uint16_t x, uint16_t y, uint16_t color, uint16_t bgcolor, uint8_t font, const char* text);
|
|
|
|
/**
|
|
* Prints a formatted text (like printf) onto the display
|
|
* @param x The x-Coordinate of the Top-Left corner where the text should be drawn
|
|
* @param y The y-Coordinate of the Top-Left corner where the text should be drawn
|
|
* @param color The 16-bit foreground color of the text
|
|
* @param bgcolor The 16-bit background color of the text. You may pass TRANSPARENT as Color
|
|
* @param font The Fontnum to use for drawing
|
|
* @param format The format string (like printf)
|
|
* @param ... The arguments to format (like printf)
|
|
*/
|
|
void tft_print_formatted(uint16_t x, uint16_t y, uint16_t color, uint16_t bgcolor, uint8_t font, const char* format, ...);
|
|
|
|
/*@}*/
|
|
|
|
#endif /* TFT_H */
|