microBuilder.eu

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

Sets a single pixel at the specified x,y location using the supplied RGB565 color.

#include "drivers/lcd/tft/drawing.h"
...
// Draw a white pixel at X:20, Y:50
drawPixel(20, 50, COLOR_WHITE);

void drawFill(uint16_t color)

Fills the entire LCD screen with the specified RGB565 Color

#include "drivers/lcd/tft/drawing.h"
...
drawFill(COLOR_WHITE);

void drawLine ( uint16_t x0, uint16_t y0, uint16_t x1, uint16_t y1, uint16_t color )

Draws a line between two locations on the LCD screen. (Note: If the line is a straight horizontal or vertical line, this function will automatically use an optimised drawing method in the specific LCD driver.)

#include "drivers/lcd/tft/drawing.h"
...
// Draw a green line from 10, 1 to 96, 118
drawLine(10, 1, 96, 118, COLOR_GREEN);

void drawLineDotted ( uint16_t x0, uint16_t y0, uint16_t x1, uint16_t y1, uint16_t empty, uint16_t solid, uint16_t color )

Draws a line with a fixed pattern of empty and solid pixels.

#include "drivers/lcd/tft/drawing.h"
...
  // Background
  drawFill(COLOR_WHITE);
  // Solid line
  drawLine(10, 10, 230, 10, COLOR_BLACK);
  // 1x1 pattern
  drawLineDotted(10, 15, 230, 15, 1, 1, COLOR_BLACK);
  // 2x2 pattern
  drawLineDotted(10, 20, 230, 20, 2, 2, COLOR_BLACK);
  // 3x3 pattern
  drawLineDotted(10, 25, 230, 25, 3, 3, COLOR_BLACK);
  // 3x5 pattern
  drawLineDotted(10, 30, 230, 30, 3, 5, COLOR_BLACK);
  // 5x10 pattern
  drawLineDotted(10, 35, 230, 35, 5, 10, COLOR_BLACK);

Note: This function was added in v0.92 of the LPC1343 Code Base.

void drawCircle (uint16_t xCenter, uint16_t yCenter, uint16_t radius, uint16_t color)

Draws a circle with the specified radius using the supplied x and y co-ordinates as the center point.

#include "drivers/lcd/tft/drawing.h"
...
// Draw a white circle with a 25 pixel radius centered on X:50, Y:50
drawCircle(50, 50, 25, COLOR_WHITE);

void drawCircleFilled (uint16_t xCenter, uint16_t yCenter, uint16_t radius, uint16_t color)

Identical to drawCircle, but also fills the interioir of the circle

#include "drivers/lcd/tft/drawing.h"
...
// Draw a solid white circle with a 25 pixel radius centered on X:50, Y:50
drawCircleFilled(50, 50, 25, COLOR_WHITE);

void drawArrow(uint16_t x, uint16_t y, uint16_t size, drawDirection_t direction, uint16_t color)

Draws a rectangular 'arrow' points in the specified direction (useful for scrollbars, selection menus, etc.). Note that the arrow will be drawn starting at the 1-pixel 'tip' and will expand outward from this point until the specified size is reached. You may need to adjust the starting 'y' position to place UP and DOWN arrows side by side.

The direction of the arrow is specified with one of the following values (enum located in drawing.h):

DRAW_DIRECTION_LEFT
DRAW_DIRECTION_RIGHT
DRAW_DIRECTION_UP
DRAW_DIRECTION_DOWN

#include "drivers/lcd/tft/drawing.h"
...
// Draw left and right arrows
drawArrow(105, 65, 7, DRAW_DIRECTION_LEFT, TEXTCOLORACTIVE);
drawArrow(220, 65, 7, DRAW_DIRECTION_RIGHT, TEXTCOLORACTIVE);

NOTE: This function was added in v0.92 of the LPC1343 Code Base.

void drawRectangle ( uint16_t x0, uint16_t y0, uint16_t x1, uint16_t y1, uint16_t color)

Draws a rectangle using the specified co-ordinates

