TFT

Macros
#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)
#define	HEX(h)   (RGB(((h)>>16),((h)>>8),(h)))
#define	TRANSPARENT   ((uint16_t)0x80C2)

Functions
bool	tft_init ()
void	tft_clear (uint16_t color)
void	tft_draw_line (uint16_t x1, uint16_t y1, uint16_t x2, uint16_t y2, uint16_t color)
void	tft_draw_pixel (uint16_t x, uint16_t y, uint16_t color)
void	tft_draw_rectangle (uint16_t x1, uint16_t y1, uint16_t x2, uint16_t y2, uint16_t color)
void	tft_fill_rectangle (uint16_t x1, uint16_t y1, uint16_t x2, uint16_t y2, uint16_t color)
void	tft_draw_bitmap_unscaled (uint16_t x, uint16_t y, uint16_t width, uint16_t height, const uint16_t *dat)
bool	tft_draw_bitmap_file_unscaled (uint16_t x, uint16_t y, const char *filename)
void	tft_draw_circle (uint16_t x, uint16_t y, uint16_t r, uint16_t color)
uint8_t	tft_num_fonts ()
uint8_t	tft_font_height (uint8_t fontnum)
uint8_t	tft_font_width (uint8_t fontnum)
void	tft_print_line (uint16_t x, uint16_t y, uint16_t color, uint16_t bgcolor, uint8_t font, const char *text)
void	tft_print_formatted (uint16_t x, uint16_t y, uint16_t color, uint16_t bgcolor, uint8_t font, const char *format,...)

Detailed Description

The TFT Modul provides access to the display

Macro Definition Documentation

#define BLACK   RGB(0,0,0)

Definition at line 54 of file tft.h.

#define BLUE   RGB(0,0,255)

Definition at line 52 of file tft.h.

#define GREEN   RGB(0,255,0)

Definition at line 51 of file tft.h.

#define HEX

(

h

)

(RGB(((h)>>16),((h)>>8),(h)))

Creates a 16bit color from a 24bit hex rgb color code

Returns

Definition at line 60 of file tft.h.

#define RED   RGB(255,0,0)

Definition at line 50 of file tft.h.

#define RGB	(		r,
			g,
			b
	)		((((r) & 0xF8) << 8) | (((g) & 0xFC) << 3) | (((b) & 0xF8) >> 3))

Creates a 16bit color from 8bit * 3 colors (r,g,b)

Returns

Definition at line 48 of file tft.h.

#define TRANSPARENT   ((uint16_t)0x80C2)

Transparent color

Returns

Definition at line 66 of file tft.h.

#define WHITE   0xF7BE

Definition at line 53 of file tft.h.

Function Documentation

void tft_clear

(

uint16_t

color

)

Clears the entire display with the given color. Overpaints everything which was there before.

Parameters

color

The 16-bit color to clear the display with.

Definition at line 45 of file tft.c.

{
    ll_tft_clear(color);
}

Here is the call graph for this function:

Here is the caller graph for this function:

bool tft_draw_bitmap_file_unscaled	(	uint16_t	x,
		uint16_t	y,
		const char *	filename
	)

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

Parameters

x	The x-coordinate of the top-left corner to draw the bitmap at
y	The y-coordinate of the top-left corner to draw the bitmap at
filename	The absolute path to the .bmp file

Returns

true on success

Definition at line 123 of file tft.c.

