`framebuf` --- 影格緩衝區操作¶

framebuf 模組提供一個小型、免配置記憶體的像素緩衝區，並具備基本的繪製操作。它的用途是驅動外接顯示器（OLED、LCD、電子紙等）。

備註

若要對擷取的影格進行影像處理工作，請改用 OpenMV 功能豐富許多的 image.Image 類別——相較於 framebuf，它提供更多的繪製基本元件、色彩轉換與分析功能。

class FrameBuffer¶

A FrameBuffer wraps a user-supplied buffer-protocol object (typically a bytearray) and exposes methods to draw pixels, lines, rectangles, ellipses, polygons, text and other FrameBuffers into it.

範例：：

import framebuf

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

fbuf.fill(0)
fbuf.text("MicroPython!", 0, 0, 0xffff)
fbuf.hline(0, 9, 96, 0xffff)

建構函式¶

class framebuf.FrameBuffer(buffer: Any, width: int, height: int, format: int, stride: int | None = None, /)¶

建構一個 FrameBuffer 物件。

buffer -- 任何支援緩衝區協定的物件；必須足夠大，能以所選的 format 容納 stride * height 個像素。
width -- 影格緩衝區的寬度（以像素為單位）。
height -- 影格緩衝區的高度（以像素為單位）。
format -- 像素格式；為下方常數所列常數之一。此格式同時決定 buffer 中每個像素的大小，以及傳遞給任何繪製方法的色彩整數 c 如何被解讀。
stride -- 每個水平列的像素數量，包含任何填補。預設為 width。設定此值可使用較大緩衝區的子區域。

傳入過小的 buffer 或無效的尺寸會產生未定義的結果——建構函式並不會驗證每一種組合。

繪製方法¶

FrameBuffer.fill(c: int) → None¶: 以色彩 c 填滿整個影格緩衝區。

FrameBuffer.fill_rect(x: int, y: int, w: int, h: int, c: int) → None¶: 在 (x, y) 處以色彩 c 填滿一個 w x h 的矩形。等同於 f=True 的 rect()。

FrameBuffer.pixel(x: int, y: int, c: int | None = None) → int | None¶: 不帶 c 引數時，回傳 (x, y) 處像素的色彩值。給定 c 時，將該像素設定為色彩 c。

FrameBuffer.hline(x: int, y: int, w: int, c: int) → None¶
FrameBuffer.vline(x: int, y: int, h: int, c: int) → None¶
FrameBuffer.line(x1: int, y1: int, x2: int, y2: int, c: int) → None¶: 以色彩 c 繪製 1 像素粗的線條。hline() 與 vline() 繪製指定長度的水平／垂直線；line() 則在兩個任意點之間繪製線條。

FrameBuffer.rect(x: int, y: int, w: int, h: int, c: int, f: bool = False) → None¶: 在 (x, y) 處繪製一個大小為 w x h、色彩為 c 的矩形。若 f 為 True 則填滿矩形；否則僅繪製 1 像素的外框。

FrameBuffer.ellipse(x: int, y: int, xr: int, yr: int, c: int, f: bool = False, m: int = 0) → None¶

繪製一個以 (x, y) 為中心、x 半徑為 xr、y 半徑為 yr、色彩為 c 的橢圓。半徑相等時會產生圓形。f=True 會填滿圖形，而非僅繪製外框。

m 是一個位元遮罩，將繪製限制在特定象限（從右上方起逆時針編號）：

位元	象限	區域
bit 0	Q1	右上
bit 1	Q2	左上
bit 2	Q3	左下
bit 3	Q4	右下

預設的 m=0 會繪製全部四個象限。

FrameBuffer.poly(x: int, y: int, coords: Any, c: int, f: bool = False) → None¶: 在位移 (x, y) 處以色彩 c 繪製任意封閉多邊形（凸形或凹形）。coords 必須是排列為 array('h', [x0, y0, x1, y1, ..., xn, yn]) 的有號 16 位元整數 array。f=True 會填滿多邊形，而非僅繪製外框。

FrameBuffer.text(s: str, x: int, y: int, c: int = 1) → None¶: 以色彩 c 繪製字串 s，其左上角位於 (x, y)。內建字型固定為 8x8 像素且無法變更。c 預設為 1。

FrameBuffer.scroll(xstep: int, ystep: int) → None¶: 將緩衝區內容位移 (xstep, ystep)。從緩衝區外移入的像素不會被清除，因此先前內容的「殘影」可能殘留在尾端邊緣。

FrameBuffer.blit(fbuf: FrameBuffer | Tuple, x: int, y: int, key: int = -1, palette: FrameBuffer | None = None) → None¶

將另一個影格緩衝區 fbuf 繪製到此緩衝區之上，其左上角位於 (x, y)。

若給定 key，任何符合該色彩值的來源像素會被視為透明而不繪製。當提供 palette 時，比較是針對調色盤輸出進行，而非原始的 fbuf 值。

fbuf 可以是 FrameBuffer 實例，或符合建構函式簽章的 tuple／list：：

(buffer, width, height, format)
(buffer, width, height, format, stride)

當來源為 tuple／list 時，buffer 可以是唯讀的。

palette 允許在不同格式的緩衝區之間進行 blit——例如將單色字符繪製到 RGB565 緩衝區中。它是一個格式與目的端相符、高度為 1、寬度等於來源色彩數量（N 位元每像素的來源為 2**N）的 FrameBuffer。來源像素值 i 在繪製前會被替換為 palette[i, 0] 處的色彩。

常數¶

建構函式接受以下 format 值。「每像素位元組數」欄是調整後備緩衝區大小時所需的乘數。

常數	每像素位元組數	像素配置
`MONO_VLSB`	0.125	單色（1 位元）。每個位元組保存 8 個垂直堆疊的像素，bit 0 最接近頂端。每列 8 個像素由左至右橫越緩衝區推進，接著換到下一個 8 像素列。
`MONO_HLSB`	0.125	單色（1 位元）。每個位元組保存 8 個水平像素，bit 7 為最左。每列一次垂直推進一個像素。
`MONO_HMSB`	0.125	單色（1 位元）。與 `MONO_HLSB` 相同，但 bit 0 為最左。
`GS2_HMSB`	0.25	2 位元灰階（4 個層級），以最高有效位元優先水平打包。
`GS4_HMSB`	0.5	4 位元灰階（16 個層級），以最高有效半位元組優先水平打包。
`GS8`	1	8 位元灰階（256 個層級）。
`RGB565`	2	16 位元 RGB，含 5 個紅色、6 個綠色與 5 個藍色位元。

framebuf.MVLSB 是 framebuf.MONO_VLSB 已棄用的別名；新程式碼中請優先使用後者。

舊版建構函式¶

framebuf.FrameBuffer1(buffer: Any, width: int, height: int, stride: int | None = None, /) → FrameBuffer¶: FrameBuffer(buffer, width, height, framebuf.MONO_VLSB, stride) 已棄用的捷徑。為向後相容而保留；請改用完整的 FrameBuffer 建構函式。

framebuf --- 影格緩衝區操作¶

class FrameBuffer¶

建構函式¶

繪製方法¶

常數¶

舊版建構函式¶

`framebuf` --- 影格緩衝區操作¶