查看: 2309|回复: 0

[uPyCraft IDE] ESP32 常用的模块 framebuf 3.1.13

framebuf模块提供了一个通用的帧缓冲区，可用于创建位图图像，然后将其发送到显示屏。

类

framebuf.FrameBuffer(buffer, width, height, format, stride=width)

类说明：构造一个FrameBuffer对象。

buffer：缓冲区
    必须足够大以包含由FrameBuffer指定的width，height和format
width ：宽度，单位：像素
height：高度，单位：像素
format：FrameBuffer的格式
    framebuf.MONO_VLSB、framebuf.RGB565、framebuf.GS4_HMSB、framebuf.MONO_HLSB、framebuf.MONO_HMSB
stride：水平线的像素数
    默认为width

定义FrameBuffer

示例：

import framebuf

buffer = bytearray(16*8)
fb = framebuf.FrameBuffer(buffer, 128, 64, framebuf.MVLSB)

函数

1. framebuf.FrameBuffer.fill(c)

函数说明：填充指定颜色。

c：数值范围根据颜色格式来确定

示例：

fb.fill(1)

2. framebuf.FrameBuffer.pixel(x, y[, c])

函数说明：画点。

x，y：点坐标（x, y）
c   ：点颜色

3.framebuf.FrameBuffer.hline(x, y, w, c)

函数说明：画水平线。

x，y：水平线起始点坐标（x, y）
w   ：线长
c   ：线的颜色

4. framebuf.FrameBuffer.vline(x, y, h, c)

函数说明：画垂直线。

x，y：垂直线的起始点坐标（x, y）
h   ：垂直线的高度
c   ：线的颜色

5. framebuf.FrameBuffer.line(x1, y1, x2, y2, c)

函数说明：画任意方向的线。

x1，y1：线的始点坐标（x1, y1）
x2，y2：线的终点坐标（x2, y2）
c     ：线的颜色

6. framebuf.FrameBuffer.rect(x, y, w, h, c)

函数说明：画矩形。

x，y：矩形的起始点（x, y）
w   ：宽度
h   ：高度
c   ：矩形边的颜色

7. framebuf.FrameBuffer.fill_rect(x, y, w, h, c)

函数说明：画矩形，并以颜色填充它。

x，y：矩形起始点（x, y）
w   ：宽度
h   ：高度

8. framebuf.FrameBuffer.scroll(xstep, ystep)

函数说明：按照给定的向量（dx, dy）移动屏幕中的内容。

dx：水平方向移动的距离和方向
    dx为正数时向右移动，为负数时向左移动
dy：垂直方向移动的距离和方向
    dy为正数时向下移动，为负数时向下移动

示例：

fb.scroll(10,10)

9. frameBuffer.text(s, x, y[, c =1])

函数说明：写任意文本。

s：要显示的字符串
x，y：字符串的坐标（x, y）
c：字符串颜色

注意：
文本的颜色默认值为1。所有字符的尺寸为8x8像素，目前无法更改字体。

10. framebuf.FrameBuffer.blit(fbuf, x, y[, key ])

函数说明：在当前FrameButter的指定坐标再创建一个FrameButter对象。如果指定了key值，则其对应的颜色是透明的：即不会画出与key指定的颜色相同的像素。若成功，则返回一个FrameBuffer对象。

fbuf：FrameBuffer对象
x，y：起始点坐标（x, y）
key：指定对应颜色为透明

示例：

buffer = bytearray (16*64)
fb1 = framebuf.FrameBuffer(buffer,128,64, framebuf.MVLSB)
fb2 = framebuf.FrameBuffer(buffer,128,64, framebuf.MVLSB)
fb2.blit(fb1,0,0)