{
    //This method reads a .bmp file from the filesystem and tries to draw it.
    //Note: The bmp implementation is not complete, it has some limitations and it makes assumptions. See doxygen comment for this method.
    //Source Copied and adapted from: http://stackoverflow.com/a/17040962/2606757

    FILE_HANDLE* file = filesystem_file_open(filename); //try to open the file

    if (file == NULL) { //file opening failed
        return false;
    }

    unsigned char info[54];

    if (filesystem_file_read(file, info, 54) != F_OK) { //try to read the 54 byte header
        filesystem_file_close(file);
        return false; //reading the header failed
    }

    // extract image height and width from header
    uint32_t width = *(uint32_t*)&info[18]; //width in pixel
    uint32_t height = *(uint32_t*)&info[22]; //height in pixel
    uint16_t depth = *(uint16_t*)&info[28]; //bit's per pixel (color depth)
    depth /= 8; //we want the number of bytes per pixel

    filesystem_file_seek(file, *(uint32_t*)&info[10]); //seek to the place where img data begins

    uint32_t row_padded = (width * depth + 3) & (~3); //row size must be aligned to 4 bytes

    unsigned char data [row_padded]; //allocate space for one row (incl. padding)

    for (int i = 0; i < height; i++) { //for each row
        filesystem_file_read(file, data, row_padded); //read row into buffer

        for (int j = 0; j < width * depth; j += depth) { //for each pixel
            unsigned char a, r, g, b;

            if (depth == 4) { //a,r,g,b 8bit each
                a = data[j];
                r = data[j + 1];
                g = data[j + 2];
                b = data[j + 3];
            } else if (depth == 3) { // b,g,r, 8bit each
                a = 255;
                r = data[j + 2];
                g = data[j + 1];
                b = data[j];
            }

            if (a != 0) {
                //bmp's are stored "bottom-up", so we start drawing at the bottom
                tft_draw_pixel(x + j / depth, y + height - 1 - i, RGB(r, g, b));
            }
        }
    }

    filesystem_file_close(file);

    return true;

}

Here is the call graph for this function:

Here is the caller graph for this function:

void tft_draw_bitmap_unscaled	(	uint16_t	x,
		uint16_t	y,
		uint16_t	width,
		uint16_t	height,
		const uint16_t *	dat
	)

Draws a bitmap onto the display without scaling/cropping. The bitmap must be provided as an array of 16-bit colors

Parameters

x	The x-coordinate of the top-left corner to draw the bitmap at
y	The y-coordinate of the top-left corner to draw the bitmap at
width	The width of the bitmap in pixels
height	The height of the bitmap in pixels
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.

Definition at line 72 of file tft.c.

{
    ll_tft_draw_bitmap_unscaled(x, y, width, height, dat);
}

Here is the call graph for this function:

Here is the caller graph for this function:

void tft_draw_circle	(	uint16_t	x,
		uint16_t	y,
		uint16_t	r,
		uint16_t	color
	)

Draws the outline of a circle onto the display

Parameters

x	The x-Coordinate of the center point
y	The y-Coordinate of the center point
r	The Radius in Pixels
color	The 16-Bit color to draw the circle with

Definition at line 77 of file tft.c.

{
    ll_tft_draw_circle(x, y, r, color);
}

Here is the call graph for this function:

Here is the caller graph for this function:

void tft_draw_line	(	uint16_t	x1,
		uint16_t	y1,
		uint16_t	x2,
		uint16_t	y2,
		uint16_t	color
	)

Draws a line onto the display. The pixels specified by start/end point are inclusive!

Parameters

x1	The x-Coordinate of the start-point
y1	The y-Coordinate of the start-point
x2	The x-Coordinate of the end-point
y2	The y-Coordinate of the end-point
color	The 16-bit color to draw the line with

Definition at line 50 of file tft.c.

{
    ll_tft_draw_line(x1, y1, x2, y2, color);
}

Here is the call graph for this function:

Here is the caller graph for this function:

void tft_draw_pixel	(	uint16_t	x,
		uint16_t	y,
		uint16_t	color
	)

Draws a pixel onto the display.

Parameters

x	The x-Coordinate of the pixel
y	The y-Coordinate of the pixel
color	The 16-bit color to draw the pixel with

Definition at line 56 of file tft.c.

{
    ll_tft_draw_pixel(x, y, color);
}

Here is the call graph for this function:

Here is the caller graph for this function:

