This is hardware specific configuration that configures the graphical service for use with the ILI9488 display controller and the 90-00028-A0 display.
All the drawing functionality in this configuration is provided by the Generic Implementation of Graphics Primitives driver. This configuration includes information about the panel size, data type used for coordinates and color and functionality to convert RGB color to the color format native to the display.
Macros | |
#define | gfx_color(r, g, b) gfx_ili9488_color(r, g, b) |
ILI9488 display driver specific function, see gfx_ili9488_color. More... | |
#define | gfx_copy_pixels_from_screen(pixels, count) ili9488_copy_pixels_from_screen(pixels, count) |
ILI9488 display driver specific function, see ili9488_copy_pixels_from_screen. More... | |
#define | gfx_copy_pixels_to_screen(pixels, count) ili9488_copy_pixels_to_screen(pixels, count) |
ILI9488 display driver specific function, see ili9488_copy_pixels_to_screen. More... | |
#define | gfx_copy_progmem_pixels_to_screen(pixels, count) ili9488_copy_progmem_pixels_to_screen(pixels, count) |
ILI9488 display driver specific function available for ATmega and ATXmega devices, see ili9488_copy_progmem_pixels_to_screen. More... | |
#define | gfx_draw_bitmap(bmp, x, y) gfx_generic_draw_bitmap(bmp, x, y) |
ILI9488 display driver uses generic gfx implementation for this function. More... | |
#define | gfx_draw_bitmap_tiled(bmp, x1, y1, x2, y2, tile_origin_x, tile_origin_y) |
ILI9488 display driver uses generic gfx implementation for this function. More... | |
#define | gfx_draw_line_pixel(x, y, color) |
ILI9488 display driver specific function, see gfx_ili9488_draw_line_pixel. More... | |
#define | gfx_draw_pixel(x, y, color) gfx_ili9488_draw_pixel(x, y, color) |
ILI9488 display driver specific function, see gfx_ili9488_draw_pixel. More... | |
#define | gfx_duplicate_pixel(color, count) ili9488_duplicate_pixel(color, count) |
ILI9488 display driver specific function, see ili9488_duplicate_pixel. More... | |
#define | gfx_get_pixel(x, y) gfx_ili9488_get_pixel(x, y) |
ILI9488 display driver specific function, see gfx_ili9488_get_pixel. More... | |
#define | gfx_init() gfx_ili9488_init() |
ILI9488 display driver specific function, see gfx_ili9488_init. More... | |
#define | gfx_put_bitmap(bmp, map_x, map_y, x, y, width, height) gfx_generic_put_bitmap(bmp, map_x, map_y, x, y, width, height) |
ILI9488 display driver uses generic gfx implementation for this function. More... | |
#define | gfx_set_bottom_right_limit(x, y) ili9488_set_bottom_right_limit(x, y) |
ILI9488 display driver specific function, see ili9488_set_bottom_right_limit. More... | |
#define | gfx_set_ext_handler(ext_draw_handler) gfx_generic_set_ext_handler(ext_draw_handler) |
ILI9488 display driver uses generic gfx implementation for this function. More... | |
#define | gfx_set_limits(x1, y1, x2, y2) ili9488_set_limits(x1, y1, x2, y2) |
ILI9488 display driver specific function, see ili9488_set_limits. More... | |
#define | gfx_set_orientation(flags) gfx_ili9488_set_orientation(flags) |
ILI9488 display driver specific function, see gfx_ili9488_set_orientation. More... | |
#define | gfx_set_top_left_limit(x, y) ili9488_set_top_left_limit(x, y) |
ILI9488 display driver specific function, see ili9488_set_top_left_limit. More... | |
#define | gfx_sync() gfx_generic_sync() |
ILI9488 display driver uses generic gfx implementation for this function. More... | |
Functions | |
gfx_color_t | gfx_ili9488_color (uint8_t r, uint8_t g, uint8_t b) |
Generate native color value from R/G/B values. More... | |
void | gfx_ili9488_draw_line_pixel (gfx_coord_t x, gfx_coord_t y, gfx_color_t color) |
Draw a single pixel on the screen. More... | |
void | gfx_ili9488_draw_pixel (gfx_coord_t x, gfx_coord_t y, gfx_color_t color) |
Draw a single pixel on the screen. More... | |
gfx_color_t | gfx_ili9488_get_pixel (gfx_coord_t x, gfx_coord_t y) |
Get the color of a pixel on the display. More... | |
void | gfx_ili9488_init (void) |
Initialize the ili9488 display controller. More... | |
void | gfx_ili9488_set_orientation (uint8_t flags) |
Set display orientation. More... | |
gfx_coord_t | gfx_height |
Current height of screen. More... | |
gfx_coord_t | gfx_width |
Current width of screen. More... | |
gfx_coord_t | gfx_min_x |
Minimum X of current clipping region. More... | |
gfx_coord_t | gfx_min_y |
Maximum Y of current clipping region. More... | |
gfx_coord_t | gfx_max_x |
Minimum X of current clipping region. More... | |
gfx_coord_t | gfx_max_y |
Maximum Y of current clipping region. More... | |
Driver-specific Definitions | |
typedef uint16_t | gfx_color_t |
Data type for color values native to the display. More... | |
typedef ili9488_coord_t | gfx_coord_t |
Data type representing a coordinate on the screen. More... | |
Graphics Drawing Primitives | |
#define | gfx_draw_horizontal_line(x, y, length, color) gfx_generic_draw_horizontal_line(x, y, length, color) |
Draw a horizontal line, one pixel wide. More... | |
#define | gfx_draw_vertical_line(x, y, length, color) gfx_generic_draw_vertical_line(x, y, length, color) |
Draw a vertical line, one pixel wide. More... | |
#define | gfx_draw_line(x1, y1, x2, y2, color) gfx_generic_draw_line(x1, y1, x2, y2, color) |
Draw a line between two arbitrary points. More... | |
#define | gfx_draw_rect(x, y, width, height, color) gfx_generic_draw_rect(x, y, width, height, color) |
Draw an outline of a rectangle. More... | |
#define | gfx_draw_filled_rect(x, y, width, height, color) gfx_generic_draw_filled_rect(x, y, width, height, color) |
Draw a filled rectangle. More... | |
#define | gfx_draw_circle(x, y, radius, color, octant_mask) gfx_generic_draw_circle(x, y, radius, color, octant_mask) |
Draw an outline of a circle or arc. More... | |
#define | gfx_draw_filled_circle(x, y, radius, color, quadrant_mask) |
Draw a filled circle or sector. More... | |
#define | gfx_get_pixmap(pixmap, map_width, map_x, map_y, x, y, width, height) |
Read a rectangular block of pixels from the screen into data memory. More... | |
#define | gfx_put_pixmap(pixmap, map_width, map_x, map_y, x, y, width, height) |
Write a rectangular block of pixels stored in data memory to the screen. More... | |
#define gfx_color | ( | r, | |
g, | |||
b | |||
) | gfx_ili9488_color(r, g, b) |
ILI9488 display driver specific function, see gfx_ili9488_color.
#define gfx_copy_pixels_from_screen | ( | pixels, | |
count | |||
) | ili9488_copy_pixels_from_screen(pixels, count) |
ILI9488 display driver specific function, see ili9488_copy_pixels_from_screen.
#define gfx_copy_pixels_to_screen | ( | pixels, | |
count | |||
) | ili9488_copy_pixels_to_screen(pixels, count) |
ILI9488 display driver specific function, see ili9488_copy_pixels_to_screen.
#define gfx_copy_progmem_pixels_to_screen | ( | pixels, | |
count | |||
) | ili9488_copy_progmem_pixels_to_screen(pixels, count) |
ILI9488 display driver specific function available for ATmega and ATXmega devices, see ili9488_copy_progmem_pixels_to_screen.
#define gfx_draw_bitmap | ( | bmp, | |
x, | |||
y | |||
) | gfx_generic_draw_bitmap(bmp, x, y) |
ILI9488 display driver uses generic gfx implementation for this function.
#define gfx_draw_bitmap_tiled | ( | bmp, | |
x1, | |||
y1, | |||
x2, | |||
y2, | |||
tile_origin_x, | |||
tile_origin_y | |||
) |
ILI9488 display driver uses generic gfx implementation for this function.
#define gfx_draw_circle | ( | x, | |
y, | |||
radius, | |||
color, | |||
octant_mask | |||
) | gfx_generic_draw_circle(x, y, radius, color, octant_mask) |
Draw an outline of a circle or arc.
ILI9488 display driver uses generic gfx implementation for this function.
The radius is the distance from the center to the circumference, which means that the total width or height of a circle will be (radius*2+1).
The octant_mask parameter is a bitmask that decides which octants of the circle to draw. Use the GFX_OCTANTn, GFX_QUADRANTn, GFX_xHALF and GFX_WHOLE constants and OR them together if required. Radius equal to zero gives a single pixel.
x | X coordinate of center. |
y | Y coordinate of center. |
radius | Circle radius in pixels. |
color | Circle color in display native format. |
octant_mask | Bitmask indicating which octants to draw. |
Referenced by main().
#define gfx_draw_filled_circle | ( | x, | |
y, | |||
radius, | |||
color, | |||
quadrant_mask | |||
) |
Draw a filled circle or sector.
ILI9488 display driver uses generic gfx implementation for this function.
The radius is the distance from the center to the circumference, which means that the total width or height of a circle will be (radius*2+1).
The quadrant_mask parameter is a bitmask that decides which quadrants of the circle to draw. Use the GFX_QUADRANTn, GFX_xHALF and GFX_WHOLE constants and OR them together if required. Radius equal to zero gives a single pixel.
x | X coordinate of center. |
y | Y coordinate of center. |
radius | Circle radius in pixels. |
color | Circle color in display native format. |
quadrant_mask | Bitmask indicating which quadrants to draw. |
See gfx_generic_draw_filled_circle
Referenced by main().
#define gfx_draw_filled_rect | ( | x, | |
y, | |||
width, | |||
height, | |||
color | |||
) | gfx_generic_draw_filled_rect(x, y, width, height, color) |
Draw a filled rectangle.
ILI9488 display driver uses generic gfx implementation for this function.
x | X coordinate of the left side. |
y | Y coordinate of the top side. |
width | Width of the rectangle. |
height | Height of the rectangle. |
color | Color of the rectangle, in display native format. |
See gfx_generic_draw_filled_rect
Referenced by gfx_draw_char(), gfx_generic_draw_bitmap_tiled(), gfx_generic_draw_horizontal_line(), gfx_generic_draw_vertical_line(), gfx_generic_put_bitmap(), gfx_ili9488_init(), and main().
#define gfx_draw_horizontal_line | ( | x, | |
y, | |||
length, | |||
color | |||
) | gfx_generic_draw_horizontal_line(x, y, length, color) |
Draw a horizontal line, one pixel wide.
ILI9488 display driver uses generic gfx implementation for this function.
x | X coordinate of leftmost pixel. |
y | Y coordinate of the line. |
length | Length of the line in pixels. |
color | Color of the line, in display native format. |
See gfx_generic_draw_horizontal_line
Referenced by gfx_generic_draw_rect(), and main().
#define gfx_draw_line | ( | x1, | |
y1, | |||
x2, | |||
y2, | |||
color | |||
) | gfx_generic_draw_line(x1, y1, x2, y2, color) |
Draw a line between two arbitrary points.
ILI9488 display driver uses generic gfx implementation for this function.
x1 | Start X coordinate. |
y1 | Start Y coordinate. |
x2 | End X coordinate. |
y2 | End Y coordinate. |
color | Color of the line, in display native format. |
Referenced by main().
#define gfx_draw_line_pixel | ( | x, | |
y, | |||
color | |||
) |
ILI9488 display driver specific function, see gfx_ili9488_draw_line_pixel.
#define gfx_draw_pixel | ( | x, | |
y, | |||
color | |||
) | gfx_ili9488_draw_pixel(x, y, color) |
ILI9488 display driver specific function, see gfx_ili9488_draw_pixel.
#define gfx_draw_rect | ( | x, | |
y, | |||
width, | |||
height, | |||
color | |||
) | gfx_generic_draw_rect(x, y, width, height, color) |
Draw an outline of a rectangle.
ILI9488 display driver uses generic gfx implementation for this function.
x | X coordinate of the left side. |
y | Y coordinate of the top side. |
width | Width of the rectangle. |
height | Height of the rectangle. |
color | Color of the rectangle, in display native format. |
Referenced by main().
#define gfx_draw_vertical_line | ( | x, | |
y, | |||
length, | |||
color | |||
) | gfx_generic_draw_vertical_line(x, y, length, color) |
Draw a vertical line, one pixel wide.
ILI9488 display driver uses generic gfx implementation for this function.
x | X coordinate of the line. |
y | Y coordinate of the topmost pixel. |
length | Length of the line in pixels. |
color | Color of the line, in display native format. |
See gfx_generic_draw_vertical_line
Referenced by gfx_generic_draw_filled_circle(), gfx_generic_draw_rect(), and main().
#define gfx_duplicate_pixel | ( | color, | |
count | |||
) | ili9488_duplicate_pixel(color, count) |
ILI9488 display driver specific function, see ili9488_duplicate_pixel.
#define gfx_get_pixel | ( | x, | |
y | |||
) | gfx_ili9488_get_pixel(x, y) |
ILI9488 display driver specific function, see gfx_ili9488_get_pixel.
#define gfx_get_pixmap | ( | pixmap, | |
map_width, | |||
map_x, | |||
map_y, | |||
x, | |||
y, | |||
width, | |||
height | |||
) |
Read a rectangular block of pixels from the screen into data memory.
ILI9488 display driver uses generic gfx implementation for this function.
If the area to read is outside the clipping region, those pixels will not be read, and the corresponding data memory will be left untouched. Note that this function fails if width or height is negative or the pixel rectangle is outside the pixmap buffer extents. Clipping is only performed on the screen, not inside the pixmap buffer itself. Note that there is no checking if the pixel rectangle exceeds the bottom of the pixmap buffer.
pixmap | Pointer to pixel buffer in data memory. |
map_width | Width of the pixel buffer. |
map_x | X coordinate inside pixel buffer. |
map_y | Y coordinate inside pixel buffer. |
x | X coordinate on screen. |
y | Y coordinate on screen. |
width | Width of pixel rectangle to copy. |
height | Height of pixel rectangle to copy. |
#define gfx_init | ( | ) | gfx_ili9488_init() |
ILI9488 display driver specific function, see gfx_ili9488_init.
Referenced by main().
#define gfx_put_bitmap | ( | bmp, | |
map_x, | |||
map_y, | |||
x, | |||
y, | |||
width, | |||
height | |||
) | gfx_generic_put_bitmap(bmp, map_x, map_y, x, y, width, height) |
ILI9488 display driver uses generic gfx implementation for this function.
#define gfx_put_pixmap | ( | pixmap, | |
map_width, | |||
map_x, | |||
map_y, | |||
x, | |||
y, | |||
width, | |||
height | |||
) |
Write a rectangular block of pixels stored in data memory to the screen.
ILI9488 display driver uses generic gfx implementation for this function.
If the area to write is outside the clipping region, those pixels will not be written. Note that this function fails if the width or height is negative or the pixel rectangle is outside the pixmap buffer extents. Clipping is only performed on the screen, not inside the pixmap buffer itself. Note that there is no checking if the pixel rectangle exceeds the bottom of the pixmap buffer.
pixmap | Pointer to pixel buffer in data memory. |
map_width | Width of the pixel buffer. |
map_x | X coordinate inside pixel buffer. |
map_y | Y coordinate inside pixel buffer. |
x | X coordinate on screen. |
y | Y coordinate on screen. |
width | Width of pixel rectangle to copy. |
height | Height of pixel rectangle to copy. |
#define gfx_set_bottom_right_limit | ( | x, | |
y | |||
) | ili9488_set_bottom_right_limit(x, y) |
ILI9488 display driver specific function, see ili9488_set_bottom_right_limit.
#define gfx_set_ext_handler | ( | ext_draw_handler | ) | gfx_generic_set_ext_handler(ext_draw_handler) |
ILI9488 display driver uses generic gfx implementation for this function.
#define gfx_set_limits | ( | x1, | |
y1, | |||
x2, | |||
y2 | |||
) | ili9488_set_limits(x1, y1, x2, y2) |
ILI9488 display driver specific function, see ili9488_set_limits.
#define gfx_set_orientation | ( | flags | ) | gfx_ili9488_set_orientation(flags) |
ILI9488 display driver specific function, see gfx_ili9488_set_orientation.
#define gfx_set_top_left_limit | ( | x, | |
y | |||
) | ili9488_set_top_left_limit(x, y) |
ILI9488 display driver specific function, see ili9488_set_top_left_limit.
#define gfx_sync | ( | void | ) | gfx_generic_sync() |
ILI9488 display driver uses generic gfx implementation for this function.
See gfx_generic_sync
Data type for color values native to the display.
Data type representing a coordinate on the screen.
gfx_color_t gfx_ili9488_color | ( | uint8_t | r, |
uint8_t | g, | ||
uint8_t | b | ||
) |
Generate native color value from R/G/B values.
Converts 8-bit R/G/B values to a color value native to the display.
The macro GFX_COLOR does the same, only allows the preprocessor to handle the calculations.
r | 8-bit red value. |
g | 8-bit green value. |
b | 8-bit blue value. |
References GFX_COLOR.
void gfx_ili9488_draw_line_pixel | ( | gfx_coord_t | x, |
gfx_coord_t | y, | ||
gfx_color_t | color | ||
) |
Draw a single pixel on the screen.
This function draws a single pixel on screen only setting top limit which makes it more suitable for line drawing. If outside the clipping region, nothing is drawn.
x | X coordinate of the pixel to be drawn. |
y | Y coordinate of the pixel to be drawn. |
color | Color value of the pixel in display native format. |
References gfx_max_x, gfx_max_y, gfx_min_x, gfx_min_y, gfx_set_top_left_limit(), and ili9488_write_gram().
void gfx_ili9488_draw_pixel | ( | gfx_coord_t | x, |
gfx_coord_t | y, | ||
gfx_color_t | color | ||
) |
Draw a single pixel on the screen.
Draw a single pixel on screen setting top and bottom limits. If outside the clipping region, nothing is drawn.
x | X coordinate of the pixel to be drawn. |
y | Y coordinate of the pixel to be drawn. |
color | Color value of the pixel in display native format. |
References gfx_max_x, gfx_max_y, gfx_min_x, gfx_min_y, gfx_set_limits(), and ili9488_write_gram().
gfx_color_t gfx_ili9488_get_pixel | ( | gfx_coord_t | x, |
gfx_coord_t | y | ||
) |
Get the color of a pixel on the display.
x | X coordinate of the pixel to be sampled. |
y | Y coordinate of the pixel to be sampled. |
References gfx_bitmap::color, GFX_COLOR_INVALID, gfx_max_x, gfx_max_y, gfx_min_x, gfx_min_y, gfx_set_limits(), and ili9488_read_gram().
void gfx_ili9488_init | ( | void | ) |
Initialize the ili9488 display controller.
This function will be called when calling gfx_init. It will draw a black background to the display and enable the display backlight if available.
References ili9488_opt_t::background_color, COLOR_BLACK, COLOR_WHITE, ili9488_opt_t::foreground_color, GFX_COLOR_BLACK, gfx_draw_filled_rect, gfx_height, gfx_set_clipping(), gfx_width, ili9488_display_on(), ili9488_init(), ILI9488_LCD_HEIGHT, ILI9488_LCD_WIDTH, ili9488_opt_t::ul_height, and ili9488_opt_t::ul_width.
void gfx_ili9488_set_orientation | ( | uint8_t | flags | ) |
Set display orientation.
Set the display orientation
flags |
References gfx_height, gfx_set_clipping(), GFX_SWITCH_XY, gfx_width, ILI9488_LCD_HEIGHT, ILI9488_LCD_WIDTH, ili9488_set_orientation(), ILI9488_SWITCH_XY_HEIGHT, and ILI9488_SWITCH_XY_WIDTH.
gfx_coord_t gfx_height |
Current height of screen.
Referenced by gfx_generic_draw_line(), gfx_get_height(), gfx_ili9488_init(), gfx_ili9488_set_orientation(), and gfx_set_clipping().
gfx_coord_t gfx_max_x |
Minimum X of current clipping region.
Referenced by gfx_generic_draw_filled_rect(), gfx_generic_get_pixmap(), gfx_generic_put_bitmap(), gfx_generic_put_pixmap(), gfx_ili9488_draw_line_pixel(), gfx_ili9488_draw_pixel(), gfx_ili9488_get_pixel(), and gfx_set_clipping().
gfx_coord_t gfx_max_y |
Maximum Y of current clipping region.
Referenced by gfx_generic_draw_filled_rect(), gfx_generic_get_pixmap(), gfx_generic_put_bitmap(), gfx_generic_put_pixmap(), gfx_ili9488_draw_line_pixel(), gfx_ili9488_draw_pixel(), gfx_ili9488_get_pixel(), and gfx_set_clipping().
gfx_coord_t gfx_min_x |
Minimum X of current clipping region.
Referenced by gfx_generic_draw_filled_rect(), gfx_generic_get_pixmap(), gfx_generic_put_bitmap(), gfx_generic_put_pixmap(), gfx_ili9488_draw_line_pixel(), gfx_ili9488_draw_pixel(), gfx_ili9488_get_pixel(), and gfx_set_clipping().
gfx_coord_t gfx_min_y |
Maximum Y of current clipping region.
Referenced by gfx_generic_draw_filled_rect(), gfx_generic_get_pixmap(), gfx_generic_put_bitmap(), gfx_generic_put_pixmap(), gfx_ili9488_draw_line_pixel(), gfx_ili9488_draw_pixel(), gfx_ili9488_get_pixel(), and gfx_set_clipping().
gfx_coord_t gfx_width |
Current width of screen.
Referenced by gfx_generic_draw_line(), gfx_get_width(), gfx_ili9488_init(), gfx_ili9488_set_orientation(), and gfx_set_clipping().