#include "drivers/lcd/tft/drawing.h"
...
// Draw a white rectangle from 10, 10 to 100, 35
drawRectangle(10, 10, 100, 35, COLOR_WHITE);

void drawRectangleFilled ( uint16_t x0, uint16_t y0, uint16_t x1, uint16_t y1, uint16_t color)

Draws a filled rectangle using the specified co-ordinates

#include "drivers/lcd/tft/drawing.h"
...
// Draw a solid blue rectangle from 10, 10 to 100, 35
drawRectangleFilled(10, 10, 100, 25, COLOR_BLUE);

void drawRectangleRounded ( uint16_t x0, uint16_t y0, uint16_t x1, uint16_t y1, uint16_t color, uint16_t radius, drawRoundedCorners_t corners )

Draws a filled rectangle with rounded corners using the specified radius and location.

The following values can be used to indicate which corners should be 'rounded' (enum defined in drawing.h):

DRAW_ROUNDEDCORNERS_NONE
DRAW_ROUNDEDCORNERS_ALL
DRAW_ROUNDEDCORNERS_TOP
DRAW_ROUNDEDCORNERS_BOTTOM
DRAW_ROUNDEDCORNERS_LEFT
DRAW_ROUNDEDCORNERS_RIGHT

#include "drivers/lcd/tft/drawing.h"
...
// Draw a rectangle with all four corners rounded using a
// 10-pixel radius, solid blue fill, from 10,10 to 200,80
drawRectangleRounded(10, 10, 200, 80, COLOR_BLUE, 10, DRAW_ROUNDEDCORNERS_ALL);

NOTE: This function was added in v0.92 of the LPC1343 Code Base.

void drawTriangle(uint16_t x0, uint16_t y0, uint16_t x1, uint16_t y1, uint16_t x2, uint16_t y2, uint16_t color)

Draws the outline of a triangle using the three supplied vertices.

#include "drivers/lcd/tft/drawing.h"
...
drawTriangle ( 100, 10, 20, 120, 230, 290, COLOR_WHITE);

NOTE: This function was added in v0.93 of the LPC1343 Code Base.

void drawTriangleFilled(uint16_t x0, uint16_t y0, uint16_t x1, uint16_t y1, uint16_t x2, uint16_t y2, uint16_t color)

Draws a filled triangle using the three supplied vertices.

#include "drivers/lcd/tft/drawing.h"
...
drawTriangleFilled ( 100, 10, 20, 120, 230, 290, COLOR_WHITE);
// Draw black circles at each point of the triangle
drawCircleFilled(100, 10, 2, COLOR_BLACK);
drawCircleFilled(20, 120, 2, COLOR_BLACK);
drawCircleFilled(230, 290, 2, COLOR_BLACK);

NOTE: This function was added in v0.93 of the LPC1343 Code Base.

uint16_t drawRGB24toRGB565(uint8_t r, uint8_t g, uint8_t b)

Converts an RGB24 color (8 bits red, 8 bits green and 8 bits blue) to it's RGB565 equivalent (5 bits red, 6 bits green, 5 bits blue).

#include "drivers/lcd/tft/drawing.h"
...
uint16_t gray = drawRGB24toRGB565(0x33, 0x33, 0x33)

uint16_t drawGetStringWidth(const FONT_INFO *fontInfo, char *str)

Calculates the width in pixels of the text when it will be rendered

#include "drivers/lcd/tft/drawing.h"
#include "drivers/lcd/tft/fonts/dejavusans9.h"
...
drawGetStringWidth(&dejaVuSans9ptFontInfo, "Text in DejaVu Sans 9");

void drawProgressBar ( uint16_t x, uint16_t y, uint16_t width, uint16_t height, uint16_t barBorderColor, uint16_t barFillColor, uint8_t progress )

Draw a progress bar on the LCD to indicate a percentage between 0 and 100

