`_eve` – 低级 BridgeTek EVE 绑定¶

该 _eve 模块提供了一个类 _EVE，其中包含构造 EVE 命令缓冲区和附加基本图形命令的方法。

class _eve._EVE¶

register(self, o: object) → None ¶

flush(self) → None ¶

将任何排队的绘图命令直接发送到硬件。

Parameters: width (int) – 网格的宽度（以平铺为单位），或 1 表示精灵。

cc(self, b: _typing.ReadableBuffer) → None ¶

将字节附加到命令 FIFO。

Parameters: b (ReadableBuffer) –要添加的字节

AlphaFunc(self, func: int, ref: int) → None ¶

设置alpha测试功能

Parameters

func (int) – 指定测试函数，NEVER, LESS, LEQUAL, GREATER, GEQUAL, EQUAL, NOTEQUAL, 或 ALWAYS之一。范围 0-7。初始值为 ALWAYS(7)
ref (int) – 指定 alpha 测试的参考值。范围 0-255。初始值为 0

这些值是图形上下文的一部分，由 SaveContext()和保存和恢复RestoreContext()。

Begin(self, prim: int) → None ¶

开始绘制图形基元

参数: prim (int) – 图形基元。

有效的原语BITMAPS, POINTS, LINES, LINE_STRIP, EDGE_STRIP_R, EDGE_STRIP_L, EDGE_STRIP_A, EDGE_STRIP_B 和 RECTS。

BitmapExtFormat(self, format: int) → None ¶

设置位图格式

参数: 格式 (int) – 位图像素格式。

BitmapHandle(self, handle: int) → None ¶

设置位图句柄

参数: 句柄 (int) –位图句柄。范围 0-31。初始值为 0

该值是图形上下文的一部分，由SaveContext() 和保存和恢复RestoreContext()。

BitmapLayoutH(self, linestride: int, height: int) → None ¶

设置当前句柄的源位图内存格式和布局。大位图的高位

参数

linestride (int) – 位图行跨度的高部分，以字节为单位。范围 0-7
height (int) – 位图高度的高部分，以行为单位。范围 0-3

BitmapLayout(self, format: int, linestride: int, height: int) → None ¶

设置当前句柄的源位图内存格式和布局

参数

format (int) – 位图像素格式，或 GLFORMAT 以使用 BITMAP_EXT_FORMAT。范围 0-31
linestride (int) – 位图行跨度，以字节为单位。范围 0-1023
height (int) – 位图高度，以行为单位。范围 0-511

BitmapSizeH(self, width: int, height: int) → None ¶

为当前句柄设置位图的屏幕绘制。大位图的高位

参数

width (int) – 绘制位图宽度的高部分，以像素为单位。范围 0-3
height (int) – 绘制位图高度的高部分，以像素为单位。范围 0-3

BitmapSize(self, filter: int, wrapx: int, wrapy: int, width: int, height: int) → None ¶

为当前句柄设置位图的屏幕绘制

参数

filter (int) – 位图过滤模式，NEAREST 或 BILINEAR之一。范围 0-1
wrapx (int) – 位图\(x\)换行模式，REPEAT或 BORDER之一.。范围 0-1
wrapy (int) – 位图\(y\)换行模式，REPEAT或BORDER之一。范围 0-1
width (int) – 绘制的位图宽度，以像素为单位。范围 0-511
height (int) – 绘制的位图高度，以像素为单位。范围 0-511

BitmapSource(self, addr: int) → None ¶

设置位图图形的源地址

参数: addr (int) – 位图起始地址，像素对齐。可能在 SRAM 或闪存中。范围 0-16777215

BitmapSwizzle(self, r: int, g: int, b: int, a: int) → None ¶

设置位图的 r,g,b 和 a 通道的源

参数

r (int) – 红色分量源通道。范围 0-7
g (int) – 绿色分量源通道。范围 0-7
b (int) – 蓝色分量源通道。范围 0-7
a (int) –alpha 分量源通道。范围 0-7

BitmapTransformA(self, p: int, v: int) → None ¶

设置 \(a\) 位图变换矩阵的组成部分

参数

p (int) – 精度控制：0 是 8.8，1 是 1.15。范围 0-1。初始值为 0
v (int) – \(a\)位图变换矩阵的组成部分，有符号的 8.8 或 1.15 位定点形式。范围 0-131071。初始值为 256

