u8g2 - u8g2图形处理库

本页文档由这个文件自动生成。如有错误,请提交issue或帮忙修改后pr,谢谢!

u8g2.begin(conf)

u8g2显示屏初始化

参数

传入值类型

解释

table

conf 配置信息

返回值

返回值类型

解释

int

正常初始化1,已经初始化过2,内存不够3,初始化失败返回4

例子

-- 初始化i2c1的ssd1306
u8g2.begin({ic = "SSD1306",mode="i2c_hw",i2c_id=0})

u8g2.close()

关闭显示屏

参数

返回值

例子

-- 关闭disp,再次使用disp相关API的话,需要重新初始化
u8g2.close()

u8g2.ClearBuffer()

清屏,清除内存帧缓冲区中的所有像素

参数

返回值

例子

-- 清屏
u8g2.ClearBuffer()

u8g2.SendBuffer()

将数据更新到屏幕,将存储器帧缓冲区的内容发送到显示器

参数

返回值

例子

-- 把显示数据更新到屏幕
u8g2.SendBuffer()

u8g2.DrawUTF8(str, x, y)

在显示屏上画一段文字,在显示屏上画一段文字,要调用u8g2.SendBuffer()才会更新到屏幕

参数

传入值类型

解释

string

文件内容

int

横坐标

int

竖坐标

返回值

例子

u8g2.DrawUTF8("wifi is ready", 10, 20)

u8g2.SetFontMode(mode)

设置字体模式

参数

传入值类型

解释

int

mode字体模式,启用(1)或禁用(0)透明模式

返回值

例子

u8g2.SetFontMode(1)

u8g2.SetFont(font)

设置字体

参数

传入值类型

解释

int

font, u8g2.font_ncenB08_tr为纯英文8x8字节,u8g2.font_opposansm12_chinese 为12x12全中文,u8g2.font_unifont_t_symbols 为符号.

返回值

例子

-- 设置为中文字体,对之后的drawStr有效,使用中文字体需在luat_base.h开启#define USE_U8G2_OPPOSANSM12_CHINESE
u8g2.setFont(u8g2.font_wqy12_t_gb2312)

u8g2.GetDisplayHeight()

获取显示屏高度

参数

返回值

返回值类型

解释

int

显示屏高度

例子

u8g2.GetDisplayHeight()

u8g2.GetDisplayWidth()

获取显示屏宽度

参数

返回值

返回值类型

解释

int

显示屏宽度

例子

u8g2.GetDisplayWidth()

u8g2.DrawPixel(x,y)

画一个点.

参数

传入值类型

解释

int

X位置.

int

Y位置.

返回值

例子

u8g2.DrawPixel(20, 5)

u8g2.DrawLine(x0,y0,x1,y1)

在两点之间画一条线.

参数

传入值类型

解释

int

第一个点的X位置.

int

第一个点的Y位置.

int

第二个点的X位置.

int

第二个点的Y位置.

返回值

例子

u8g2.DrawLine(20, 5, 5, 32)

u8g2.DrawCircle(x0,y0,rad,opt)

在x,y位置画一个半径为rad的空心圆.

参数

传入值类型

解释

int

圆心位置

int

圆心位置

int

圆半径.

int

选择圆的部分或全部.

返回值

例子


u8g2.DrawDisc(x0,y0,rad,opt)

在x,y位置画一个半径为rad的实心圆.

参数

传入值类型

解释

int

圆心位置

int

圆心位置

int

圆半径.

int

选择圆的部分或全部.

返回值

例子


u8g2.DrawEllipse(x0,y0,rx,ry,opt)

在x,y位置画一个半径为rad的空心椭圆.

参数

传入值类型

解释

int

圆心位置

int

圆心位置

int

椭圆大小

int

椭圆大小

int

选择圆的部分或全部.

返回值

例子


u8g2.DrawFilledEllipse(x0,y0,rx,ry,opt)

在x,y位置画一个半径为rad的实心椭圆.

参数

传入值类型

解释

int

圆心位置

int

圆心位置

int

椭圆大小

int

椭圆大小

int

选择圆的部分或全部.

返回值

例子


u8g2.DrawBox(x,y,w,h)

从x / y位置(左上边缘)开始绘制一个框(填充的框).

参数

传入值类型

解释

int

左上边缘的X位置

int

左上边缘的Y位置

int

盒子的宽度

int

盒子的高度

返回值

例子

u8g2.DrawBox(3,7,25,15)

u8g2.DrawFrame(x,y,w,h)

从x / y位置(左上边缘)开始绘制一个框(空框).

参数

传入值类型

解释

int

左上边缘的X位置

int

左上边缘的Y位置

int

盒子的宽度

int

盒子的高度

返回值

例子

u8g2.DrawFrame(3,7,25,15)

u8g2.DrawRBox(x,y,w,h,r)

绘制一个从x / y位置(左上边缘)开始具有圆形边缘的填充框/框架.

参数

传入值类型

解释

int

左上边缘的X位置

int

左上边缘的Y位置

int

盒子的宽度

int

盒子的高度

int

四个边缘的半径

返回值

例子

u8g2.DrawRBox(3,7,25,15)

u8g2.DrawRFrame(x,y,w,h,r)

绘制一个从x / y位置(左上边缘)开始具有圆形边缘的空框/框架.

参数

传入值类型

解释

int

左上边缘的X位置

int

左上边缘的Y位置

int

盒子的宽度

int

盒子的高度

int

四个边缘的半径

返回值

例子

u8g2.DrawRFrame(3,7,25,15)

u8g2.DrawGlyph(x,y,encoding)

绘制一个图形字符。字符放置在指定的像素位置x和y.

参数

传入值类型

解释

int

字符在显示屏上的位置

int

字符在显示屏上的位置

int

字符的Unicode值

返回值

例子

u8g2.SetFont(u8g2_font_unifont_t_symbols)
u8g2.DrawGlyph(5, 20, 0x2603)	-- dec 9731/hex 2603 Snowman

u8g2.DrawTriangle(x0,y0,x1,y1,x2,y2)

绘制一个三角形(实心多边形).

参数

传入值类型

解释

int

点0X位置

int

点0Y位置

int

点1X位置

int

点1Y位置

int

点2X位置

int

点2Y位置

返回值

例子

u8g2.DrawTriangle(20,5, 27,50, 5,32)

u8g2.SetBitmapMode(mode)

定义位图函数是否将写入背景色

参数

传入值类型

解释

int

mode字体模式,启用(1)或禁用(0)透明模式

返回值

例子

u8g2.SetBitmapMode(1)

u8g2.DrawXBM(x, y, w, h, data)

绘制位图

参数

传入值类型

解释

int

X坐标

int

y坐标

int

位图宽

int

位图高

int

位图数据,每一位代表一个像素

返回值

例子

-- 取模使用PCtoLCD2002软件即可
-- 在(0,0)为左上角,绘制 16x16 "今" 的位图 
u8g2.DrawXBM(0, 0, 16,16, string.char(
    0x80,0x00,0x80,0x00,0x40,0x01,0x20,0x02,0x10,0x04,0x48,0x08,0x84,0x10,0x83,0x60,
    0x00,0x00,0xF8,0x0F,0x00,0x08,0x00,0x04,0x00,0x04,0x00,0x02,0x00,0x01,0x80,0x00
))

u8g2.DrawDrcode(x, y, str, version)

缓冲区绘制QRCode

参数

传入值类型

解释

int

x坐标

int

y坐标

string

二维码的内容

int

二维码版本号

返回值

返回值类型

解释

nil

无返回值

例子


u8g2.drawGtfontGb2312(str,size,x,y)

使用gtfont显示gb2312字符串

参数

传入值类型

解释

string

str 显示字符串

int

size 字体大小 (支持16-192号大小字体)

int

x 横坐标

int

y 竖坐标

返回值

例子

u8g2.drawGtfontGb2312("啊啊啊",32,0,0)

u8g2.drawGtfontUtf8(str,size,x,y)

使用gtfont显示UTF8字符串

参数

传入值类型

解释

string

str 显示字符串

int

size 字体大小 (支持16-192号大小字体)

int

x 横坐标

int

y 竖坐标

返回值

例子

u8g2.drawGtfontUtf8("啊啊啊",32,0,0)