134 lines
3.8 KiB
C
134 lines
3.8 KiB
C
/*
|
||
* 模块名称：LCD 绘图模块
|
||
* 模块功能：提供字符、字符串（中英文混合）、线条、矩形、圆形等图形绘制
|
||
* 适用平台：STM32F103C8T6 + ST7735S + 底层 st7735s.c
|
||
* 作者：王建锋
|
||
* 创建日期：2026-07-14
|
||
* 修改记录：
|
||
* 2026-07-14 王建锋 从 st7735s.c 拆分
|
||
*/
|
||
|
||
#ifndef __LCD_H
|
||
#define __LCD_H
|
||
|
||
#ifdef __cplusplus
|
||
extern "C" {
|
||
#endif
|
||
|
||
#include "st7735s.h"
|
||
#include <stdint.h>
|
||
|
||
/* 字体定义 */
|
||
#define FONT_WIDTH_8 8 /* 8x16字体宽度（含间距） */
|
||
#define FONT_HEIGHT_16 16 /* 8x16字体高度 */
|
||
#define FONT_WIDTH_6 6 /* 6x8字体宽度 */
|
||
#define FONT_HEIGHT_8 8 /* 6x8字体高度 */
|
||
|
||
/* === 字符/字符串绘制 === */
|
||
|
||
/*
|
||
* 函数功能：显示一个8x16 ASCII字符
|
||
* 入口参数：x - 列坐标
|
||
* y - 行坐标
|
||
* ch - 字符 (ASCII 32-126)
|
||
* color - 字符颜色 (RGB565)
|
||
* bg_color - 背景颜色 (RGB565)
|
||
* 返回值：无
|
||
*/
|
||
void lcd_draw_char(uint16_t x, uint16_t y, char ch, uint16_t color, uint16_t bg_color);
|
||
|
||
/*
|
||
* 函数功能：显示字符串（ASCII）
|
||
* 入口参数：x - 列坐标
|
||
* y - 行坐标
|
||
* str - 字符串指针
|
||
* color - 字符颜色 (RGB565)
|
||
* bg_color - 背景颜色 (RGB565)
|
||
* 返回值：无
|
||
*/
|
||
void lcd_draw_string(uint16_t x, uint16_t y, const char *str, uint16_t color, uint16_t bg_color);
|
||
|
||
/*
|
||
* 函数功能：显示一个6x8 ASCII字符
|
||
* 入口参数：x - 列坐标
|
||
* y - 行坐标
|
||
* ch - 字符 (ASCII 32-126)
|
||
* color - 字符颜色 (RGB565)
|
||
* bg_color - 背景颜色 (RGB565)
|
||
* 返回值：无
|
||
*/
|
||
void lcd_draw_char_6x8(uint16_t x, uint16_t y, char ch, uint16_t color, uint16_t bg_color);
|
||
|
||
/*
|
||
* 函数功能：显示字符串（6x8字体）
|
||
* 入口参数：x - 列坐标
|
||
* y - 行坐标
|
||
* str - 字符串指针
|
||
* color - 字符颜色 (RGB565)
|
||
* bg_color - 背景颜色 (RGB565)
|
||
* 返回值：无
|
||
*/
|
||
void lcd_draw_string_6x8(uint16_t x, uint16_t y, const char *str, uint16_t color, uint16_t bg_color);
|
||
|
||
/*
|
||
* 函数功能：显示一个16x16 CJK汉字
|
||
* 入口参数：x - 列坐标
|
||
* y - 行坐标
|
||
* unicode - Unicode码点 (如 0x4E00="一")
|
||
* color - 字符颜色 (RGB565)
|
||
* bg_color - 背景颜色 (RGB565)
|
||
* 返回值：无
|
||
*/
|
||
void lcd_draw_chinese(uint16_t x, uint16_t y, uint16_t unicode, uint16_t color, uint16_t bg_color);
|
||
|
||
/*
|
||
* 函数功能：显示UTF-8字符串（自动中英文混合）
|
||
* 入口参数：x - 列坐标
|
||
* y - 行坐标
|
||
* str - UTF-8字符串指针
|
||
* color - 字符颜色 (RGB565)
|
||
* bg_color - 背景颜色 (RGB565)
|
||
* 返回值：无
|
||
*/
|
||
void lcd_draw_chinese_string(uint16_t x, uint16_t y, const char *str, uint16_t color, uint16_t bg_color);
|
||
|
||
/* === 图形绘制 === */
|
||
|
||
/*
|
||
* 函数功能：画线（Bresenham算法）
|
||
* 入口参数：x1 - 起始列
|
||
* y1 - 起始行
|
||
* x2 - 结束列
|
||
* y2 - 结束行
|
||
* color - 颜色 (RGB565)
|
||
* 返回值：无
|
||
*/
|
||
void lcd_draw_line(uint16_t x1, uint16_t y1, uint16_t x2, uint16_t y2, uint16_t color);
|
||
|
||
/*
|
||
* 函数功能：画空心矩形
|
||
* 入口参数：x - 左上角列
|
||
* y - 左上角行
|
||
* width - 宽度
|
||
* height - 高度
|
||
* color - 颜色 (RGB565)
|
||
* 返回值：无
|
||
*/
|
||
void lcd_draw_rect(uint16_t x, uint16_t y, uint16_t width, uint16_t height, uint16_t color);
|
||
|
||
/*
|
||
* 函数功能：画空心圆（Bresenham算法）
|
||
* 入口参数：x0 - 圆心列
|
||
* y0 - 圆心行
|
||
* radius - 半径
|
||
* color - 颜色 (RGB565)
|
||
* 返回值：无
|
||
*/
|
||
void lcd_draw_circle(uint16_t x0, uint16_t y0, uint16_t radius, uint16_t color);
|
||
|
||
#ifdef __cplusplus
|
||
}
|
||
#endif
|
||
|
||
#endif /* __LCD_H */
|