u8glib 用户参考手册.docx
《u8glib 用户参考手册.docx》由会员分享，可在线阅读，更多相关《u8glib 用户参考手册.docx（53页珍藏版）》请在冰点文库上搜索。
u8glib用户参考手册
用户参考手册
开始
∙c++原型
uint8_tU8GLIB:
:
begin（void）
∙C原型
uint8_tu8g_Begin（u8g_t*u8g）
∙描述
重置显示和放到默认状态。
∙参数:
ou8gu8g:
指针结构（C接口）。
∙返回:
0,如果初始化过程失败。
∙使用:
外循环。
∙注意:
与v1.11可用。
∙例子:
∙另见:
U8GLIB
disableCursor
∙c++原型
voidU8GLIB:
:
disableCursor（void）
∙C原型
voidu8g_DisableCursor（u8g_t*u8g）
∙描述
禁用光标。
光标将不可见。
∙参数:
ou8gu8g:
指针结构（C接口）。
∙返回:
∙使用:
外循环。
∙注意:
∙例子:
∙另见:
enableCursor,setCursorColor,setCursorFont,setCursorPos,setCursorStyle
drawBitmap
drawBitmapP
∙c++原型
voidU8GLIB:
:
drawBitmap（u8g_uint_tx,u8g_uint_ty,u8g_uint_tcnt,u8g_uint_th,constuint8_t*bitmap）
voidU8GLIB:
:
drawBitmapP（u8g_uint_tx,u8g_uint_ty,u8g_uint_tcnt,u8g_uint_th,constu8g_pgm_uint8_t*bitmap）
∙C原型
voidu8g_DrawBitmap（u8g_t*u8g,u8g_uint_tx,u8g_uint_ty,u8g_uint_tcnt,u8g_uint_th,constuint8_t*bitmap）
voidu8g_DrawBitmapP（u8g_t*u8g,u8g_uint_tx,u8g_uint_ty,u8g_uint_tcnt,u8g_uint_th,constu8g_pgm_uint8_t*bitmap）
∙描述
绘制位图在指定的x/y位置（位图的左上角）。
外的部分位图可以显示边界。
位图是由数组指定的位图。
清除一点的意思是:
不画一像素。
一组位数组里面的意思是:
写像素与当前颜色索引。
单色显示,颜色索引0通常会清晰的像素和颜色指数1将一个像素。
∙参数:
ou8gu8g:
指针结构（C接口）。
o谢:
X-position（左位图的位置）。
oy:
Y-position（位图上的位置）。
o问:
位图在水平方向的字节数。
位图的宽度是问*8。
oh:
位图的高度。
∙返回:
∙使用:
内循环。
∙注意:
∙例子:
U8GLIB_PCD8544u8g（13,11,10,9,8）; //SPIcommunication:
SCK=13,MOSI=11,CS=10,A0=9,Reset=8
constuint8_trook_bitmap[]U8G_PROGMEM={
0x00, //00000000
0x55, //01010101
0x7f, //01111111
0x3e, //00111110
0x3e, //00111110
0x3e, //00111110
0x3e, //00111110
0x7f //01111111
};
voiddraw（void）{
//graphiccommandstoredrawthecompletescreenshouldbeplacedhere
u8g.drawBitmapP（0,0,1,8,rook_bitmap）;
}
voidsetup（void）{
}
voidloop（void）{
//pictureloop
u8g.firstPage（）;
do{
draw（）;
}while（u8g.nextPage（））;
//rebuildthepictureaftersomedelay
delay（1000）;
}
∙另见:
setColorIndexdrawXBM
drawBox
∙c++原型
voidU8GLIB:
:
drawBox（u8g_uint_tx,u8g_uint_ty,u8g_uint_tw,u8g_uint_th）
∙C原型
voidu8g_DrawBox（u8g_t*u8g,u8g_uint_tx,u8g_uint_ty,u8g_uint_tw,u8g_uint_th）
∙描述
画一个框（填充框架）,从x/y位置（左上角的边缘）。
箱子的宽度w和高度h。
部分外框可以显示边界。
这个过程使用当前颜色索引画。
单色显示,颜色索引0通常会清晰的像素和颜色指数1将一个像素。
∙参数:
ou8gu8g:
指针结构（C接口）。
ox:
X-position左上角的边缘。
oy:
Y-position左上角的边缘。
ow:
盒子的宽度。
oh:
盒子的高度。
∙返回:
∙使用:
内循环。
∙注意:
∙例子:
U8GLIBu8g（...）
...
u8g.drawBox（10,12,20,30）;
∙另见:
setColorIndex,拉伸机
drawCircle
∙c++原型
voidU8GLIB:
:
drawCircle（u8g_uint_tx0,u8g_uint_ty0,u8g_uint_trad,uint8_topt=U8G_DRAW_ALL）
∙C原型
voidu8g_DrawCircle（u8g_t*u8g,u8g_uint_tx0,u8g_uint_ty0,u8g_uint_trad,uint8_topt）
∙描述
画一个圆与radusrad位置（x0,y0）。
圆的直径是2*rad+1根据选择,只可以画圆的部分。
选择可能的值是:
U8G_DRAW_UPPER_RIGHT、U8G_DRAW_UPPER_LEFTU8G_DRAW_LOWER_LEFT,U8G_DRAW_LOWER_RIGHTU8G_DRAW_ALL。
这些值可以结合|操作符。
∙参数:
ou8gu8g:
指针结构（C接口）。
ox0,y0:
圆的中心的位置。
orad:
定义的大小循环:
Radus=rad。
o选择:
选择部分或全部的循环。
▪U8G_DRAW_UPPER_RIGHT
▪U8G_DRAW_UPPER_LEFT
▪U8G_DRAW_LOWER_LEFT
▪U8G_DRAW_LOWER_RIGHT
▪U8G_DRAW_ALL
∙返回:
∙使用:
内循环。
∙注意:
与v1.02可用
∙例子:
u8g.drawCircle（20,20,14）;
u8g.drawCircle（20,20,14,U8G_DRAW_UPPER_RIGHT）;
∙另见:
drawDisc
drawDisc
∙c++原型
voidU8GLIB:
:
drawDisc（u8g_uint_tx0,u8g_uint_ty0,u8g_uint_trad,uint8_topt=U8G_DRAW_ALL）
∙C原型
voidu8g_DrawDisc（u8g_t*u8g,u8g_uint_tx0,u8g_uint_ty0,u8g_uint_trad,uint8_topt）
∙描述
画一个圆圈装满radusrad位置（x0,y0）。
圆的直径是2*rad+1根据选择,可以画只有部分的圆盘。
选择可能的值是:
U8G_DRAW_UPPER_RIGHT、U8G_DRAW_UPPER_LEFTU8G_DRAW_LOWER_LEFT,U8G_DRAW_LOWER_RIGHTU8G_DRAW_ALL。
这些值可以结合|操作符。
∙参数:
ou8gu8g:
指针结构（C接口）。
ox0,y0:
实心圆的中心的位置。
orad:
定义了光盘的大小:
Radus=rad。
o选择:
选择部分或全部的循环。
▪U8G_DRAW_UPPER_RIGHT
▪U8G_DRAW_UPPER_LEFT
▪U8G_DRAW_LOWER_LEFT
▪U8G_DRAW_LOWER_RIGHT
▪U8G_DRAW_ALL
∙返回:
∙使用:
内循环。
∙注意:
与v1.02可用
∙例如:
看drawCircle
∙另见:
drawCircle
drawEllipse
∙c++原型
voidU8GLIB:
:
drawEllipse（u8g_t*u8g,u8g_uint_tx0,u8g_uint_ty0,u8g_uint_trx,u8g_uint_try,uint8_topt）
∙C原型
voidu8g_DrawEllipse（u8g_t*u8g,u8g_uint_tx0,u8g_uint_ty0,u8g_uint_trx,u8g_uint_try,uint8_topt）
∙描述
画椭圆radusrx和“办法”位置（x0,y0）。
rx*办法必须低于10248位u8glib模式。
根据选择,可以画只有部分的圆盘。
选择可能的值是:
U8G_DRAW_UPPER_RIGHT、U8G_DRAW_UPPER_LEFTU8G_DRAW_LOWER_LEFT,U8G_DRAW_LOWER_RIGHTU8G_DRAW_ALL。
这些值可以结合|操作符。
∙参数:
ou8gu8g:
指针结构（C接口）。
ox0,y0:
实心圆的中心的位置。
o处方,处方:
定义椭圆的大小。
o选择:
选择部分或全部的椭圆。
▪U8G_DRAW_UPPER_RIGHT
▪U8G_DRAW_UPPER_LEFT
▪U8G_DRAW_LOWER_LEFT
▪U8G_DRAW_LOWER_RIGHT
▪U8G_DRAW_ALL
∙返回:
∙使用:
内循环。
∙注意:
与v1.14可用
∙另见:
drawCircle
drawFilledEllipse
∙c++原型
voidU8GLIB:
:
drawFilledEllipse（u8g_t*u8g,u8g_uint_tx0,u8g_uint_ty0,u8g_uint_trx,u8g_uint_try,uint8_topt）
∙C原型
voidu8g_DrawFilledEllipse（u8g_t*u8g,u8g_uint_tx0,u8g_uint_ty0,u8g_uint_trx,u8g_uint_try,uint8_topt）
∙描述
画一个椭圆装满radusrx和“办法”位置（x0,y0）。
rx*办法必须低于10248位u8glib模式。
根据选择,可以画只有部分的圆盘。
选择可能的值是:
U8G_DRAW_UPPER_RIGHT、U8G_DRAW_UPPER_LEFTU8G_DRAW_LOWER_LEFT,U8G_DRAW_LOWER_RIGHTU8G_DRAW_ALL。
这些值可以结合|操作符。
∙参数:
ou8gu8g:
指针结构（C接口）。
ox0,y0:
实心圆的中心的位置。
o处方,处方:
定义椭圆的大小。
o选择:
选择部分或全部的椭圆。
▪U8G_DRAW_UPPER_RIGHT
▪U8G_DRAW_UPPER_LEFT
▪U8G_DRAW_LOWER_LEFT
▪U8G_DRAW_LOWER_RIGHT
▪U8G_DRAW_ALL
∙返回:
∙使用:
内循环。
∙注意:
与v1.14可用
∙另见:
drawCircle
拉伸机
∙c++原型
voidU8GLIB:
:
drawFrame（u8g_uint_tx,u8g_uint_ty,u8g_uint_tw,u8g_uint_th）
∙C原型
voidu8g_DrawFrame（u8g_t*u8g,u8g_uint_tx,u8g_uint_ty,u8g_uint_tw,u8g_uint_th）
∙描述
画一个框架,从x/y位置（左上角的边缘）。
框架的宽度w和高度h。
部分可以显示边界之外的框架。
这个过程使用当前颜色索引画的框架。
单色显示,颜色索引0通常会清晰的像素和颜色指数1将一个像素。
∙参数:
ou8gu8g:
指针结构（C接口）。
ox:
X-position左上角的边缘。
oy:
Y-position左上角的边缘。
ow:
帧的宽度。
oh:
框架的高度。
∙返回:
∙使用:
内循环。
∙注意:
∙例子:
U8GLIBu8g（...）
...
u8g.drawFrame（10,12,30,20）;
∙另见:
setColorIndex,drawBox
drawHLine
∙c++原型
voidU8GLIB:
:
drawHLine（u8g_uint_tx,u8g_uint_ty,u8g_uint_tw）
∙C原型
voidu8g_DrawHLine（u8g_t*u8g,uint8_tx,uint8_ty,u8g_uint_tw）
∙描述
画一条水平线,从x/y位置（左边缘）。
线的宽度w像素。
部分的线可以显示边界之外的。
这个过程使用当前颜色索引划清界限。
单色显示,颜色索引0通常会清晰的像素和颜色指数1将一个像素。
∙参数:
ou8gu8g:
指针结构（C接口）。
ox:
X-position。
oy:
Y-position。
ow:
水平线的宽度。
∙返回:
∙使用:
内循环。
∙注意:
∙例子:
∙另见:
setColorIndex,drawVLine
画直线
∙c++原型
voidU8GLIB:
:
drawLine（u8g_uint_tx1,u8g_uint_ty1,u8g_uint_tx2,u8g_uint_ty2）
∙C原型
voidu8g_DrawLine（u8g_t*u8g,u8g_uint_tx1,u8g_uint_ty1,u8g_uint_tx2,u8g_uint_ty2）
∙描述
画一条线从（x1,y1）（x2,y2）。
没有任何限制的开始结束结束位置。
这个过程使用当前颜色索引划清界限。
单色显示,颜色索引0通常会清晰的像素和颜色指数1将一个像素。
∙参数:
ou8gu8g:
指针结构（C接口）。
ox1,y1:
开始的位置。
ox2,y2:
结束位置。
∙返回:
∙使用:
内循环。
∙注意:
可以在v1.03。
∙例子:
u8g.drawLine（7,10,40,55）;
∙另见:
setColorIndex,drawVLinedrawHLine
drawPixel
∙c++原型
voidU8GLIB:
:
drawPixel（uint8_tx,uint8_ty）
∙C原型
voidu8g_DrawPixel（u8g_t*u8g,uint8_tx,uint8_ty）
∙描述
画一个像素在指定的x/y位置。
位置（0,0）的左上角显示。
外的位置可能显示边界。
这个过程使用当前颜色指数画像素。
单色显示,颜色索引0通常会清晰的像素和颜色指数1将一个像素。
∙参数:
ou8gu8g:
指针结构（C接口）。
ox:
X-position。
oy:
Y-position。
∙返回:
∙使用:
内循环。
∙注意:
∙例子:
U8GLIBu8g（...）
...
u8g.drawPixel（14,23）;
∙另见:
setColorIndex
drawRBox
drawRFrame
∙c++原型
voidU8GLIB:
:
drawRBox（u8g_uint_tx,u8g_uint_ty,u8g_uint_tw,u8g_uint_th,u8g_uint_tr）
voidU8GLIB:
:
drawRFrame（u8g_uint_tx,u8g_uint_ty,u8g_uint_tw,u8g_uint_th,u8g_uint_tr）
∙C原型
voidu8g_DrawRBox（u8g_t*u8g,u8g_uint_tx,u8g_uint_ty,u8g_uint_tw,u8g_uint_th,u8g_uint_tr）
voidu8g_DrawRFrame（u8g_t*u8g,u8g_uint_tx,u8g_uint_ty,u8g_uint_tw,u8g_uint_th,u8g_uint_tr）
∙描述
画一个框/框架与圆的边缘,开始在x/y位置（左上角的边缘）。
箱/帧的宽度w和高度h。
部分框可以显示边界之外的。
边缘半径r。
它要求w>=2*（r+1）和h>=2*（r+1）。
这种情况不是检查。
行为是未定义的,如果w或h小于2*（r+1）。
这个过程使用当前颜色索引画。
单色显示,颜色索引0通常会清晰的像素和颜色指数1将一个像素。
∙参数:
ou8gu8g:
指针结构（C接口）。
ox:
X-position左上角的边缘。
oy:
Y-position左上角的边缘。
ow:
盒子的宽度。
oh:
盒子的高度。
o接待员:
半径为4个边缘。
∙返回:
∙使用:
内循环。
∙注意:
与v1.09可用
∙注意:
∙另见:
setColorIndex,拉伸机drawBox
drawStr
drawStr90
drawStr180
drawStr270
drawStrP
drawStr90P
drawStr180P
drawStr270P
∙c++原型
u8g_uint_tU8GLIB:
:
drawStr（u8g_uint_tx,u8g_uint_ty,constchar*s）
u8g_uint_tU8GLIB:
:
drawStr90（u8g_uint_tx,u8g_uint_ty,constchar*s）
u8g_uint_tU8GLIB:
:
drawStr180（u8g_uint_tx,u8g_uint_ty,constchar*s）
u8g_uint_tU8GLIB:
:
drawStr270（u8g_uint_tx,u8g_uint_ty,constchar*s）
u8g_uint_tU8GLIB:
:
drawStrP（u8g_uint_tx,u8g_uint_ty,constu8g_pgm_uint8_t*s）
u8g_uint_tU8GLIB:
:
drawStr90P（u8g_uint_tx,u8g_uint_ty,constu8g_pgm_uint8_t*s）
u8g_uint_tU8GLIB:
:
drawStr180P（u8g_uint_tx,u8g_uint_ty,constu8g_pgm_uint8_t*s）
u8g_uint_tU8GLIB:
:
drawStr270P（u8g_uint_tx,u8g_uint_ty,constu8g_pgm_uint8_t*s）
∙C原型
u8g_uint_tu8g_DrawStr（u8g_t*u8g,u8g_uint_tx,u8g_uint_ty,constchar*s）;
u8g_uint_tu8g_DrawStr90（u8g_t*u8g,u8g_uint_tx,u8g_uint_ty,constchar*s）;
u8g_uint_tu8g_DrawStr180（u8g_t*u8g,u8g_uint_tx,u8g_uint_ty,constchar*s）;
u8g_uint_tu8g_DrawStr270（u8g_t*u8g,u8g_uint_tx,u8g_uint_ty,constchar*s）;
u8g_uint_tu8g_DrawStrP（u8g_t*u8g,u8g_uint_tx,u8g_uint_ty,constu8g_pgm_uint8_t*s）;
u8g_uint_tu8g_DrawStr90P（u8g_t*u8g,u8g_uint_tx,u8g_uint_ty,constu8g_pgm_uint8_t*s）;
u8g_uint_tu8g_DrawStr180P（u8g_t*u8g,u8g_uint_tx,u8g_uint_ty,constu8g_pgm_uint8_t*s）;
u8g_uint_tu8g_DrawStr270P（u8g_t*u8g,u8g_uint_tx,u8g_uint_ty,constu8g_pgm_uint8_t*s）;
∙描述
画了一个字符串指定x/y的位置。
x/y位置的左下角第一个字符的字符串。
应分配的字体setFont程序在第一次调用这个过程。
这个过程也使用当前颜色指数画的人物。
单色显示,颜色索引0通常会清晰的像素和颜色指数1将一个像素。
（x,y）参数的影响参考点计算模式（setFontPosBaseline）。
“P”变体:
年代假定PROGMEM地区指向一个字符串。
“90”、“180”、“270”变体:
旋转字符串输出到90年,180年或270年学位。
∙参数:
ou8gu8g:
指针结构（C接口）。
ox:
X-position。
oy:
Y-position。
o史:
一个指向一个c字裤（终止\0）。
∙返回:
∙使用:
内循环。
∙注意:
c++Arduino环境还提供了更强大的打印过程。
∙例子:
U8GLIBu8g（...）
...
u8g.setFont（u8g_font_osb18）;
u8g.drawStr（0,20,"ABC"）;
o参考点（0,20）文本字符串的起源通常是一个像素低于低左边缘的第一个字符。
o大写字母的高度位图字体概述所示（在本例中18日看到的在这里）.
o在某些情况下,大写字母的大小也是字体名称的一部分。
∙另见:
setColorIndex,setFontsetFontPosBaseline打印
drawTriangle
∙c++原型
voidU8GLIB:
:
drawTriangle（uint16_tx0,uint16_ty0,uint16_tx1,uint16_ty1,uint16_tx2,uint16_ty2）
∙C原型
voidu8g_DrawTriangle（u8g_t*u8g,uint16_tx0,uint16_ty0,uint16_t
升级会员 