void tft_draw_rectangle	(	uint16_t	x1,
		uint16_t	y1,
		uint16_t	x2,
		uint16_t	y2,
		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.

Parameters

x1	The x-Coordinate of the start-point
y1	The y-Coordinate of the start-point
x2	The x-Coordinate of the end-point
y2	The y-Coordinate of the end-point
color	The 16-bit color to draw the pixel with

Definition at line 61 of file tft.c.

{
    //could be implemented with 4 lines instead of introducing a ll func
    ll_tft_draw_rectangle(x1, y1, x2, y2, color);
}

Here is the call graph for this function:

Here is the caller graph for this function:

void tft_fill_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

Parameters

x1	The x-Coordinate of the start-point
y1	The y-Coordinate of the start-point
x2	The x-Coordinate of the end-point
y2	The y-Coordinate of the end-point
color	The 16-bit color to draw the pixel with

Definition at line 67 of file tft.c.

{
    ll_tft_fill_rectangle(x1, y1, x2, y2, color);
}

Here is the call graph for this function:

Here is the caller graph for this function:

uint8_t tft_font_height

(

uint8_t

fontnum

)

Get the height of a font

Parameters

fontnum

The number of the font, from 0 .. (num_fonts -1)

Returns

The height in pixel

Definition at line 87 of file tft.c.

{
    return ll_tft_font_height(fontnum);
}

Here is the call graph for this function:

Here is the caller graph for this function:

uint8_t tft_font_width

(

uint8_t

fontnum

)

Get the width of a font

Parameters

fontnum

The number of the font, from 0 .. (num_fonts -1)

Returns

The width in pixel

Definition at line 92 of file tft.c.

{
    return ll_tft_font_width(fontnum);
}

Here is the call graph for this function:

Here is the caller graph for this function:

bool tft_init

(

)

Initializes the display. Call this method before using any tft_* functions

Returns

true on success

Definition at line 39 of file tft.c.

{
    return ll_tft_init();

}

Here is the call graph for this function:

Here is the caller graph for this function:

uint8_t tft_num_fonts

(

)

Queries the number of available fonts

Returns

Definition at line 82 of file tft.c.

{
    return ll_tft_num_fonts();
}

Here is the call graph for this function:

void tft_print_formatted	(	uint16_t	x,
		uint16_t	y,
		uint16_t	color,
		uint16_t	bgcolor,
		uint8_t	font,
		const char *	format,
			...
	)

Prints a formatted text (like printf) onto the display

Parameters

x	The x-Coordinate of the Top-Left corner where the text should be drawn
y	The y-Coordinate of the Top-Left corner where the text should be drawn
color	The 16-bit foreground color of the text
bgcolor	The 16-bit background color of the text. You may pass TRANSPARENT as Color
font	The Fontnum to use for drawing
format	The format string (like printf)
...	The arguments to format (like printf)

Definition at line 111 of file tft.c.

{
    static char buffer[128]; //buffer to save the formatted text into

    //Since we have variable arguments, we need to forward them. We have to use vsprintf instead of sprintf for that.
    va_list args;
    va_start(args, format);  //start the varg-list
    vsprintf(buffer, format, args); //let vsprintf render the formatted string
    tft_print_line(x, y, color, bgcolor, font, buffer); //print the string as normal text
    va_end(args); //end the varg-list
}

Here is the call graph for this function:

Here is the caller graph for this function:

void tft_print_line	(	uint16_t	x,
		uint16_t	y,
		uint16_t	color,
		uint16_t	bgcolor,
		uint8_t	font,
		const char *	text
	)

Prints a unformatted/preformatted string onto the display

Parameters

x	The x-Coordinate of the Top-Left corner where the text should be drawn
y	The y-Coordinate of the Top-Left corner where the text should be drawn
color	The 16-bit foreground color of the text
bgcolor	The 16-bit background color of the text. You may pass TRANSPARENT as Color
font	The Fontnum to use for drawing
text	The text to draw

Definition at line 98 of file tft.c.

{
    if (font >= ll_tft_num_fonts()) {
        return;    //invalid font index
    }

    for (int i = 0; i < strlen(text); i++) { //for each char in the line
        ll_tft_draw_char(x, y, color, bgcolor, font, text[i]); //draw the char
        x += ll_tft_font_width(font);   //and increase the x position
    }
}

Here is the call graph for this function:

Here is the caller graph for this function: