framebuf — 帧缓冲操作

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

类 FrameBuffer

FrameBuffer类提供了一个像素缓冲区,可以使用像素,线条,矩形,文本甚至其他FrameBuffer来绘制。在为显示生成输出时很有用。

例子:

import framebuf

# FrameBuffer needs 2 bytes for every RGB565 pixel
buffer=bytearray(10 * 100 * 2)
fbuf = framebuf.FrameBuffer(buffer, 10, 100, framebuf.RGB565)

fbuf.fill(0)
fbuf.text('MicroPython!', 0, 0, 0xffff)

构建函数

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

构造一个FrameBuffer对象。参数是:

  • buffer 是一个具有缓冲协议的对象,该协议必须足够大,以包含由FrameBuffer的宽度,高度和格式定义的每个像素。

  • width 是FrameBuffer的宽度(以像素为单位)

  • height 是FrameBuffer的高度(以像素为单位)

  • format 指定FrameBuffer中使用的像素类型; 允许值列在下面的常量下。这些设置用于编码颜色值的位数以及缓冲区中这些位的布局。在将颜色值c传递给方法的情况下,c是一个小整数,其编码取决于FrameBuffer的格式。

  • stride 是FrameBuffer中每个水平像素线之间的像素数。默认为宽度,但在另一个较大的FrameBuffer或屏幕中实现FrameBuffer时可能需要进行调整。

所述缓冲器的大小必须容纳增加的步长大小。

必须指定有效的 buffer , width, height, format 和可选 stride.。无效的缓冲区大小或尺寸可能会导致意外错误。

绘制原始形状

以下方法在FrameBuffer上绘制形状。

FrameBuffer.fill(c)

使用指定的颜色填充整个FrameBuffer。

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

如果未给出c,则获取指定像素的颜色值。如果给出c,则将指定的像素设置为给定的颜色。

FrameBuffer.hline(x, y, w, c)
FrameBuffer.vline(x, y, h, c)
FrameBuffer.line(x1, y1, x2, y2, c)

使用给定颜色和1个像素的厚度从一组坐标中绘制一条线。该 line 方法将线条绘制到第二组坐标,而 hlinevline 方法分别绘制水平线和垂直线,直到给定长度。

FrameBuffer.rect(x, y, w, h, c)
FrameBuffer.fill_rect(x, y, w, h, c)

在给定的位置,大小和颜色绘制一个矩形。该 rect 方法仅绘制1像素轮廓,而该 fill_rect 方法绘制轮廓和内部。

绘制文字

FrameBuffer.text(s, x, y[, c])

使用坐标作为文本的左上角将文本写入 FrameBuffer 。文本的颜色可以通过可选参数定义,但默认值为1.所有字符的尺寸均为8x8像素,目前无法更改字体。

其他方法

FrameBuffer.scroll(xstep, ystep)

按给定的向量移动 FrameBuffer 的内容。这可能会在 FrameBuffer 中留下以前颜色的足迹。

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

在给定坐标处的当前一个上绘制另一个 FrameBuffer 。如果指定了*key*,那么它应该是一个颜色整数,并且相应的颜色将被视为透明:将不会绘制具有该颜色值的所有像素。

此方法在使用不同格式的 FrameBuffer 实例之间起作用,但由于颜色格式不匹配,所得到的颜色可能是意外的。

常数

framebuf.MONO_VLSB

单色(1bit)颜色格式这定义了一种映射,其中字节中的位垂直映射,位0最接近屏幕顶部。 因此,每个字节占据8个垂直像素。后续字节出现在连续的水平位置,直到到达最右边。 在从最左边开始的位置处渲染另外的字节,低8个像素。

framebuf.MONO_HLSB

单色(1位)颜色格式这定义了一个字节中的位被水平映射的映射。每个字节占据8个水平像素,其中第0位是最左边的。 后续字节出现在连续的水平位置,直到到达最右边。在下一行上渲染更多字节,一个像素更低。

framebuf.MONO_HMSB

单色(1bit)颜色格式这定义了一个字节中的位被水平映射的映射。每个字节占据8个水平像素,其中第0位是最左边的。 后续字节出现在连续的水平位置,直到到达最右边。在下一行上渲染更多字节,一个像素更低。

framebuf.RGB565

红绿蓝(16bit,5 + 6 + 5)颜色格式

framebuf.GS2_HMSB

灰度(2位bit)颜色格式

framebuf.GS4_HMSB

灰度(4位bit)颜色格式

framebuf.GS8

灰度(8bit)颜色格式