#include "drivers/lcd/tft/drawing.h"
...
// Draw a 100 pixel wide and 20 pixel high progress bar starting at X: 10 and Y: 200.
// Outer border color is black, and the inner progress bar is blue
// Progress set to 90%
drawProgressBar(10, 200, 100, 20, COLOR_BLACK, COLOR_BLUE, 90);

void drawButton(uint16_t x, uint16_t y, uint16_t width, uint16_t height, const FONT_INFO *fontInfo, uint16_t fontHeight, char* text, bool pressed)

Draws a button on the display with a small text inlay.

#include "drivers/lcd/tft/drawing.h"
#include "drivers/lcd/tft/fonts/verasans9.h"
...
// Draw two buttons using DejaVu Sans 9
drawButton(20, 20, 200, 35, &dejaVuSans9ptFontInfo, 7, "System Settings", FALSE);
drawButton(20, 65, 200, 35, &dejaVuSans9ptFontInfo, 7, "Refresh", FALSE);

void drawIcon16(uint16_t x, uint16_t y, uint16_t color, uint16_t icon[])

Renders a 16x16 pixel monochrome icon from the supplied uint16_t array. Some common icons can be found in "/drivers/lcd/icons16.h".

The include icons (seen in the image to the right) are converted from Gentleface Free Wireframe Toolbar Icons library. Please visit their website for license terms and details (Creative Commons Attribution-NonCommercial license).

Note: This function was added in v0.92 of the LPC1343 Code Base.

#include "drivers/lcd/tft/drawing.h"  
#include "drivers/lcd/icons16.h"
...
// Renders the info icon, which has two seperate parts ... the exterior
// and a seperate interior mask if you want to fill the contents with a
// different color
drawIcon16(132, 202, COLOR_BLUE, icons16_info);
drawIcon16(132, 202, COLOR_WHITE, icons16_info_interior);

bmp_error_t drawBitmapImage(uint16_t x, uint16_t y, char *filename)

Renders a bitmap image on the screen starting at the specified X,Y location

#include "drivers/lcd/tft/drawing.h"
...
// Render "/image.bmp" (in the root folder) starting at pixel 0, 0
bmp_error_t error = drawBitmapImage(0, 0, "/image.bmp");

if (error)
{
  switch (error)
  {
    case BMP_ERROR_SDINITFAIL:
      break;
    case BMP_ERROR_FILENOTFOUND:
      break;
    case BMP_ERROR_NOTABITMAP:
      // First two bytes of image not 'BM'
      break;
    case BMP_ERROR_INVALIDBITDEPTH:
      // Image is not 24-bits
      break;
    case BMP_ERROR_COMPRESSEDDATA:
      // Image contains compressed data
      break;
    case BMP_ERROR_INVALIDDIMENSIONS:
      // Width or Height is > LCD size
      break;
    case BMP_ERROR_PREMATUREEOF:
      // EOF unexpectedly reached in pixel data
      break;
  }
}

char* alphaShowDialogue(void)

Renders a full-screen text input dialogue that can be 'shifted' to display letters in both upper and lower case, numbers, and speciality characters. The dialogue will remain visible until the user selects the 'OK' button, at which point the text entered will be returned as a char array.

The layout will automatically itself depending on the screen orientation, and if necessary the button layout can easily be reorganised by modifying an array of pre-defined button values. See the source code for more details.

Note: This function is not part of drawing.c, and is defined in a seperate source file at "~/drivers/lcd/tft/dialogues/alphanumeric.c". It's described here for convenience sake since it will likely be used at the same time as the other drawing routines described above.

#include "drivers/lcd/tft/drawing.h"
#include "drivers/lcd/tft/fonts/dejavusans9.h"
#include "drivers/lcd/tft/touchscreen.h"
#include "drivers/lcd/tft/dialogues/alphanumeric.h"
...
// Show the text input dialogue
char* results = alphaShowDialogue();
// Start blinky
drawFill(COLOR_WHITE);
drawString(10, 10, COLOR_BLACK, &dejaVuSans9ptFontInfo, "You Entered:");
drawString(10, 30, COLOR_BLACK, &dejaVuSans9ptFontInfo, results);