初始值为p = 0，v = 256。这表示值 1.0。

这些值是图形上下文的一部分，由SaveContext() 和保存和恢复RestoreContext()。

BitmapTransformB(self, p: int, v: int) → None ¶

设置 \(b\) 位图变换矩阵的组成部分

参数

p (int) – 精度控制：0 是 8.8，1 是 1.15。范围 0-1。初始值为 0
v (int) – T\(b\)位图变换矩阵的组成部分，有符号的 8.8 或 1.15 位定点形式。范围 0-131071。初始值为 0

初始值为p = 0，v = 0。这表示值 0.0。

这些值是图形上下文的一部分，由SaveContext() 和保存和恢复RestoreContext()。

BitmapTransformC(self, v: int) → None ¶

设置 \(c\) 位图变换矩阵的组成部分

参数: v (int) – \(c\)位图变换矩阵的组成部分，以带符号的 15.8 位定点形式表示。范围 0-16777215。初始值为 0

该值是图形上下文的一部分，由SaveContext() 和保存和恢复RestoreContext()。

BitmapTransformD(self, p: int, v: int) → None ¶

设置 \(d\) 位图变换矩阵的组成部分

参数

p (int) – 精度控制：0 是 8.8，1 是 1.15。范围 0-1。初始值为 0
v (int) – \(d\)位图变换矩阵的组成部分，有符号的 8.8 或 1.15 位定点形式。范围 0-131071。初始值为 0

初始值为p = 0，v = 0。这表示值 0.0。

这些值是图形上下文的一部分，由SaveContext() 和保存和恢复 RestoreContext()。

BitmapTransformE(self, p: int, v: int) → None ¶

设置 \(e\) 位图变换矩阵的组成部分

参数

p (int) –精度控制：0 是 8.8，1 是 1.15。范围 0-1。初始值为 0
v (int) – \(e\)位图变换矩阵的组成部分，有符号的 8.8 或 1.15 位定点形式。范围 0-131071。初始值为 256

初始值为p = 0，v = 256。这表示值 1.0。

这些值是图形上下文的一部分，由 SaveContext() 和保存和恢复 RestoreContext()。

BitmapTransformF(self, v: int) → None ¶

设置 \(f\) 位图变换矩阵的组成部分

参数: v (int) – \(f\)位图变换矩阵的组成部分，以带符号的 15.8 位定点形式表示。范围 0-16777215。初始值为 0

该值是图形上下文的一部分，由 SaveContext() 和保存和恢复 RestoreContext().

BlendFunc(self, src: int, dst: int) → None ¶

设置像素算法

参数

src (int) – 指定源混合因子的计算方式。一ZERO, ONE, SRC_ALPHA, DST_ALPHA, ONE_MINUS_SRC_ALPHA 或 ONE_MINUS_DST_ALPHA。范围 0-7。初始值为 SRC_ALPHA(2)
dst (int) – 指定目标混合因子的计算方式，与src相同的常量之一。范围 0-7。初始值为 ONE_MINUS_SRC_ALPHA(4)

这些值是图形上下文的一部分，由SaveContext() 和保存和恢复RestoreContext()。

Call(self, dest: int) → None ¶

在显示列表的另一个位置执行一系列命令

参数: dest (int) – 显示列表地址。范围 0-65535

Cell(self, cell: int) → None ¶

为 vertex2f 命令设置位图单元格编号

参数: cell (int) – 位图单元格编号。范围 0-127。初始值为 0

该值是图形上下文的一部分，由SaveContext() 和保存和恢复 RestoreContext()。

ClearColorA(self, alpha: int) → None ¶

为 Alpha 通道设置清除值

参数: alpha (int) – 清除颜色缓冲区时使用的 alpha 值。范围 0-255。初始值为 0

该值是图形上下文的一部分，由SaveContext() 和保存和恢复 RestoreContext()。

ClearColorRGB(self, red: int, green: int, blue: int) → None ¶

为红色、绿色和蓝色通道设置清晰的值

参数

red (int) – 清除颜色缓冲区时使用的红色值。范围 0-255。初始值为 0
green (int) – 清除颜色缓冲区时使用的绿色值。范围 0-255。初始值为 0
blue (int) – 清除颜色缓冲区时使用的蓝色值。范围 0-255。初始值为 0

这些值是图形上下文的一部分，由SaveContext() 和保存和恢复 RestoreContext()。

Clear(self, c: int, s: int, t: int) → None ¶

清除缓冲区到预设值

参数

c (int) – 清除颜色缓冲区。范围 0-1
s (int) – 清除模板缓冲区。范围 0-1
t (int) – 清除标签缓冲区。范围 0-1

ClearStencil(self, s: int) → None ¶

为模板缓冲区设置清除值

参数: s (int) – 清除模板缓冲区时使用的值。范围 0-255。初始值为 0

该值是图形上下文的一部分，由 SaveContext() 和保存和恢复 RestoreContext()。

ClearTag(self, s: int) → None ¶

为标签缓冲区设置清除值

参数: s (int) – 清除标记缓冲区时使用的值。范围 0-255。初始值为 0

该值是图形上下文的一部分，由SaveContext() 和保存和恢复 RestoreContext()。

ColorA(self, alpha: int) → None ¶

设置当前颜色 alpha

参数: alpha (int) – 当前颜色的 alpha。范围 0-255。初始值为 255

该值是图形上下文的一部分，由 SaveContext() 和保存和恢复 RestoreContext()。

ColorMask(self, r: int, g: int, b: int, a: int) → None ¶

启用和禁用帧缓冲区颜色分量的写入

参数

r (int) – 允许更新帧缓冲区红色组件。范围 0-1。初始值为 1
g (int) – 允许更新帧缓冲区绿色组件。范围 0-1。初始值为 1
b (int) – 允许更新帧缓冲区蓝色组件。范围 0-1。初始值为 1
a (int) – 允许更新帧缓冲区 alpha 组件。范围 0-1。初始值为 1

这些值是图形上下文的一部分，由SaveContext()和保存和恢复RestoreContext()。

ColorRGB(self, red: int, green: int, blue: int) → None ¶

设置绘图颜色

参数

red (int) – 当前颜色的红色值。范围 0-255。初始值为 255
green (int) – 当前颜色为绿色。范围 0-255。初始值为 255
blue (int) – 当前颜色的蓝色。范围 0-255。初始值为 255

这些值是图形上下文的一部分，由SaveContext()和保存和恢复RestoreContext()。

Display(self) → None ¶: 结束显示列表

End(self) → None ¶

结束绘制图形基元

Vertex2ii()和 Vertex2f()调用将被忽略，直到下一个Begin().

Jump(self, dest: int) → None ¶

在显示列表中的另一个位置执行命令

参数: dest (int) – 显示列表地址。范围 0-65535

Macro(self, m: int) → None ¶

从宏寄存器执行单个命令

参数: m (int) – 要读取的宏寄存器。范围 0-1

Nop(self) → None ¶: 无操作

PaletteSource(self, addr: int) → None ¶

设置调色板的基地址

参数: addr (int) – 图形 SRAM 中的地址，2 字节对齐。范围 0-4194303。初始值为 0

该值是图形上下文的一部分，由 SaveContext() 和保存和恢复 RestoreContext()。

RestoreContext(self) → None ¶: 从上下文堆栈中恢复当前图形上下文

Return(self) → None ¶: 从上一个调用命令返回

SaveContext(self) → None ¶: 将当前图形上下文推送到上下文堆栈上

ScissorSize(self, width: int, height: int) → None ¶

设置剪刀夹矩形的大小

参数

width (int) – 剪刀剪辑矩形的宽度，以像素为单位。范围 0-4095。初始值为 hsize
height (int) – 剪刀剪辑矩形的高度，以像素为单位。范围 0-4095。初始值为 2048

这些值是图形上下文的一部分，由 SaveContext() 和保存和恢复RestoreContext()。

ScissorXY(self, x: int, y: int) → None ¶

设置剪刀夹矩形的左上角

参数

x (int) – \(x\)剪刀剪辑矩形的坐标，以像素为单位。范围 0-2047。初始值为 0
y (int) – \(y\)剪刀剪辑矩形的坐标，以像素为单位。范围 0-2047。初始值为 0

这些值是图形上下文的一部分，由SaveContext() 和保存和恢复RestoreContext()。

StencilFunc(self, func: int, ref: int, mask: int) → None ¶

设置模板测试的功能和参考值

参数

func (int) – 指定测试函数，NEVER, LESS, LEQUAL, GREATER, GEQUAL, EQUAL, NOTEQUAL, 或 ALWAYS之一。范围 0-7。初始值为 ALWAYS(7)
ref (int) – 指定模板测试的参考值。范围 0-255。初始值为 0
mask (int) –指定一个与参考值和存储的模板值进行 AND 运算的掩码。范围 0-255。初始值为 255

这些值是图形上下文的一部分，由SaveContext() 和保存和恢复RestoreContext()。

StencilMask(self, mask: int) → None ¶

控制模板平面中单个位的写入

参数: mask (int) – 用于启用写入模板位的掩码。范围 0-255。初始值为 255

该值是图形上下文的一部分，由 SaveContext() 和保存和恢复RestoreContext()。

StencilOp(self, sfail: int, spass: int) → None ¶

设置模板测试操作

参数

sfail (int) – 指定的动作时，模板测试未能采取的一个 KEEP, ZERO, REPLACE, INCR, INCR_WRAP, DECR, DECR_WRAP, 和 INVERT。范围 0-7。初始值为 KEEP(1)
spass (int) – 指定当模板测试通过时要采取的操作，与sfail相同的常量之一。范围 0-7。初始值为 KEEP(1)

这些值是图形上下文的一部分，由SaveContext() 和保存和恢复 RestoreContext()。

TagMask(self, mask: int) → None ¶

控制标签缓冲区的写入

参数: mask (int) – 允许更新标签缓冲区。范围 0-1。初始值为 1

该值是图形上下文的一部分，由SaveContext() 和保存和恢复RestoreContext()。

Tag(self, s: int) → None ¶

设置当前标签值

参数: s (int) – 标签值。范围 0-255。初始值为 255

该值是图形上下文的一部分，由 SaveContext() 和保存和恢复 RestoreContext()。

Vertex2ii(self, x: int, y: int, handle: int, cell: int) → None ¶

参数

x (int) – x 坐标（以像素为单位）。范围 0-511
y (int) – y 坐标（以像素为单位）。范围 0-511
handle (int) – 位图句柄。范围 0-31
cell (int) – 单元格编号。范围 0-127

此方法是的替代方法Vertex2f().

Vertex2f(self, b: float) → None ¶

画一个点。

参数

x (float) – 像素 x 坐标
y (float) – 像素 y 坐标

LineWidth(self, width: float) → None ¶

设置光栅化线的宽度

参数: width (float) –以像素为单位的线宽。范围 0-511。初始值为 1

该值是图形上下文的一部分，由 SaveContext() 和保存和恢复RestoreContext().

PointSize(self, size: float) → None ¶

设置光栅化点的直径

参数: size (float) – 点直径（以像素为单位）。范围 0-1023。初始值为 1

该值是图形上下文的一部分，由SaveContext() 和保存和恢复 RestoreContext()。

VertexTranslateX(self, x: float) → None ¶

设置顶点变换的 x 平移分量

参数: x (float) – 带符号的 x 坐标（以像素为单位）。范围±4095。初始值为 0

该值是图形上下文的一部分，由SaveContext()和保存和恢复RestoreContext().

VertexTranslateY(self, y: float) → None ¶

设置顶点变换的 y 平移分量

参数: y (float) – 以像素为单位的有符号 y 坐标。范围±4095。初始值为 0

该值是图形上下文的一部分，由SaveContext() 和保存和恢复RestoreContext()。

VertexFormat(self, frac: int) → None ¶

设置vertex2f坐标的精度

参数: frac (int) – X,Y 坐标中的小数位数，0-4。范围 0-7。初始值为 4

该值是图形上下文的一部分，由 SaveContext() 和保存和恢复 RestoreContext()。

cmd0(self, n: int) → None ¶

将命令字 n 附加到 FIFO

参数: n (int) – 命令代码

eve模块使用此方法有效地将命令添加到 FIFO。

cmd(self, n: int, fmt: str, args: Tuple[str, Ellipsis]) → None ¶

将命令包附加到 FIFO。

参数

n (int) – 命令代码
fmt (str) – 命令格式 struct 布局
args (tuple(str, ..)) – 命令的参数

支持的格式代码：h、H、i、I。

eve 模块使用此方法有效地将命令添加到 FIFO。

_eve – 低级 BridgeTek EVE 绑定¶

`_eve` – 低级 BridgeTek EVE 绑定¶